ClickHouse · matsumotomiki · Dec 13, 2024 · Dec 13, 2024 · Dec 13, 2024 · Dec 13, 2024
diff --git a/.gitignore b/.gitignore
@@ -10,6 +10,12 @@ docs/en/operations
 docs/en/sql-reference
 docs/ru
 docs/zh
+docs/ja/development
+docs/ja/engines
+docs/ja/getting-started
+docs/ja/interfaces
+docs/ja/operations
+docs/ja/sql-reference
 docs/_clients
 
 **/.DS_Store

diff --git a/copyClickhouseRepoDocs.sh b/copyClickhouseRepoDocs.sh
@@ -19,6 +19,7 @@ cp -r ClickHouse/docs/en/operations      docs/en/
 cp -r ClickHouse/docs/en/sql-reference   docs/en/
 cp -r ClickHouse/docs/ru                 docs/
 cp -r ClickHouse/docs/zh                 docs/
+cp -r ClickHouse/docs/ja                 docs/
 
 # Necessary for autogenerating settings
 cp ClickHouse/src/Core/FormatFactorySettings.h "$(dirname "$0")"

diff --git a/docs/ja/_placeholders/api/_invitations-api-reference.md b/docs/ja/_placeholders/api/_invitations-api-reference.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: 招待
+title: 招待
+---
+
+## すべての招待を一覧表示
+
+このファイルは、ビルドプロセス中に `clickhouseapi.js` によって生成されます。内容を変更する必要がある場合は、`clickhouseapi.js` を編集してください。
diff --git a/docs/ja/_placeholders/api/_keys-api-reference.md b/docs/ja/_placeholders/api/_keys-api-reference.md
@@ -0,0 +1,9 @@
+---
+sidebar_label: キー
+title: キー
+---
+
+## すべてのキーのリストを取得する
+
+このファイルは、ビルドプロセス中に `clickhouseapi.js` によって生成されます。  
+内容を変更する必要がある場合は、`clickhouseapi.js` を編集してください。
diff --git a/docs/ja/_placeholders/api/_members-api-reference.md b/docs/ja/_placeholders/api/_members-api-reference.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: メンバー
+title: メンバー
+---
+
+## 組織メンバーの一覧
+
+このファイルはビルドプロセス中に`clickhouseapi.js`によって生成されます。内容を変更する必要がある場合は、`clickhouseapi.js`を編集してください。
diff --git a/docs/ja/_placeholders/api/_organizations-api-reference.md b/docs/ja/_placeholders/api/_organizations-api-reference.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: 組織
+title: 組織
+---
+
+## 組織の詳細を取得する
+
+このファイルはビルドプロセス中に `clickhouseapi.js` によって生成されます。内容を変更する必要がある場合は、`clickhouseapi.js` を編集してください。
diff --git a/docs/ja/_placeholders/api/_services-api-reference.md b/docs/ja/_placeholders/api/_services-api-reference.md
@@ -0,0 +1,8 @@
+---
+sidebar_label: サービス
+title: サービス
+---
+
+## 組織サービスの一覧
+
+このファイルは、ビルドプロセス中に `clickhouseapi.js` によって生成されます。内容を変更する必要がある場合は、`clickhouseapi.js` を編集してください。
diff --git a/docs/ja/_placeholders/changelog/_index.md b/docs/ja/_placeholders/changelog/_index.md
@@ -0,0 +1,8 @@
+---
+slug: /ja/whats-new/changelog/
+sidebar_position: 2
+sidebar_label: 2024
+title: 2024 Changelog
+note: このファイルは `yarn new-build` によって自動生成されます。
+---
+
diff --git a/docs/ja/_snippets/_GCS_authentication_and_bucket.md b/docs/ja/_snippets/_GCS_authentication_and_bucket.md
@@ -0,0 +1,41 @@
+<details><summary>GCS バケットと HMAC キーを作成する</summary>
+
+### ch_bucket_us_east1
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-bucket-1.png)
+
+### ch_bucket_us_east4
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-bucket-2.png)
+
+### アクセスキーを生成する
+
+### サービスアカウントの HMAC キーとシークレットを作成する
+
+**Cloud Storage > Settings > Interoperability** を開き、既存の **Access key** を選択するか、**CREATE A KEY FOR A SERVICE ACCOUNT** を選択します。このガイドでは、新しいサービスアカウントの新しいキーを作成する手順を説明します。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-create-a-service-account-key.png)
+
+### 新しいサービスアカウントを追加する
+
+すでにサービスアカウントが存在しないプロジェクトの場合は、**CREATE NEW ACCOUNT** をクリックします。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-create-service-account-0.png)
+
+サービスアカウントを作成するには3つのステップがあります。最初のステップでは、アカウントに意味のある名前、ID、説明を付けます。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-create-service-account-a.png)
+
+Interoperability 設定ダイアログでは、IAM ロールとして **Storage Object Admin** ロールが推奨されます。ステップ2でそのロールを選択します。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-create-service-account-2.png)
+
+ステップ3はオプションであり、このガイドでは使用しません。ポリシーに基づいて、ユーザーにこれらの特権を与えることができます。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-create-service-account-3.png)
+
+サービスアカウントの HMAC キーが表示されます。この情報を保存してください。ClickHouse の設定で使用します。
+
+![バケットを追加](@site/docs/ja/integrations/data-ingestion/s3/images/GCS-guide-key.png)
+
+</details>
diff --git a/docs/ja/_snippets/_S3_authentication_and_bucket.md b/docs/ja/_snippets/_S3_authentication_and_bucket.md
@@ -0,0 +1,132 @@
+<details><summary>S3バケットとIAMユーザーの作成</summary>
+
+この記事では、AWS IAMユーザーを設定し、S3バケットを作成し、ClickHouseをそのバケットをS3ディスクとして使用するように設定する基本を説明しています。使用する権限を決定するためにセキュリティチームと協力し、これらを出発点として考えてください。
+
+### AWS IAMユーザーの作成
+この手順では、ログインユーザーではなくサービスアカウントユーザーを作成します。
+1.  AWS IAM 管理コンソールにログインします。
+
+2. 「ユーザー」で、**ユーザーを追加** を選択します。
+
+  ![create_iam_user_0](@site/docs/ja/_snippets/images/s3/s3-1.png)
+
+3. ユーザー名を入力し、資格情報の種類を **アクセスキー - プログラムによるアクセス** に設定し、**次: 権限** を選択します。
+
+  ![create_iam_user_1](@site/docs/ja/_snippets/images/s3/s3-2.png)
+
+4. ユーザーをグループに追加せず、**次: タグ** を選択します。
+
+  ![create_iam_user_2](@site/docs/ja/_snippets/images/s3/s3-3.png)
+
+5. タグを追加する必要がなければ、**次: 確認** を選択します。
+
+  ![create_iam_user_3](@site/docs/ja/_snippets/images/s3/s3-4.png)
+
+6. **ユーザーを作成** を選択します。
+
+    :::note
+    ユーザーに権限がないという警告メッセージは無視できます。次のセクションでバケットに対してユーザーに権限が付与されます。
+    :::
+
+  ![create_iam_user_4](@site/docs/ja/_snippets/images/s3/s3-5.png)
+
+7. ユーザーが作成されました。**表示** をクリックし、アクセスキーとシークレットキーをコピーします。
+:::note
+これがシークレットアクセスキーが利用可能な唯一のタイミングですので、キーを別の場所に保存してください。
+:::
+
+  ![create_iam_user_5](@site/docs/ja/_snippets/images/s3/s3-6.png)
+
+8. 閉じるをクリックし、ユーザー画面でそのユーザーを見つけます。
+
+  ![create_iam_user_6](@site/docs/ja/_snippets/images/s3/s3-7.png)
+
+9. ARN（Amazon Resource Name）をコピーし、バケットのアクセスポリシーを設定する際に使用するために保存します。
+
+  ![create_iam_user_7](@site/docs/ja/_snippets/images/s3/s3-8.png)
+
+### S3バケットの作成
+1. S3バケットセクションで、**バケットの作成** を選択します。
+
+  ![create_s3_bucket_0](@site/docs/ja/_snippets/images/s3/s3-9.png)
+
+2. バケット名を入力し、他のオプションはデフォルトのままにします。
+:::note
+バケット名はAWS全体で一意である必要があります。組織内だけでなく、一意でない場合はエラーが発生します。
+:::
+3. `すべてのパブリックアクセスをブロック` を有効のままにします。パブリックアクセスは必要ありません。
+
+  ![create_s3_bucket_2](@site/docs/ja/_snippets/images/s3/s3-a.png)
+
+4. ページの下部にある **バケットの作成** を選択します。
+
+  ![create_s3_bucket_3](@site/docs/ja/_snippets/images/s3/s3-b.png)
+
+5. リンクを選択し、ARNをコピーして、バケットのアクセスポリシーを設定するときに使用するために保存します。
+
+6. バケットが作成されたら、S3バケットリストで新しいS3バケットを見つけ、リンクを選択します。
+
+  ![create_s3_bucket_4](@site/docs/ja/_snippets/images/s3/s3-c.png)
+
+7. **フォルダを作成** を選択します。
+
+  ![create_s3_bucket_5](@site/docs/ja/_snippets/images/s3/s3-d.png)
+
+8. ClickHouse S3ディスクのターゲットとなるフォルダ名を入力し、**フォルダを作成** を選択します。
+
+  ![create_s3_bucket_6](@site/docs/ja/_snippets/images/s3/s3-e.png)
+
+9. フォルダがバケットリストに表示されるはずです。
+
+  ![create_s3_bucket_7](@site/docs/ja/_snippets/images/s3/s3-f.png)
+
+10. 新しいフォルダのチェックボックスを選択し、**URLをコピー** をクリックします。コピーしたURLは、次のセクションでのClickHouseストレージ設定で使用します。
+
+  ![create_s3_bucket_8](@site/docs/ja/_snippets/images/s3/s3-g.png)
+
+11. **権限** タブを選択し、**バケットポリシー** セクションの **編集** ボタンをクリックします。
+
+  ![create_s3_bucket_9](@site/docs/ja/_snippets/images/s3/s3-h.png)
+
+12. 以下の例のようにバケットポリシーを追加します:
+```json
+{
+	"Version": "2012-10-17",
+	"Id": "Policy123456",
+	"Statement": [
+		{
+			"Sid": "abc123",
+			"Effect": "Allow",
+			"Principal": {
+				"AWS": "arn:aws:iam::921234567898:user/mars-s3-user"
+			},
+			"Action": "s3:*",
+			"Resource": [
+				"arn:aws:s3:::mars-doc-test",
+				"arn:aws:s3:::mars-doc-test/*"
+			]
+		}
+	]
+}
+```
+
+```response
+|パラメータ | 説明 | 例 |
+|----------|-------------|----------------|
+|Version | ポリシーインタープリタのバージョン、そのままにしておく | 2012-10-17 |
+|Sid | ユーザー定義のポリシーID | abc123 |
+|Effect | ユーザー要求が許可されるか拒否されるか | Allow |
+|Principal | 許可されるアカウントまたはユーザー | arn:aws:iam::921234567898:user/mars-s3-user |
+|Action | バケット上で許可される操作| s3:*|
+|Resource | バケット内で操作が許可されるリソース | "arn:aws:s3:::mars-doc-test", "arn:aws:s3:::mars-doc-test/*" |
+```
+
+:::note
+使用する権限を決定するためにセキュリティチームと協力し、これらを出発点として考えてください。
+ポリシーと設定の詳細については、AWSドキュメントをご参照ください：
+https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-policy-language-overview.html
+:::
+
+13. ポリシー設定を保存します。
+
+</details>
diff --git a/docs/ja/_snippets/_add_remote_ip_access_list_detail.md b/docs/ja/_snippets/_add_remote_ip_access_list_detail.md
@@ -0,0 +1,11 @@
+<details><summary>IPアクセスリストを管理する</summary>
+
+ClickHouse Cloudのサービスリストから作業するサービスを選択し、**セキュリティ**に切り替えます。IPアクセスリストに、ClickHouse Cloudサービスに接続する必要があるリモートシステムのIPアドレスや範囲が含まれていない場合は、**エントリを追加**して問題を解決できます。
+
+![サービスがトラフィックを許可しているか確認](@site/docs/ja/_snippets/images/ip-allow-list-check-list.png)
+
+ClickHouse Cloudサービスに接続する必要がある個別のIPアドレス、またはアドレスの範囲を追加します。フォームを適宜修正し、**エントリを追加**し、**エントリを送信**します。
+
+![現在のIPアドレスを追加](@site/docs/ja/_snippets/images/ip-allow-list-add-current-ip.png)
+
+</details>
diff --git a/docs/ja/_snippets/_add_superset_detail.md b/docs/ja/_snippets/_add_superset_detail.md
@@ -0,0 +1,45 @@
+<details><summary>DockerでApache Supersetを起動</summary>
+
+Supersetは、[Docker Composeを使用してローカルにSupersetをインストールする](https://superset.apache.org/docs/installation/installing-superset-using-docker-compose/)手順を提供しています。GitHubからApache Supersetリポジトリをチェックアウトした後、最新の開発コードや特定のタグを実行することができます。`pre-release`としてマークされていない最新のリリースである2.0.0をお勧めします。
+
+`docker compose`を実行する前にいくつかのタスクを行う必要があります：
+
+1. 公式のClickHouse Connectドライバーを追加
+2. MapBox APIキーを取得し、それを環境変数として追加（任意）
+3. 実行するSupersetのバージョンを指定
+
+:::tip
+以下のコマンドはGitHubリポジトリのトップレベル、`superset`から実行してください。
+:::
+
+## 公式ClickHouse Connectドライバー
+
+SupersetデプロイメントでClickHouse Connectドライバーを利用可能にするために、ローカルのrequirementsファイルに追加します：
+
+```bash
+echo "clickhouse-connect" >> ./docker/requirements-local.txt
+```
+
+## MapBox
+
+これは任意です。MapBox APIキーなしでSupersetで位置データをプロットできますが、キーを追加するべきというメッセージが表示され、地図の背景画像が欠けます（データポイントのみが表示され、地図の背景は表示されません）。MapBoxは無料のティアを提供していますので、利用したい場合はぜひご利用ください。
+
+ガイドが作成するサンプルの可視化の一部は、例えば経度や緯度データなどの位置情報を使用します。SupersetはMapBoxマップのサポートを含んでいます。MapBoxの可視化を使用するには、MapBox APIキーが必要です。[MapBoxの無料ティア](https://account.mapbox.com/auth/signup/)にサインアップし、APIキーを生成してください。
+
+APIキーをSupersetで利用可能にします：
+
+```bash
+echo "MAPBOX_API_KEY=pk.SAMPLE-Use-your-key-instead" >> docker/.env-non-dev
+```
+
+## Supersetバージョン2.0.0をデプロイ
+
+リリース2.0.0をデプロイするには、以下を実行します：
+
+```bash
+git checkout 2.0.0
+TAG=2.0.0 docker-compose -f docker-compose-non-dev.yml pull
+TAG=2.0.0 docker-compose -f docker-compose-non-dev.yml up
+```
+
+</details>
diff --git a/docs/ja/_snippets/_aws_regions.md b/docs/ja/_snippets/_aws_regions.md
@@ -0,0 +1,11 @@
+| 地域             | VPC サービス名                                                      | アベイラビリティーゾーン ID   |
+|------------------|--------------------------------------------------------------------|------------------------------|
+|ap-south-1        | com.amazonaws.vpce.ap-south-1.vpce-svc-0a786406c7ddc3a1b           | aps1-az1 aps1-az2 aps1-az3   |
+|ap-southeast-1    | com.amazonaws.vpce.ap-southeast-1.vpce-svc-0a8b096ec9d2acb01       | apse1-az1 apse1-az2 apse1-az3|
+|ap-southeast-2    | com.amazonaws.vpce.ap-southeast-2.vpce-svc-0ca446409b23f0c01       | apse2-az1 apse2-az2 apse2-az3|
+|eu-central-1      | com.amazonaws.vpce.eu-central-1.vpce-svc-0536fc4b80a82b8ed         | euc1-az2 euc1-az3 euc1-az1   |
+|eu-west-1         | com.amazonaws.vpce.eu-west-1.vpce-svc-066b03c9b5f61c6fc            | euw1-az2 euw1-az3 euw1-az1   |
+|us-east-1 c0      | com.amazonaws.vpce.us-east-1.vpce-svc-0a0218fa75c646d81            | use1-az6 use1-az1 use1-az2   |
+|us-east-1 c1      | com.amazonaws.vpce.us-east-1.vpce-svc-096c118db1ff20ea4            | use1-az6 use1-az4 use1-az2   |
+|us-east-2         | com.amazonaws.vpce.us-east-2.vpce-svc-0b99748bf269a86b4            | use2-az1 use2-az2 use2-az3   |
+|us-west-2         | com.amazonaws.vpce.us-west-2.vpce-svc-049bbd33f61271781            | usw2-az2 usw2-az1 usw2-az3   |
diff --git a/docs/ja/_snippets/_check_ip_access_list_detail.md b/docs/ja/_snippets/_check_ip_access_list_detail.md
@@ -0,0 +1,15 @@
+<details><summary>IPアクセスリストを管理する</summary>
+
+ClickHouse Cloudのサービスリストから作業するサービスを選び、**設定**に切り替えます。
+
+![サービスの設定](@site/docs/ja/_snippets/images/cloud-service-settings.png)
+
+IPアクセスリストが**現在、このサービスにアクセスできるトラフィックはありません**と表示される場合は、**エントリを追加**して問題を解決できます。
+
+![サービスがトラフィックを許可しているか確認する](@site/docs/ja/_snippets/images/ip-allow-list-check-list.png)
+
+クイックスタートのために、ローカルのセキュリティポリシーが許可する場合は、現在のIPアドレスのみを追加することができます。これを行うには、**現在のIPを追加**を使用し、現在のIPと説明「ホームIP」でフォームを自動入力します。必要に応じてフォームを修正し、**エントリを追加**し**エントリを送信**します。
+
+![現在のIPアドレスを追加する](@site/docs/ja/_snippets/images/ip-allow-list-add-current-ip.png)
+
+</details>