Help wanted!

The following content of this documentation page has been machine-translated. But unlike other websites, it is not done on the fly. This translated text lives on GitHub repository alongside main ClickHouse codebase and waits for fellow native speakers to make it more human-readable. You can also use the original English version as a reference.

Help ClickHouse documentation by editing this page

辞書の更新

ClickHouseは定期的に辞書を更新します。完全にダウンロードされた辞書の更新間隔と、キャッシュされた辞書の無効化間隔は、 <lifetime> 秒単位のタグ。

辞書の更新(最初の使用のための読み込み以外)は、クエリをブロックしません。更新時には、古いバージョンの辞書が使用されます。更新中にエラーが発生すると、エラーはサーバーログに書き込まれ、クエリは古いバージョンの辞書を使用し続けます。

設定例:

<dictionary>
    ...
    <lifetime>300</lifetime>
    ...
</dictionary>

CREATE DICTIONARY (...)
...
LIFETIME(300)
...

設定 <lifetime>0</lifetime> (LIFETIME(0))辞書の更新を防ぎます。

しかしながら、セッションの時間間隔のアップグレード、ClickHouseを選定しランダム均一に時間以内であることが判明した。これは、多数のサーバーでアップグレードするときに辞書ソースの負荷を分散するために必要です。

設定例:

<dictionary>
    ...
    <lifetime>
        <min>300</min>
        <max>360</max>
    </lifetime>
    ...
</dictionary>

または

LIFETIME(MIN 300 MAX 360)

もし <min>0</min> と <max>0</max>,ClickHouseはタイムアウトによって辞書をリロードしません。
この場合、clickhouseは辞書設定ファイルが変更された場合、または SYSTEM RELOAD DICTIONARY コマンドが実行された。

ップする場合には辞書にClickHouseサーバーに適用の異なるロジックの種類によってソース:

テキストファイルの場合、変更の時刻をチェックします。時刻が以前に記録された時刻と異なる場合、辞書が更新されます。
MyISAMテーブルの場合、変更時刻は SHOW TABLE STATUS クエリ。
他のソースからの辞書は、デフォルトで毎回updatedされます。

MySQL(InnoDB)、ODBC、およびClickHouseソースでは、毎回ではなく、実際に変更された場合にのみ辞書を更新するクエリを設定できます。これを行うには、次の手順に従います:

辞書テーブルには、ソースデータの更新時に常に変更されるフィールドが必要です。
ソースの設定では、変更フィールドを取得するクエリを指定する必要があります。 ClickHouseサーバーは、クエリ結果を行として解釈し、この行が以前の状態に対して相対的に変更された場合、辞書が更新されます。のクエリを指定します。 <invalidate_query> の設定のフィールドソース.

設定例:

<dictionary>
    ...
    <odbc>
      ...
      <invalidate_query>SELECT update_time FROM dictionary_source where id = 1</invalidate_query>
    </odbc>
    ...
</dictionary>

または

...
SOURCE(ODBC(... invalidate_query 'SELECT update_time FROM dictionary_source where id = 1'))
...

元の記事