注意事項

支持導入到云數據庫ClickHouse的常見文件格式為TabSeparated、TabSeparatedWithNames、TabSeparatedWithNamesAndTypes、CSV和CSVWithNames。常見文件格式說明，詳情請參見常見文件格式。若您的文件為其他格式，需滿足ClickHouse社區標準，更多信息請參見文件格式及說明。

前提條件

• 已將本地機器的IP地址添加到云數據庫ClickHouse的白名單中。如何添加白名單，詳情請參見設置白名單。

• 已安裝與云數據庫ClickHouse集群版本對應的clickhouse-client工具。下載鏈接，請參見clickhouse-client。

步驟一：準備測試數據

在clickhouse-client客戶端的安裝目錄下，創建文件testdata.csv并寫入如下數據。

1,yang,32,shanghai,http://example.com
2,wang,22,beijing,http://example.com
3,xiao,23,shenzhen,http://example.com
4,jess,45,hangzhou,http://example.com
5,jack,14,shanghai,http://example.com
6,tomy,25,hangzhou,http://example.com
7,lucy,45,shanghai,http://example.com
8,tengyin,26,shanghai,http://example.com
9,wangli,27,shenzhen,http://example.com
10,xiaohua,37,shanghai,http://example.com

步驟二：創建云數據庫ClickHouse表

1. 登錄云數據庫ClickHouse控制臺。

2. 在頁面左上角，選擇目標集群所在的地域。

3. 在集群列表頁面，根據您的集群類型選擇對應的頁簽，單擊目標集群ID。

4. 單擊右上方導航欄的登錄數據庫。

5. 在登錄實例頁面，輸入數據庫賬號和密碼，單擊登錄。

6. 創建表。

   說明

   云數據庫ClickHouse表的結構類型需與本地文件數據類型對應。

   • 創建本地表：

     • 如果您的集群是單副本版，請輸入如下建表語句。

       CREATE TABLE test_tbl_local ON cluster default
       (
       id UInt8,
       user_name String,
       age UInt16,
       city String,
       access_url String
       )
       ENGINE = MergeTree()
       ORDER BY id;

     • 如果您的集群是雙副本版，請輸入如下建表語句。

       CREATE TABLE test_tbl_local ON cluster default
       (
       id UInt8,
       user_name String,
       age UInt16,
       city String,
       access_url String
       )
       ENGINE = ReplicatedMergeTree('/clickhouse/tables/{database}/{table}/{shard}', '{replica}')
       order by id;

   • 創建分布式表。

     說明

     如果您只需要導入本地文件數據至本地表，可跳過此步驟。

     CREATE TABLE test_tbl_distributed ON cluster default
     (
     id UInt8,
     user_name String,
     age UInt16,
     city String,
     access_url String
     )
     ENGINE = Distributed(default, default, test_tbl_local, rand());

步驟三：導入本地文件數據

在clickhouse-client客戶端的安裝目錄下執行如下命令。

cat <本地文件名> | ./clickhouse-client --host=<數據庫連接地址> --port=<TCP端口號> --user=<數據庫賬號> --password=<數據庫賬號的密碼> --query="INSERT INTO <ClickHouse表名> FORMAT <本地文件格式>";

步驟四：查詢云數據庫ClickHouse表

1. 通過DMS連接集群，詳情請參見通過DMS連接ClickHouse。

2. 執行查詢語句。

   SELECT * FROM test_tbl_distributed; 

   說明

   如果您導入的是本地表，請將查詢語句中的分布式表名更換為本地表名，再進行查詢。

   查詢結果如下。

常見文件格式

云數據庫ClickHouse支持常見文件格式如下。

cat testdata.csv | ./clickhouse-client --format_csv_delimiter="|" --host=cc-bp163l724nkf8****.clickhouse.ads.aliyuncs.com --port=3306 --user=test --password=123456Aa --query="INSERT INTO test_tbl_distributed FORMAT CSV";