構文
Dictionary は、さまざまなソースを介して ClickHouse に接続できます。 ソースは、設定ファイルではsource セクションで設定し、DDLステートメントでは SOURCE 句を使用して設定します。
- DDL
- 設定ファイル
サポートされている Dictionary ソース
以下のソースタイプ (SOURCE_TYPE/source_type) を使用できます。
ソースタイプ ローカルファイル、実行可能ファイル、HTTP(s)、ClickHouse では、
オプション設定を使用できます。
- DDL
- 設定ファイル
カスタムクエリのカラム順序
ClickHouse、 MySQL、 PostgreSQL、 ODBC の各ソースではquery フィールドを指定できます。このフィールドを指定すると、
ClickHouse が通常 table と where から組み立てるクエリの代わりに、指定したクエリが使用されます。
辞書 は、クエリ結果のカラムが決まった順序で並んでいることを前提としています。この順序は、
CREATE DICTIONARY ステートメントで属性を記述した順序とは異なります。
- キー列 (
PRIMARY KEYの順序) range_hashedまたはcomplex_key_range_hashedの辞書の場合は、range_minカラム、続いてrange_maxカラム- 残りの属性 (宣言された順序)
query のカラム順序は問題になりません。一方、
MySQL、PostgreSQL、ODBC の各ソースはカラムを位置に基づいて取得します。そのため、これらのソースでカラムの順序が上記と異なる query を使用すると、値が誤った属性に読み込まれます。関係する型によっては、
辞書の読み込みが変換エラーで失敗するか、誤った値が格納されてしまいます。
query は必ず上記の順序で記述してください。