Skip to main content
ClickHouse では、SELECT クエリとともに、クエリ処理に必要なデータをサーバーに送信できます。このデータは一時テーブルに格納され (“Temporary tables” セクションを参照) 、クエリ内で使用できます (たとえば IN 演算子で使用できます) 。 たとえば、重要なユーザー識別子を含むテキストファイルがある場合、そのリストでフィルタリングするクエリと一緒にサーバーへアップロードできます。 大量の外部データを使って複数のクエリを実行する必要がある場合は、この機能は使用しないでください。事前にデータを DB にアップロードしておくほうが適切です。 外部データは、コマンドラインクライアント (非対話型モード) または HTTP インターフェイスを使用してアップロードできます。 コマンドラインクライアントでは、次のフォーマットで parameters セクションを指定できます
このようなセクションが、転送されるテーブル数に応じて複数含まれる場合があります。 –external – 句の開始を示します。 –file – テーブルのダンプファイルへのパス、または stdin を指す - です。 stdin から取得できるテーブルは 1 つだけです。 次のパラメータは省略可能です: –name– テーブル名。省略した場合は _data が使用されます。 –format – ファイル内のデータのフォーマットです。省略した場合は TabSeparated が使用されます。 –scalar – 一時テーブルの代わりにデータを scalar として送信します。データには必ず 1 行だけ含まれている必要があります。複数のカラムが含まれる場合は、1 つの tuple にまとめられます。値には、クエリ内で __getScalar('name') を介してアクセスできます。 次のパラメータのいずれか 1 つが必須です:–types – カンマ区切りのカラム型のリスト。例: UInt64,String。カラム名は _1, _2, … になります。 –structure– UserID UInt64, URL String 形式のテーブル構造です。カラム名と型を定義します。 ‘file’ で指定されたファイルは、‘types’ または ‘structure’ で指定されたデータ型を使用して、‘format’ で指定されたフォーマットでパースされます。テーブルはサーバーにアップロードされ、そこで ‘name’ で指定した名前の一時テーブルとして利用できます。 例:
HTTP インターフェイスを使用する場合、外部データは multipart/form-data フォーマットで渡されます。各テーブルは、それぞれ個別のファイルとして送信されます。テーブル名はファイル名から取得されます。query_string には、name_format、name_types、name_structure というパラメータが渡されます。ここで、name はこれらのパラメータに対応するテーブル名です。これらのパラメータの意味は、コマンドラインクライアントを使用する場合と同じです。 例:
分散クエリ処理では、一時テーブルがすべてのリモートサーバーに送信されます。
最終更新日 2026年7月23日