Dictionary ソース

構文

ヒント

ClickHouse Cloud でディクショナリを使用している場合は、ディクショナリの作成に DDL クエリオプションを使用し、ユーザー default でディクショナリを作成してください。 また、Cloud 互換性ガイド でサポートされているディクショナリソースの一覧を確認してください。

Dictionary は、さまざまなソースを通じて ClickHouse に接続できます。 ソースは、設定ファイルでは source セクションで、DDL 文では SOURCE 句を使用して設定します。

DDL

CREATE DICTIONARY dict_name (...)
...
SOURCE(SOURCE_TYPE(param1 val1 ... paramN valN)) -- ソースの設定
...

Configuration file

<clickhouse>
  <dictionary>
    ...
    <source>
      <source_type>
        <!-- ソースの設定 -->
      </source_type>
    </source>
    ...
  </dictionary>
  ...
</clickhouse>

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

次のソースタイプ（SOURCE_TYPE/source_type）を利用できます。

• ローカルファイル
• 実行可能ファイル
• 実行可能プール
• HTTP(S)
• DBMS
  • ODBC
  • MySQL
  • ClickHouse
  • MongoDB
  • Redis
  • Cassandra
  • PostgreSQL
  • YTsaurus
• YAMLRegExpTree
• Null

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

DDL

SOURCE(FILE(path './user_files/os.tsv' format 'TabSeparated'))
--highlight-next-line
SETTINGS(format_csv_allow_single_quotes = 0)

Configuration file

<source>
  <file>
    <path>/opt/dictionaries/os.tsv</path>
    <format>TabSeparated</format>
  </file>
  <settings>
#highlight-next-line
      <format_csv_allow_single_quotes>0</format_csv_allow_single_quotes>
  </settings>
</source>