docs(locadex): add translations

Author: locadex-agent[bot]

gt-lock.json

@@ -6705,7 +6705,7 @@ GROUP BY の実行中にメモリ使用量がこのバイト数のしきい値
 
 <VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "0"},{"label": "ハッシュ結合のディスクへの自動スピルを制御する新しい設定。0 以外の値でスピルを有効にし、バイト単位のしきい値を設定します。"}]}]} />
 
-0 以外の値に設定し、`join_algorithm` が `hash`、`parallel_hash`、`default`、または `auto` の場合、右側のデータがこのバイト数を超えると、ディスクへのスピルを有効にするため、ハッシュ結合は自動的に Grace Hash Join に変換されます。0 (デフォルト) に設定すると、自動スピルは無効になります。これにより、join 最適化による順序どおりの読み取りは行われません。
+0 以外の値に設定し、`join_algorithm` が `hash`、`parallel_hash`、`default`、または `auto` の場合、右側のデータがこのバイト数を超えると、ディスクへのスピルを有効にするため、ハッシュ結合は自動的に Grace Hash Join に変換されます。0 (デフォルト) に設定すると、この絶対的なバイトしきい値は無効になりますが、自動スピルは `max_bytes_ratio_before_external_join` (デフォルトは `0.5`) によって引き続き発生する可能性があります。自動スピルを完全に無効にするには、両方を `0` に設定してください。これにより、join 最適化による順序どおりの読み取りは行われません。
 
 ## max_bytes_before_external_sort \{#max_bytes_before_external_sort\}
 
@@ -6782,15 +6782,15 @@ ORDER BY 句と LIMIT 句を含むクエリで、メモリ使用量が指定さ
 
 ## max_bytes_ratio_before_external_join \{#max_bytes_ratio_before_external_join\}
 
-<SettingsInfoBlock type="Double" default_value="0" />
+<SettingsInfoBlock type="Double" default_value="0.5" />
 
-<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "新しい設定: ハッシュ結合で、スピルのしきい値として使用する利用可能メモリの比率。絶対値の `max_bytes_before_external_join` と併用され、小さい方が適用されます。"}]}]} />
+<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0.5"},{"label": "新しい設定: ハッシュ結合で、スピルのしきい値として使用する利用可能メモリの比率。デフォルトで `0.5` に設定されており、`max_bytes_ratio_before_external_group_by` および `max_bytes_ratio_before_external_sort` と同様です。絶対値の `max_bytes_before_external_join` と併用され、小さい方が適用されます。"}]}]} />
 
 `JOIN` に使用できる利用可能メモリの比率です。この値に達すると、ハッシュ結合は Grace Hash Join に変換され、右側のデータがディスクにスピルされます。
 
 たとえば `0.6` に設定すると、`JOIN` は実行開始時に、右側のハッシュテーブルに対して利用可能メモリの `60%` (server/user/merges 用) まで使用できます。その後はディスクへのスピルが始まります。
 
-`max_bytes_before_external_join` と `max_bytes_ratio_before_external_join` の両方が設定されている場合は、算出されたしきい値のうち小さい方が使用されます。比率が `0` (デフォルト) の場合は、絶対値の設定のみが適用されます。
+`max_bytes_before_external_join` と `max_bytes_ratio_before_external_join` の両方が設定されている場合は、算出されたしきい値のうち小さい方が使用されます。比率が `0` の場合は、絶対値の設定のみが適用されます。
 
 `join_algorithm` が `hash`、`parallel_hash`、`default`、または `auto` の場合で、かつ一時データパスが設定されている場合にのみ有効です。
 

i18n/jp/docusaurus-plugin-content-docs/current/operations/settings/settings.md

@@ -249,7 +249,7 @@ ClickHouse Cloud で HyperDX が管理されている場合、これらの設定
 :::
 
 * `HYPERDX_API_KEY`
-  * **デフォルト:** なし（必須）
+  * **デフォルト:** なし (必須)
   * **説明:** HyperDX API の認証キー。
   * **ガイダンス:**
   * テレメトリおよびログ収集に必須
@@ -259,7 +259,7 @@ ClickHouse Cloud で HyperDX が管理されている場合、これらの設定
 
 * `HYPERDX_LOG_LEVEL`
   * **デフォルト:** `info`
-  * **説明:** ログ出力レベル（詳細度）を設定します。
+  * **説明:** ログ出力レベル (詳細度) を設定します。
   * **オプション:** `debug`, `info`, `warn`, `error`
   * **ガイダンス:**
   * 詳細なトラブルシューティングには `debug` を使用します。
@@ -375,66 +375,68 @@ ClickHouse Cloud で HyperDX が管理されている場合、これらの設定
   * **デフォルト:** `false`
   * **説明:** HyperDX における JSON 型のベータ版サポートを有効にします。OTel collector で JSON サポートを有効にするには、[`OTEL_AGENT_FEATURE_GATE_ARG`](#otel-collector) も参照してください。
   * **ガイダンス:**
-  * ClickStack で JSON サポートを有効にするには、`true` に設定します。
+    * **ベータ機能**を有効にします。JSON 型の schema は、一般的なオブザーバビリティ workloads には**推奨されません**。比較と、それぞれが適しているケースについては、[Map vs JSON type](/use-cases/observability/clickstack/ingesting-data/schema/map-vs-json) を参照してください。
+    * ClickStack UI で JSON サポートを有効にするには、`true` に設定します。
 
 ## OpenTelemetry collector \{#otel-collector\}
 
-詳しくは ["ClickStack OpenTelemetry Collector"](/use-cases/observability/clickstack/ingesting-data/otel-collector) を参照してください。
-
-- `CLICKHOUSE_ENDPOINT`
-  - **デフォルト:** スタンドアロンイメージの場合は *なし（必須）*。All-in-one または Docker Compose ディストリビューションの場合は、統合された ClickHouse インスタンスに設定されます。
-  - **説明:** テレメトリデータをエクスポートする ClickHouse インスタンスの HTTPS URL。
-  - **ガイダンス:**
-    - ポートを含む完全な HTTPS エンドポイントである必要があります（例: `https://clickhouse.example.com:8443`）
-    - コレクターが ClickHouse にデータを送信するために必須です
-
-- `CLICKHOUSE_USER`
-  - **デフォルト:** `default`
-  - **説明:** ClickHouse インスタンスに対して認証するために使用されるユーザー名。
-  - **ガイダンス:**
-    - ユーザーに `INSERT` と `CREATE TABLE` の権限が付与されていることを確認してください
-    - インジェスト専用のユーザーを作成することを推奨します
-
-- `CLICKHOUSE_PASSWORD`
-  - **デフォルト:** *なし（認証が有効な場合は必須）*
-  - **説明:** 指定された ClickHouse ユーザーのパスワード。
-  - **ガイダンス:**
-    - ユーザーアカウントにパスワードが設定されている場合は必須です
-    - 本番デプロイメントでは Secret などを用いて安全に保存してください
-
-- `HYPERDX_LOG_LEVEL`
-  - **デフォルト:** `info`
-  - **説明:** コレクターのログ詳細レベル。
-  - **ガイダンス:**
-    - `debug`、`info`、`warn`、`error` などの値を受け付けます
-    - トラブルシューティング時には `debug` を使用してください
-
-- `OPAMP_SERVER_URL`
-  - **デフォルト:** スタンドアロンイメージの場合は *なし（必須）*。All-in-one または Docker Compose ディストリビューションの場合は、デプロイされた HyperDX インスタンスを指します。
-  - **説明:** コレクターを管理するために使用される OpAMP サーバー（例: HyperDX インスタンス）の URL。デフォルトではポート `4320` を使用します。
-  - **ガイダンス:**
-    - 自身の HyperDX インスタンスを指す必要があります
-    - 動的な設定と安全なインジェストを有効にします
-    - 省略した場合、`OTLP_AUTH_TOKEN` が指定されていない限り、安全なインジェストは無効になります
-
-- `OTLP_AUTH_TOKEN`
-  - **デフォルト:** *なし*。スタンドアロンイメージでのみ使用されます。
-  - **説明:** OTLP 認証トークンを指定できます。設定されている場合、すべての通信でこの Bearer トークンが必須になります。
-  - **ガイダンス:**
-    - 本番環境でスタンドアロンのコレクターイメージを使用する場合に推奨されます。
-    
-- `HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASE`
-  - **デフォルト:** `default`
-  - **説明:** コレクターがテレメトリデータを書き込む ClickHouse データベース。
-  - **ガイダンス:**
-    - カスタムのデータベース名を使用する場合に設定してください
-    - 指定したユーザーがこのデータベースへアクセスできることを確認してください
-
-- `OTEL_AGENT_FEATURE_GATE_ARG`
-  - **デフォルト:** `<empty string>`
-  - **説明:** コレクターで有効にするフィーチャーフラグを指定します。`--feature-gates=clickhouse.json` を設定すると、コレクターで JSON 型の Beta サポートが有効になり、スキーマがその型で作成されるようになります。HyperDX で JSON サポートを有効にするには、[`BETA_CH_OTEL_JSON_SCHEMA_ENABLED`](#hyperdx) も参照してください。
-  - **ガイダンス:**
-  - ClickStack で JSON サポートを有効にするには `true` を設定します。
+詳しくは [&quot;ClickStack OpenTelemetry Collector&quot;](/use-cases/observability/clickstack/ingesting-data/otel-collector) を参照してください。
+
+* `CLICKHOUSE_ENDPOINT`
+  * **デフォルト:** スタンドアロンイメージの場合は *なし (必須)&#x20;*。All-in-one または Docker Compose ディストリビューションの場合は、統合された ClickHouse インスタンスに設定されます。
+  * **説明:** テレメトリデータをエクスポートする ClickHouse インスタンスの HTTPS URL。
+  * **ガイダンス:**
+    * ポートを含む完全な HTTPS エンドポイントである必要があります (例: `https://clickhouse.example.com:8443`) 
+    * コレクターが ClickHouse にデータを送信するために必須です
+
+* `CLICKHOUSE_USER`
+  * **デフォルト:** `default`
+  * **説明:** ClickHouse インスタンスに対して認証するために使用されるユーザー名。
+  * **ガイダンス:**
+    * ユーザーに `INSERT` と `CREATE TABLE` の権限が付与されていることを確認してください
+    * インジェスト専用のユーザーを作成することを推奨します
+
+* `CLICKHOUSE_PASSWORD`
+  * **デフォルト:** *なし (認証が有効な場合は必須)&#x20;*
+  * **説明:** 指定された ClickHouse ユーザーのパスワード。
+  * **ガイダンス:**
+    * ユーザーアカウントにパスワードが設定されている場合は必須です
+    * 本番デプロイメントでは Secret などを用いて安全に保存してください
+
+* `HYPERDX_LOG_LEVEL`
+  * **デフォルト:** `info`
+  * **説明:** コレクターのログ詳細レベル。
+  * **ガイダンス:**
+    * `debug`、`info`、`warn`、`error` などの値を受け付けます
+    * トラブルシューティング時には `debug` を使用してください
+
+* `OPAMP_SERVER_URL`
+  * **デフォルト:** スタンドアロンイメージの場合は *なし (必須)&#x20;*。All-in-one または Docker Compose ディストリビューションの場合は、デプロイされた HyperDX インスタンスを指します。
+  * **説明:** コレクターを管理するために使用される OpAMP サーバー (例: HyperDX インスタンス) の URL。デフォルトではポート `4320` を使用します。
+  * **ガイダンス:**
+    * 自身の HyperDX インスタンスを指す必要があります
+    * 動的な設定と安全なインジェストを有効にします
+    * 省略した場合、`OTLP_AUTH_TOKEN` が指定されていない限り、安全なインジェストは無効になります
+
+* `OTLP_AUTH_TOKEN`
+  * **デフォルト:** *なし*。スタンドアロンイメージでのみ使用されます。
+  * **説明:** OTLP 認証トークンを指定できます。設定されている場合、すべての通信でこの Bearer トークンが必須になります。
+  * **ガイダンス:**
+    * 本番環境でスタンドアロンのコレクターイメージを使用する場合に推奨されます。
+
+* `HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASE`
+  * **デフォルト:** `default`
+  * **説明:** コレクターがテレメトリデータを書き込む ClickHouse データベース。
+  * **ガイダンス:**
+    * カスタムのデータベース名を使用する場合に設定してください
+    * 指定したユーザーがこのデータベースへアクセスできることを確認してください
+
+* `OTEL_AGENT_FEATURE_GATE_ARG`
+  * **デフォルト:** `<empty string>`
+  * **説明:** コレクターで有効にするフィーチャーフラグを指定します。`--feature-gates=clickhouse.json` を設定すると、コレクターで JSON type のベータサポートが有効になり、schemas がその型で作成されるようになります。HyperDX で JSON サポートを有効にするには、[`BETA_CH_OTEL_JSON_SCHEMA_ENABLED`](#hyperdx) も参照してください。
+  * **ガイダンス:**
+    * **ベータ機能**を有効にします。JSON type の schemas は、一般的なオブザーバビリティ workloads には**推奨されません**。比較と、それぞれが適している場面については [Map vs JSON type](/use-cases/observability/clickstack/ingesting-data/schema/map-vs-json) を参照してください。
+    * JSON type を使用して新しいテーブルを作成するには、`--feature-gates=clickhouse.json` を設定します。
 
 ## ClickHouse \{#clickhouse\}
 

i18n/jp/docusaurus-plugin-content-docs/current/use-cases/observability/clickstack/config.md

@@ -1,18 +1,5 @@
-import BetaBadge from '@theme/badges/BetaBadge';
+## schema の選択: Map vs JSON \{#schema-choice-map-vs-json\}
 
-## JSON 型サポート \{#json-type-support\}
+ClickStack では、デフォルトで属性を `Map(LowCardinality(String), String)` カラムに格納します。これはオブザーバビリティのワークロードに推奨される schema です。[バケット化された map のシリアライゼーション](/sql-reference/data-types/map#bucketed-map-serialization) と、map のキーおよび値に対するテキスト索引を組み合わせることで、動的な JSON subcolumns で発生するキーごとの取り込みオーバーヘッドなしに、必要な項目を選択的に検索できます。
 
-<BetaBadge/>
-
-:::warning[ベータ機能 - 本番環境向けではありません]
-**ClickStack** における JSON 型サポートは **ベータ機能** です。JSON 型自体は ClickHouse 25.3+ では本番環境向けとして利用可能ですが、ClickStack との統合はまだ積極的に開発中であり、制限があったり、将来的に変更されたり、不具合を含む可能性があります。
-:::
-
-ClickStack では、バージョン `2.0.4` 以降で [JSON 型](/interfaces/formats/JSON) をベータ機能としてサポートしています。
-
-この型の利点については [JSON 型の利点](/use-cases/observability/clickstack/ingesting-data/otel-collector#benefits-json-type) を参照してください。
-
-JSON 型のサポートを有効にするには、以下の環境変数を設定する必要があります。
-
-- `OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json'` - OTel collector でのサポートを有効にし、スキーマが JSON 型を使用して作成されるようにします。
-- `BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true` (ClickStack オープンソース版のみ) - ClickStack UI アプリケーションでのサポートを有効にし、JSON データに対してクエリを実行できるようにします。
+`JSON` 型の schema は、属性キーの集合が小さく安定しているワークロードでの評価用として、ベータで利用できます。ただし、デフォルトとしては**推奨されません**。完全な比較と、JSON サポートを有効にするために必要な環境変数については、[Map vs JSON type](/use-cases/observability/clickstack/ingesting-data/schema/map-vs-json) を参照してください。

i18n/jp/docusaurus-plugin-content-docs/current/use-cases/observability/clickstack/deployment/_snippets/_json_support.md

@@ -359,12 +359,10 @@ OTel collector を使用して ClickHouse 内にデータベースおよびテ
 ClickStack 内の異なるデータソース（ログやトレースなど）は、互いに相関付けることができます。これを有効にするには、各ソースで追加の設定が必要です。例えば、ログソースでは対応するトレースソースを指定でき、逆にトレースソース側でもログソースを指定できます。詳細は [「相関ソース」](/use-cases/observability/clickstack/config#correlated-sources) を参照してください。
 :::
 
-#### カスタムスキーマの使用 {#using-custom-schemas}
+#### カスタムスキーマの使用
 
 既存のサービスの既存データに ClickStack を接続したいユーザーは、必要に応じてデータベースおよびテーブルの設定を行えます。テーブルが ClickHouse 向けの OpenTelemetry スキーマに準拠している場合、設定は自動検出されます。
 
-独自スキーマを使用する場合は、必須フィールドが指定されていることを確認したうえで Logs ソースを作成することを推奨します。詳細は「[Log source settings](/use-cases/observability/clickstack/config#logs)」を参照してください。
+独自スキーマを使用する場合は、必須フィールドが指定されていることを確認したうえで Logs ログソースを作成することを推奨します。詳細は「[Log source settings](/use-cases/observability/clickstack/config#logs)」を参照してください。
 
-<JSONSupport/>
-
-加えて、ClickHouse Cloud サービスで JSON が有効化されていることを確認するため、support@clickhouse.com にお問い合わせください。
+<JSONSupport />

i18n/jp/docusaurus-plugin-content-docs/current/use-cases/observability/clickstack/deployment/managed.md

@@ -125,10 +125,4 @@ HyperDX UI に接続したら、[`Team Settings`](http://localhost:8080/team) 
 
 必要に応じて OTel collector の設定を変更できます。詳細は ["設定の変更"](/use-cases/observability/clickstack/ingesting-data/otel-collector#modifying-otel-collector-configuration) を参照してください。
 
-<JSONSupport />
-
-例えば、以下のように設定します。
-
-```shell
-docker run -e OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest
-```
+<JSONSupport />