メインコンテンツへスキップ

構文

ClickHouse Cloud で Dictionary を使用している場合は、DDLクエリオプションを使用して Dictionary を作成し、default ユーザーとして作成してください。 また、サポートされている Dictionary ソースの一覧は、Cloud Compatibility ガイドで確認してください。
Dictionary は、さまざまなソースを介して ClickHouse に接続できます。 ソースは、設定ファイルでは source セクションで設定し、DDLステートメントでは SOURCE 句を使用して設定します。

サポートされている Dictionary ソース

以下のソースタイプ (SOURCE_TYPE/source_type) を使用できます。 ソースタイプ ローカルファイル、実行可能ファイル、HTTP(s)、ClickHouse では、 オプション設定を使用できます。

カスタムクエリのカラム順序

ClickHouse、 MySQL、 PostgreSQL、 ODBC の各ソースでは query フィールドを指定できます。このフィールドを指定すると、 ClickHouse が通常 table と where から組み立てるクエリの代わりに、指定したクエリが使用されます。 辞書 は、クエリ結果のカラムが決まった順序で並んでいることを前提としています。この順序は、 CREATE DICTIONARY ステートメントで属性を記述した順序とは異なります。
  1. キー列 (PRIMARY KEY の順序)
  2. range_hashed または complex_key_range_hashed の辞書の場合は、range_min カラム、続いて range_max カラム
  3. 残りの属性 (宣言された順序)
ClickHouse ソースは列名に基づいて結果をこの順序に対応付けます。そのため、各カラムに値の格納先となる属性と同じ名前が付いていれば、 query のカラム順序は問題になりません。一方、 MySQL、PostgreSQL、ODBC の各ソースはカラムを位置に基づいて取得します。そのため、これらのソースでカラムの順序が上記と異なる query を使用すると、値が誤った属性に読み込まれます。関係する型によっては、 辞書の読み込みが変換エラーで失敗するか、誤った値が格納されてしまいます。 query は必ず上記の順序で記述してください。