This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 0bdb4cf482c docs(ja): translate Dev quick start (T09-DEV-001a) (#4213)
0bdb4cf482c is described below
commit 0bdb4cf482cc2152e4f4d01e681052791579801f
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Tue Oct 13 12:33:35 2026 +0800
docs(ja): translate Dev quick start (T09-DEV-001a) (#4213)
## Scope
Start T09-DEV-001 with its first reviewable sub-batch: the Dev
quick-start guide (1 of 20 assigned pages). The remaining 19 pages stay
in T09-DEV-001. This split keeps the initial long MDX translation
focused for Japanese proofreading.
The Dev and 4.x English documents have the same native doc ID, relative
path, and normalized source SHA-256
(`c1f1c82c39f02f2368e4f214b72a7be258983de46fcb04615078a1dd8d35a60b`) at
master `de6b50dd09`. This PR changes only Dev. The separate 4.x batch
can reuse the reviewed text and must carry its own state record and
checks.
## Changes
- Translate the prose and metadata of `getting-started/quick-start.mdx`
into Japanese.
- Record the exact English source and Japanese target hashes with
`reviewStatus: machine`. Human Japanese proofreading is still pending.
- Mark the first page as a draft candidate in the batch ledger; the
other 19 pages remain TODO and merged coverage stays unchanged.
- Preserve SQL, shell commands, links, numbers, MDX structure, and
source heading anchors.
## Verification
- Translation gate: 1 changed page checked, 0 errors.
- Dev scope en/zh-CN/ja build: success with `DORIS_ENABLE_JA=true
DOCS_VERSIONS=current`.
- Japanese static verification: 1,778 non-draft pages checked, 0 errors.
- New Dev page renders Japanese body and Japanese canonical. Adjacent
untranslated Dev page retains English body, English canonical, and
`noindex, follow`.
- `build-scope.cjs` selects current/ja; no full-version build required.
## Review needed before merge
Please have a Japanese reviewer proofread the prose and confirm
technical meaning against the Dev English source. The state record
remains machine-reviewed until that review is complete. This PR should
remain a draft until then.
---------
Co-authored-by: morningman <[email protected]>
---
.../current/getting-started/quick-start.mdx | 269 +++++++++++++++++++++
translations/inventory/ja/2026-10-12/batches.md | 2 +-
translations/state/ja/docs.json | 17 ++
3 files changed, 287 insertions(+), 1 deletion(-)
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/quick-start.mdx
b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/quick-start.mdx
new file mode 100644
index 00000000000..1b2a0d2010f
--- /dev/null
+++
b/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/quick-start.mdx
@@ -0,0 +1,269 @@
+---
+{
+ "title": "5 分で始める Apache Doris",
+ "language": "ja",
+ "sidebar_label": "Apache Doris クイックスタート",
+ "description": "Docker またはバイナリで Apache Doris をローカル環境にデプロイし、クラスターを起動して最初の
SQL クエリを実行する手順。"
+}
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+**このチュートリアルでは、次の操作を行います。**
+
+- Docker を使って 5 分以内に Doris クラスターを起動する
+- MySQL クライアントでクラスターに接続し、ノードの状態を確認する
+- データベースとテーブルを作成し、最初のクエリを実行する
+
+:::tip デプロイ方法の選択
+
+- **すぐに試したい場合：** Docker を使えば 5 分で起動できます。
+- **本番環境の構成を理解したい場合：** FE と BE を個別に設定するローカル環境へのフルデプロイを参照してください。
+
+:::
+
+## Docker でクイックデプロイ
+
+最新バージョンでは、Docker を使って簡単にデプロイできます。
+
+### 手順 1 (1/2)：クラスターの起動
+
+次のコマンドは起動スクリプトをダウンロードして、そのままクラスターを起動します。バージョンを指定しない場合、デフォルトで最新リリース（`doris-latest`）をダウンロードします。
+
+```shell
+curl -fsSL https://doris.apache.org/files/start-doris.sh | bash
+```
+
+バージョンを指定するには、`-v` オプションを使用します。
+
+```shell
+curl -fsSL https://doris.apache.org/files/start-doris.sh | bash -s -- -v 4.1.0
+```
+
+### 手順 2 (2/2)：クラスターの状態確認
+
+MySQL クライアントでクラスターに接続し、FE と BE の状態を確認します。
+
+```sql
+-- Purpose: verify that the FE node has joined the cluster
+-- Expected: both Join and Alive columns are true
+mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `join`, `alive` FROM
frontends()'
+```
+
+```sql
+-- Purpose: verify that the BE node is heartbeating normally
+-- Expected: the Alive column is 1
+mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()'
+```
+
+**出力の見方：** FE の `Alive=true`、または BE の `Alive=1` は、そのノードが正常に稼働していることを示します。
+
+---
+
+## ローカル環境へのフルデプロイ
+
+:::info 環境要件
+
+- **オペレーティングシステム：** Ubuntu などの一般的な AMD/ARM Linux 環境
+- **Java 環境：** JDK 17 以降
+- **ユーザー権限：** 専用の Doris ユーザーを作成し、root は使用しない
+
+:::
+
+### 手順 1 (1/4)：バイナリパッケージのダウンロード
+
+Apache Doris
の[ダウンロードページ](https://doris.apache.org/download)からシステムに合ったバイナリパッケージを取得し、任意のディレクトリに展開します。
+
+### 手順 2 (2/4)：システム環境の設定
+
+**開けるファイル数の上限を増やす：** ファイルを開きすぎた場合のエラーを防ぎます。
+
+```bash
+vi /etc/security/limits.conf
+* soft nofile 1000000
+* hard nofile 1000000
+```
+
+**仮想メモリー領域数の上限を増やす：**
+
+```bash
+cat >> /etc/sysctl.conf << EOF
+vm.max_map_count = 2000000
+EOF
+sysctl -p
+```
+
+### 手順 3 (3/4)：FE のデプロイ
+
+1. **FE を設定する：** `apache-doris/fe/conf/fe.conf` を編集します。
+
+ ```properties
+ # Specify the Java environment
+ JAVA_HOME=/home/doris/jdk
+
+ # Specify the FE listening IP (adjust based on the actual network segment)
+ priority_networks=127.0.0.1/32
+ ```
+
+2. **FE を起動する：**
+
+ ```bash
+ apache-doris/fe/bin/start_fe.sh --daemon
+ ```
+
+3. **FE の状態を確認する：**
+
+ ```sql
+ -- Purpose: confirm that the FE has started and joined the cluster
+ -- Expected: Join=true, Alive=true, IsMaster=true
+ mysql -uroot -P9030 -h127.0.0.1 -e "show frontends;"
+ ```
+
+### 手順 4 (4/4)：BE のデプロイ
+
+1. **BE を設定する：** `apache-doris/be/conf/be.conf` を編集します。
+
+ ```properties
+ # Specify the BE listening IP (must be in the same network segment as the
FE's priority_networks)
+ priority_networks=127.0.0.1/32
+ ```
+
+2. **BE を起動する：**
+
+ ```bash
+ apache-doris/be/bin/start_be.sh --daemon
+ ```
+
+3. **BE をクラスターに登録する：**
+
+ ```sql
+ -- Purpose: add the BE node to the cluster
+ ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";
+ ```
+
+4. **BE の状態を確認する：**
+
+ ```sql
+ -- Purpose: confirm that the BE is registered and heartbeating normally
+ -- Expected: Alive=true
+ mysql -uroot -P9030 -h127.0.0.1 -e "show backends;"
+ ```
+
+---
+
+## 最初のクエリを実行する
+
+Docker とローカル環境のどちらでデプロイした場合も、クラスターの起動後に以下の手順で Doris の SQL 機能を試せます。
+
+### クラスターに接続する
+
+```sql
+mysql -uroot -P9030 -h127.0.0.1
+```
+
+### データベースとテーブルを作成する
+
+```sql
+-- Purpose: create a demo database and table
+create database demo;
+use demo;
+
+create table mytable
+(
+ k1 TINYINT,
+ k2 DECIMAL(10, 2) DEFAULT "10.05",
+ k3 CHAR(10) COMMENT "string column",
+ k4 INT NOT NULL DEFAULT "1" COMMENT "int column"
+)
+COMMENT "my first table"
+DISTRIBUTED BY HASH(k1) BUCKETS 1
+PROPERTIES ("replication_num" = "1");
+```
+
+### テストデータを投入する
+
+```sql
+-- Purpose: insert a few rows of test data
+insert into mytable values
+(1, 0.14, 'a1', 20),
+(2, 1.04, 'b2', 21),
+(3, 3.14, 'c3', 22),
+(4, 4.35, 'd4', 23);
+```
+
+### クエリを実行する
+
+```sql
+-- Purpose: verify that the data was loaded successfully
+-- Expected: 4 rows are returned
+select * from demo.mytable;
+```
+
+**出力例：**
+
+```
++------+------+------+------+
+| k1 | k2 | k3 | k4 |
++------+------+------+------+
+| 1 | 0.14 | a1 | 20 |
+| 2 | 1.04 | b2 | 21 |
+| 3 | 3.14 | c3 | 22 |
+| 4 | 4.35 | d4 | 23 |
++------+------+------+------+
+```
+
+---
+
+## よくある質問
+
+### Q：Docker によるデプロイは本番環境に適していますか？
+
+いいえ。Docker
によるデプロイはローカル開発とテスト専用です。コンテナーを破棄するとデータが失われます。本番環境では、ローカル環境へのフルデプロイか、複数ノードへのデプロイを使用してください。
+
+### Q：Mac に Docker をインストールするには？
+
+[Docker Desktop](https://www.docker.com/products/docker-desktop/)
をダウンロードしてインストールします。
+
+### Q：Mac に Docker Desktop をインストールした後、「Docker environment not detected」と表示されたら？
+
+シンボリックリンクを作成します。
+
+```shell
+sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker
/usr/local/bin/docker
+```
+
+### Q：Mac の Docker で「error getting credentials」と表示されたら？
+
+一時的な回避策として、`credsStore` フィールドを `~/.docker/config.json`
から削除します。この場合、認証情報が平文で保存されるため、ローカル開発に限って使用してください。
+
+### Q：BE ノードを追加しても「Dead」と表示される場合は？
+
+BE の `priority_networks` が FE と同じネットワークセグメントを指しているか確認します。また、BE
のポート（9050/9060/8040/8060）がファイアウォールでブロックされていないか確認します。
+
+### Q：WSL2 でローカル環境にデプロイすると、BE がクラスターに参加しないのはなぜですか？
+
+WSL2 のループバックはディストリビューションごとに分離されています。そのため、FE と BE は `127.0.0.1`
を通じて通信できません。デフォルトの `priority_networks=127.0.0.1/32` では、WSL2 上で BE
の登録やハートビートが失敗します。
+
+対処するには、`ip addr show eth0` で実際の WSL ネットワークセグメント（通常は `172.16.0.0/12` または
`172.x.x.x/20`）を調べます。次に、`priority_networks` にそのセグメントを設定します。設定箇所は
`fe/conf/fe.conf` と `be/conf/be.conf` の両方です。FE と BE を再起動してから `ALTER SYSTEM ADD
BACKEND` を再実行します。
+
+### Q：クラスター全体が正常に稼働しているか確認するには？
+
+`SHOW FRONTENDS;` と `SHOW BACKENDS;` を実行し、すべてのノードで `Alive` 列が `true`
であることを確認します。
+
+---
+
+## 次のステップ
+
+- [データモデリングガイド]：Doris のデータモデルとパーティショニング戦略を学びます（NEXT-TODO）
+- [SQL 操作入門]：データのロード、クエリ、更新を学びます（NEXT-TODO）
+- [クラスター管理]：本番環境向けのクラスター運用を学びます（NEXT-TODO）
+
+:::caution 警告（ローカル環境へのデプロイにのみ適用）
+
+以下の内容は**ローカル開発とテスト専用**です。**本番環境では使用しないでください**。
+
+1. **データ損失のリスク：** Docker
でデプロイした場合、コンテナーを破棄するとデータが失われます。単一レプリカの構成ではデータの冗長性がありません。
+2. **単一レプリカの設定：**
このページのテーブル作成例は、いずれも単一レプリカを使用します。本番環境では、データの信頼性を確保するために複数のレプリカを使用してください。
+
+:::
diff --git a/translations/inventory/ja/2026-10-12/batches.md
b/translations/inventory/ja/2026-10-12/batches.md
index 003c35f3f11..cbdd7568c6b 100644
--- a/translations/inventory/ja/2026-10-12/batches.md
+++ b/translations/inventory/ja/2026-10-12/batches.md
@@ -21,7 +21,7 @@ These initial IDs remain the audit baseline. Record PRs and
proofreading in this
## T09-DEV-001
-Status: TODO. PR: none. Japanese proofreading: pending.
+Status: IN_PROGRESS. Sub-batch `T09-DEV-001a`: [draft PR
#4213](https://github.com/apache/doris-website/pull/4213) covers
`getting-started/quick-start` only (1 candidate, 0 merged). Japanese
proofreading: pending; its state is machine-reviewed. The other 19 assigned
pages remain TODO. This split keeps the first 269-line MDX guide independently
reviewable; it does not close or renumber T09-DEV-001.
Dependencies: T03 and T04. Pages: 20. Remaining in DEV after this batch: 1617.
diff --git a/translations/state/ja/docs.json b/translations/state/ja/docs.json
index ef8f44e2c62..6a8a003aa84 100644
--- a/translations/state/ja/docs.json
+++ b/translations/state/ja/docs.json
@@ -35,6 +35,23 @@
"translatedAt": "2026-10-11T19:57:10.000Z",
"glossaryVersion": "0"
},
+ {
+ "pluginId": "default",
+ "version": "current",
+ "docId": "getting-started/quick-start",
+ "locale": "ja",
+ "sourceLocale": "en",
+ "sourcePath": "docs/getting-started/quick-start.mdx",
+ "targetPath":
"i18n/ja/docusaurus-plugin-content-docs/current/getting-started/quick-start.mdx",
+ "sourceCommit": "de6b50dd09daf92d67eed09672834a71efad9daa",
+ "sourceHash":
"c1f1c82c39f02f2368e4f214b72a7be258983de46fcb04615078a1dd8d35a60b",
+ "sourceTechnicalHash":
"9c1b0c02f50f363922e3fa34e6e59b15977943a1ada12454ef9ea76ad9bf6367",
+ "targetHash":
"1340a796070ffbe49ec953f4123ae48a83fb4ec8deb41b32ea1ee43a429861ae",
+ "reviewStatus": "machine",
+ "ownership": "machine",
+ "translatedAt": "2026-10-13T01:24:34.000Z",
+ "glossaryVersion": "0"
+ },
{
"pluginId": "default",
"version": "4.x",
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
