メインコンテンツまでスキップ
メインコンテンツまでスキップ

ClickHouseへのSQLデータの挿入とダンプ

ClickHouseは、様々な方法でOLTPデータベースインフラに簡単に統合できます。1つの方法は、他のデータベースとClickHouseの間でSQLダンプを使用してデータを転送することです。

SQLダンプの作成​

データは、SQLInsertを使用してSQL形式でダンプできます。ClickHouseは、INSERT INTO <table name> VALUES(... 形式でデータを書き込み、output_format_sql_insert_table_name設定オプションをテーブル名として使用します：

SET output_format_sql_insert_table_name = 'some_table';
SELECT * FROM some_data
INTO OUTFILE 'dump.sql'
FORMAT SQLInsert

カラム名は、output_format_sql_insert_include_column_namesオプションを無効にすることで省略できます：

SET output_format_sql_insert_include_column_names = 0

これで、dump.sqlファイルを別のOLTPデータベースに供給できます：

mysql some_db < dump.sql

some_db MySQLデータベースにsome_tableテーブルが存在することを前提としています。

一部のDBMSは、一度のバッチで処理できる値の数に制限がある場合があります。デフォルトでは、ClickHouseは65k値のバッチを作成しますが、これはoutput_format_sql_insert_max_batch_sizeオプションで変更可能です：

SET output_format_sql_insert_max_batch_size = 1000;

値のセットをエクスポートする​

ClickHouseには、Values形式があり、これはSQLInsertに似ていますが、INSERT INTO table VALUES部分を省略し、値のセットのみを返します：

SELECT * FROM some_data LIMIT 3 FORMAT Values

('Bangor_City_Forest','2015-07-01',34),('Alireza_Afzal','2017-02-01',24),('Akhaura-Laksam-Chittagong_Line','2015-09-01',30)

SQLダンプからデータを挿入する​

SQLダンプを読み込むために、MySQLDumpが使用されます：

SELECT *
FROM file('dump.sql', MySQLDump)
LIMIT 5

┌─path───────────────────────────┬──────month─┬─hits─┐
│ Bangor_City_Forest             │ 2015-07-01 │   34 │
│ Alireza_Afzal                  │ 2017-02-01 │   24 │
│ Akhaura-Laksam-Chittagong_Line │ 2015-09-01 │   30 │
│ 1973_National_500              │ 2017-10-01 │   80 │
│ Attachment                     │ 2017-09-01 │ 1356 │
└────────────────────────────────┴────────────┴──────┘

デフォルトでは、ClickHouseは不明なカラムをスキップします（これは、input_format_skip_unknown_fieldsオプションで制御されます）及びダンプ内の最初に見つかったテーブルについてデータを処理します（複数のテーブルが単一ファイルにダンプされた場合）。DDLステートメントはスキップされます。MySQLダンプからテーブルへのデータのロードは次のように行います（mysql.sqlファイル）：

INSERT INTO some_data
FROM INFILE 'mysql.sql' FORMAT MySQLDump

MySQLダンプファイルから自動的にテーブルを作成することもできます：

CREATE TABLE table_from_mysql
ENGINE = MergeTree
ORDER BY tuple() AS
SELECT *
FROM file('mysql.sql', MySQLDump)

ここでは、ClickHouseが自動的に推測した構造に基づいてtable_from_mysqlという名前のテーブルを作成しました。ClickHouseはデータに基づいて型を検出するか、DDLが利用可能な場合はそれを使用します：

DESCRIBE TABLE table_from_mysql;

┌─name──┬─type─────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ path  │ Nullable(String) │              │                    │         │                  │                │
│ month │ Nullable(Date32) │              │                    │         │                  │                │
│ hits  │ Nullable(UInt32) │              │                    │         │                  │                │
└───────┴──────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘

他の形式​

ClickHouseは、多様なシナリオやプラットフォームをカバーするために、多くの形式のサポートを導入しています。以下の文書で、さまざまな形式や、それらとの作業方法について詳しく探求してください：

また、clickhouse-localを確認してください - ClickHouseサーバーなしでローカル/リモートファイルで作業するためのポータブルなフル機能ツールです。