ClickHouse · Blargian · Jun 5, 2026 · Jun 5, 2026 · Jun 5, 2026 · Jun 5, 2026
@@ -108,6 +108,7 @@ Please note: no additional experimental features are allowed to be enabled in Cl
 | [allow_experimental_nlp_functions](/operations/settings/settings#allow_experimental_nlp_functions) | `0` |
 | [allow_experimental_hash_functions](/operations/settings/settings#allow_experimental_hash_functions) | `0` |
 | [allow_experimental_time_series_table](/operations/settings/settings#allow_experimental_time_series_table) | `0` |
+| [unique_key_max_encoded_size](/operations/settings/settings#unique_key_max_encoded_size) | `256` |
 | [allow_experimental_unique_key](/operations/settings/settings#allow_experimental_unique_key) | `0` |
 | [allow_experimental_codecs](/operations/settings/settings#allow_experimental_codecs) | `0` |
 | [throw_on_unsupported_query_inside_transaction](/operations/settings/settings#throw_on_unsupported_query_inside_transaction) | `1` |

@@ -1,9 +1,9 @@
 ---
 date: 2023-10-25
-title: クォータとクエリの複雑性について
+title: クォータとクエリの複雑度について
 tags: ['Managing Cloud']
-keywords: ['クォータ', 'クエリの複雑性']
-description: 'クォータとクエリの複雑性は、ユーザーが ClickHouse で実行できる操作を制限するための強力な手段です。このナレッジベース記事では、これら 2 つの異なるアプローチの適用例を紹介します。'
+keywords: ['クォータ', 'クエリの複雑度']
+description: 'クォータとクエリの複雑度は、ユーザーが ClickHouse で実行できる操作を制限するための強力な手段です。このナレッジベース記事では、これら 2 つの異なるアプローチの適用例を紹介します。'
 ---
 
 {frontMatter.description}

@@ -97,7 +97,7 @@ ClickHouse は、単一の `INSERT`・単一のパーティションのレベル
 
 ## 例
 
-[fiddle](https://fiddle.clickhouse.com/7ef9ed84-ac14-4f2c-9ca5-d5913089769a)で試すことができます：
+以下の例は、[fiddle](https://fiddle.clickhouse.com/7ef9ed84-ac14-4f2c-9ca5-d5913089769a)で対話的に実行できます：
 
 ```sql
 CREATE TABLE prod

@@ -10,7 +10,7 @@ keywords: ['例外', 'ユーザー設定']
 
 {/* トランケート */}
 
-## DB::Exception: Cannot update user `default` in users.xml because this storage is readonly. (ACCESS_STORAGE_READONLY) \{#dbexception-cannot-update-user-default-in-usersxml-because-this-storage-is-readonly-access_storage_readonly\}
+## DB::Exception: Cannot update user `default` in users.xml because this storage is readonly. (ACCESS&#95;STORAGE&#95;READONLY) \{#dbexception-cannot-update-user-default-in-usersxml-because-this-storage-is-readonly-access&#95;storage&#95;readonly\}
 
 ユーザーの設定を変更しようとすると、上記の例外が発生することがあります。
 
@@ -28,6 +28,6 @@ keywords: ['例外', 'ユーザー設定']
 
 ユーザーの作成方法については、[このページ](/sql-reference/statements/create/user)を参照してください。
 
-## SQL ベースのアクセス制御を有効化する \{#enable-sql-driven-access-control\}
+## SQL ベースのアクセス制御を有効にする \{#enable-sql-driven-access-control\}
 
-default ユーザーに対して、SQL ベースのアクセス制御とアカウント管理を有効にできます。これを有効にするための手順は、この[ページ](/operations/access-rights#enabling-access-control)で説明されています。
+デフォルトユーザーに対して、SQL ベースのアクセス制御とアカウント管理を有効にできます。これを有効にする手順は、この[ページ](/operations/access-rights#enabling-access-control)に記載されています。
@@ -8,7 +8,7 @@ keywords: ['Parquet', 'Cannot Append Data']
 
 {frontMatter.description}
 
-{/* 切り捨て */}
+{/* truncate */}
 
 ## ClickHouse での「Cannot Append Data in Parquet Format」エラーの解消 \{#resolving-cannot-append-data-in-parquet-format-error-in-clickhouse\}
 

@@ -25,7 +25,7 @@ keywords: ['エラー', 'SSL 証明書', '210']
 
 ## 解決策 \{#solution\}
 
-内部 CA または自己署名 CA を使用する場合は、クライアントディレクトリ (例: `/etc/clickhouse-client`) 内の `config.xml` で CA ルート証明書を設定し、デフォルトの場所から読み込まれるデフォルトのルート CA 証明書を無効にします。
+内部 CA または自己署名 CA を使用する場合は、クライアントディレクトリ（例: `/etc/clickhouse-client`）内の `config.xml` で CA ルート証明書を設定し、デフォルトの場所から読み込まれるデフォルトのルート CA 証明書を無効にします。
 
 以下は設定例です。
 
@@ -44,6 +44,6 @@ keywords: ['エラー', 'SSL 証明書', '210']
 </openSSL>
 ```
 
-## 追加リソース \{#additional-resources\}
+## 参考資料 \{#additional-resources\}
 
-[https://clickhouse.com/docs/interfaces/cli/#configuration&#95;files](https://clickhouse.com/docs/interfaces/cli/#configuration_files) を参照してください
+[https://clickhouse.com/docs/interfaces/cli/#configuration&#95;files](https://clickhouse.com/docs/interfaces/cli/#configuration_files)をご覧ください
@@ -1,9 +1,9 @@
 ---
-title: 行を返さずにクエリ処理時間を測定する方法
-description: クライアントに行を一切返さずにクエリ処理時間を測定するために、ClickHouse の `FORMAT Null` オプションを使用する方法を説明します。
+title: 行を返さずに処理時間を測定する方法
+description: クライアントに行を一切返さずに処理時間を測定するために、ClickHouse の `FORMAT Null` オプションを使用する方法を説明します。
 date: 2023-06-07
 tags: ['パフォーマンスと最適化']
-keywords: ['クエリ処理時間']
+keywords: ['処理時間']
 ---
 
 {frontMatter.description}

@@ -8,7 +8,7 @@ keywords: ['cURL', 'クラウド管理', 'ClickHouse API']
 
 {frontMatter.description}
 
-{/* 切り捨て */}
+{/* 省略 */}
 
 ## ClickHouse API と cURL を使用して Cloud サービスを開始・停止・再開する方法 \{#how-to-start-stop-and-resume-a-cloud-service-using-the-clickhouse-api-and-curl\}
 

@@ -1,9 +1,9 @@
 ---
-title: ClickHouse における「Too Many Parts」エラーの解決
-description: 挿入レートの最適化、MergeTree 設定の調整、パーティション管理の改善によって、ClickHouse で発生する「Too many parts」エラーを解決する方法を解説します。
+title: ClickHouse における「パーツが多すぎる」エラーの解決
+description: 挿入レートの最適化、MergeTree 設定の調整、パーティション管理の改善によって、ClickHouse で発生する「パーツが多すぎる」エラーを解決する方法を解説します。
 date: 2023-03-20
 tags: ['エラーと例外']
-keywords: ['Too many parts']
+keywords: ['パーツが多すぎる']
 ---
 
 {frontMatter.description}

@@ -8,7 +8,7 @@ keywords: ['clusterAllReplicas']
 
 {frontMatter.description}
 
-{/* 切り捨て */}
+{/* truncate */}
 
 ## 解答 \{#answer\}
 

@@ -1,6 +1,6 @@
 ---
 title: ClickHouse からファイルへデータをエクスポートする方法
-description: "`INTO OUTFILE`、File テーブルエンジン、コマンドラインリダイレクトなど、ClickHouse からデータをエクスポートするさまざまな方法について説明します。"
+description: "`INTO OUTFILE`、File テーブルエンジン、コマンドラインでのリダイレクトなど、ClickHouse からデータをエクスポートするさまざまな方法について説明します。"
 date: 2023-03-22
 tags: ['データエクスポート']
 keywords: ['データのエクスポート', 'INTO OUTFILE', 'File テーブルエンジン']

@@ -1,6 +1,6 @@
 ---
 title: ClickHouse におけるフィルタ付き集約の利用
-description: クエリ構文を簡潔にし、分析を強化するために、ClickHouse で `-If` および `-Distinct` 集約コンビネータを用いたフィルタ付き集約の使い方を学びます。
+description: クエリ構文を簡潔にし、分析を強化するために、ClickHouse で `-If` および `-Distinct` 集約関数コンビネータを用いたフィルタ付き集約の使い方を学びます。
 date: 2023-03-01
 tags: ['Functions']
 keywords: ['フィルタ付き集約']

@@ -2,7 +2,6 @@
 title: ClickHouseで最もコストの高いクエリを特定する方法
 description: ClickHouse の `query_log` テーブルを使用して、分散ノード全体でメモリおよび CPU 使用量の大きいクエリを特定する方法を学びます。
 date: 2023-03-26
-slug: find-expensive-queries
 tags: ['パフォーマンスと最適化']
 keywords: ['高コストなクエリ']
 ---
@@ -98,6 +97,10 @@ FROM s3Cluster('default','https://clickhouse-public-datasets.s3.amazonaws.com/yo
 クラスタ構成の ClickHouse 環境 (ClickHouse Cloud など) では、`initial_query_id` はリクエストを受け付けたノードから起動される分散クエリ実行における、最初に発行されたクエリの ID を表します。
 この場合、`query_id` フィールドには、別のノード上で実行される子クエリの ID が含まれます。
 
+:::note[異なる `query_id` 値の原因は分散実行だけではありません]
+単一のクエリでも、独自の `query_id` と `is_initial_query = 0` を持つ内部サブクエリが生成され、ログに記録されることがあります。最も一般的なのは、[ビュー](/operations/system-tables/query_views_log) を評価するために ClickHouse が実行する内部クエリです。これらの内部識別子は ClickHouse によって割り当てられるため、クライアントに報告されるものと同じ形式にならない場合があります。ビュー関連の処理では、`queryView...` のようなラベルを含む `query_id` 値が表示されることがあります。送信したクエリそのものを対象にしたい場合は、`is_initial_query = 1` (または `query_id = initial_query_id`) でフィルタリングしてください。これは `query_log` のサーバー側の動作であり、Cloud SQL Console を含むどのクライアントでも同じです。
+:::
+
 上記のクエリに `query_id` を追加すると、`initial_query_id` = `a7262fa2-bd8b-4b51-a359-621ccf282417` と `hostname()` を軸に検索を絞り込めます。
 
 ```sql

@@ -55,6 +55,10 @@ ORDER BY
 もし `system.query_log` テーブルがない場合、クエリログが有効になっていない可能性があります。有効化方法については、[`query_log` 設定](/operations/server-configuration-parameters/settings#query_log) を参照してください。
 :::
 
+:::note[`query_log` には送信したクエリ以外も含まれます]
+送信した 1 つのクエリが複数の行として現れることがあります。初期クエリ (`is_initial_query = 1`) に加え、派生的な処理や内部ステップ (`is_initial_query = 0`) も含まれるためです。たとえば、分散実行のための二次クエリや、ビューの評価に使われる内部クエリなどがあります。これらの内部行にはそれぞれ独自の `query_id` 値があり、ClickHouse によって割り当てられます。また、`queryView...` のようなラベルを含むこともあるため、すべての `query_id` がクライアントで報告されたものと一致するとは限りません。実行したとおりのクエリに使用量を対応付けるには、`is_initial_query = 1` で絞り込むか、`query_id = initial_query_id` で一致させてください。詳しくは、[How to identify the most expensive queries](/knowledgebase/find-expensive-queries#initial_query_id-vs-query_id) および [`query_log` reference](/operations/system-tables/query_log) を参照してください。
+:::
+
 クラスタがない場合は、単一の `system.query_log` テーブルに対して直接クエリを実行できます。
 
 ```sql

@@ -1,9 +1,9 @@
 ---
-title: macOS の開発者検証エラーを修正する
-description: システム設定またはターミナルを使用して、ClickHouse コマンドを実行する際に発生する macOS の開発者検証エラーを解消する方法を説明します。
+title: macOS の開発元検証エラーを修正する
+description: システム設定またはターミナルを使用して、ClickHouse コマンドを実行する際に発生する macOS の開発元検証エラーを解消する方法を説明します。
 date: 2024-01-09
 tags: ['エラーと例外']
-keywords: ['開発者検証', 'macOS']
+keywords: ['開発元検証', 'macOS']
 ---
 
 import Image from "@theme/IdealImage";

@@ -1,6 +1,6 @@
 ---
 title: ClickHouse Cloud サービスの状態を確認する方法
-description: ClickHouse Cloud API を使用して、サービスを起動させることなく、停止中・待機中・実行中のいずれの状態かを確認する方法を解説します。
+description: ClickHouse Cloud API を使用して、サービスを起動させることなく、停止中・アイドル状態・実行中のいずれの状態かを確認する方法を解説します。
 date: 2023-11-16
 tags: ['クラウドの管理']
 keywords: ['クラウドサービスの状態']

@@ -8,7 +8,7 @@ keywords: ['利用可能なスレッド数']
 
 {frontMatter.description}
 
-{/* 切り捨て */}
+{/* 省略 */}
 
 ## ClickHouse のスレッド数を増やす \{#increasing-the-number-of-threads-in-clickhouse\}
 

@@ -1,6 +1,6 @@
 ---
-title: ClickHouse における Map 参照パフォーマンスの向上
-description: ClickHouse のクエリ性能を高めるために、特定のキーを個別の列としてマテリアライズし、Map 列の参照を最適化する方法を学びます。
+title: ClickHouse における Map ルックアップパフォーマンスの向上
+description: ClickHouse のクエリ性能を高めるために、特定のキーを個別の列としてマテリアライズし、Map 列のルックアップを最適化する方法を学びます。
 date: 2022-10-30
 tags: ['パフォーマンスと最適化']
 keywords: ['Map パフォーマンス']

@@ -1,5 +1,5 @@
 ---
-title: JSON 抽出の例
+title: JSON Extract の例
 description: "JSON から基本型を抽出する方法を示す簡単な例"
 date: 2021-09-01
 tags: ['データ形式']

@@ -1,8 +1,8 @@
 ---
 title: ClickHouse を使って MySQL データを Parquet、CSV、JSON にエクスポートする方法
-description: "`clickhouse-local` ツールを使い、MySQL データを Parquet、CSV、JSON などの形式に高速かつ効率的にエクスポートする方法を解説します。"
+description: "`clickhouse-local` ツールを使い、MySQL データを Parquet、CSV、JSON などのフォーマットに高速かつ効率的にエクスポートする方法を解説します。"
 date: 2023-03-21
-tags: ['データ形式', 'データエクスポート']
+tags: ['データフォーマット', 'データエクスポート']
 keywords: ['MySQL', 'Parquet', 'CSV', 'JSON']
 ---
 

@@ -1,7 +1,7 @@
 ---
-title: "クエリで Projection が利用されているかを確認する方法"
+title: "クエリで PROJECTION が利用されているかを確認する方法"
 date: 2022-07-10
-description: "サンプルデータでテストし、EXPLAIN を用いて Projection の利用状況を確認することで、ClickHouse のクエリで Projection が使われているかを検証する方法を解説します。"
+description: "サンプルデータでテストし、EXPLAIN を用いて PROJECTION の利用状況を確認することで、ClickHouse のクエリで PROJECTION が使われているかを検証する方法を解説します。"
 tags: ['Data Modelling']
 keywords: ['Projection']
 ---

@@ -1,6 +1,6 @@
 ---
 date: 2023-05-08
-title: "ClickHouse Cloud Service へ接続するための Python クライアント実装例"
+title: "ClickHouse Cloud サービスへ接続するための Python クライアント実装例"
 description: "clickhouse-connect ドライバーを使用した手順付きサンプルを通じて、Python で ClickHouse Cloud Service に接続する方法を学びます。"
 tags: ['言語クライアント']
 keywords: ['Python', 'ClickHouse Cloud']

@@ -1,9 +1,9 @@
 ---
-title: 'ランブック：JSON Schema'
+title: 'ランブック：JSON schema'
 description: 'ClickHouse の JSON データに適した schema アプローチを選択 — 型付きカラム、ハイブリッド、ネイティブ JSON、または String ストレージ'
 date: 2026-03-20
 tags: ['ランブック', 'データモデリング']
-keywords: ['JSON', 'JSON type', 'schema 設計', '型ヒント', 'max_dynamic_paths', '半構造化データ', '動的 schema', 'JSONAsObject']
+keywords: ['JSON', 'JSON 型', 'schema 設計', '型ヒント', 'max_dynamic_paths', '半構造化データ', '動的 schema', 'JSONAsObject']
 ---
 
 import Details from '@theme/Details';

@@ -223,6 +223,10 @@ ORDER BY memory_usage DESC
 LIMIT 10
 ```
 
+:::note
+1 つのクエリが、異なる `query_id` 値を持つ複数の行として記録されることがあります。分散セカンダリクエリと内部ビューのステップでは `is_initial_query = 0` になります。クエリを送信時の形で確認するには、`is_initial_query = 1` (または `query_id = initial_query_id`) で絞り込んでください。また、ClickHouse が割り当てる内部 `query_id` 値には、`queryView...` のようなラベルが含まれる場合がある点に注意してください。詳しくは [`query_log` リファレンス](/operations/system-tables/query_log) を参照してください。
+:::
+
 ## プロジェクションはどれくらいのディスク容量を使用しているか \{#how-much-disk-space-are-my-projection-using\}
 
 ```sql
-Original file line number
+Diff line change
@@ Expand Up @@
     ## 例
-    [fiddle](https://fiddle.clickhouse.com/7ef9ed84-ac14-4f2c-9ca5-d5913089769a)で試すことができます：
+    以下の例は、[fiddle](https://fiddle.clickhouse.com/7ef9ed84-ac14-4f2c-9ca5-d5913089769a)で対話的に実行できます：
     ```sql
     CREATE TABLE prod
@@ Expand Down @@