メインコンテンツへスキップ
入力出力エイリアス

説明

ClickHouse は MySQL のダンプの読み取りをサポートしています。 ダンプ 内では、単一のテーブルに属する INSERT クエリからすべてのデータを読み取ります。 テーブルが複数ある場合、デフォルトでは最初のテーブルのデータを読み取ります。
このフォーマットはスキーマ推論をサポートしています。ダンプ に指定したテーブルの CREATE クエリが含まれている場合は、そこから構造を推論し、含まれていない場合は INSERT クエリのデータからスキーマを推論します。

使用例

次の SQL ダンプファイルがあるとします。
dump.sql
/*!40101 SET @saved_cs_client     = @@character_set_client */;
/*!50503 SET character_set_client = utf8mb4 */;
CREATE TABLE `test` (
  `x` int DEFAULT NULL,
  `y` int DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
/*!40101 SET character_set_client = @saved_cs_client */;
INSERT INTO `test` VALUES (1,NULL),(2,NULL),(3,NULL),(3,NULL),(4,NULL),(5,NULL),(6,7);
/*!40101 SET @saved_cs_client     = @@character_set_client */;
/*!50503 SET character_set_client = utf8mb4 */;
CREATE TABLE `test 3` (
  `y` int DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
/*!40101 SET character_set_client = @saved_cs_client */;
INSERT INTO `test 3` VALUES (1);
/*!40101 SET @saved_cs_client     = @@character_set_client */;
/*!50503 SET character_set_client = utf8mb4 */;
CREATE TABLE `test2` (
  `x` int DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
/*!40101 SET character_set_client = @saved_cs_client */;
INSERT INTO `test2` VALUES (1),(2),(3);
次のクエリを実行できます。
Query
DESCRIBE TABLE file(dump.sql, MySQLDump) 
SETTINGS input_format_mysql_dump_table_name = 'test2'
Response
┌─name─┬─type────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ x    │ Nullable(Int32) │              │                    │         │                  │                │
└──────┴─────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
Query
SELECT *
FROM file(dump.sql, MySQLDump)
SETTINGS input_format_mysql_dump_table_name = 'test2'
Response
┌─x─┐
│ 1 │
│ 2 │
│ 3 │
└───┘

フォーマット設定

input_format_mysql_dump_table_name 設定を使用すると、データの読み取り元となるテーブル名を指定できます。 input_format_mysql_dump_map_columns1 に設定し、ダンプ に指定したテーブルに対する CREATE クエリ、または INSERT クエリ内のカラム名が含まれている場合、入力データのカラムは名前に基づいてテーブルのカラムにマッピングされます。 名前が不明なカラムは、input_format_skip_unknown_fields1 に設定されている場合はスキップされます。
最終更新日 2026年6月10日