Skip to main content
所有快速入门
实时分析数据仓储可观测性AI/MLCloud

前置条件

你还应完成以下快速入门:

你将构建的内容

在本快速入门中,你将使用 clickhouse-client (官方的 ClickHouse 命令行客户端) ,将本地 CSV file 中的数据插入到 ClickHouse Cloud 服务中。 你将安装 clickhouse-client,准备一个样本数据集,连接到你的 Cloud 服务,创建一张表,并从本地机器插入数据。 完成后,你将了解如何使用 clickhouse-client 将本地文件加载到 ClickHouse Cloud;这一工作流适用于 CSV、Parquet、JSON 以及许多其他格式。
1

安装 clickhouse-client

clickhouse-client 是连接 ClickHouse 的官方 CLI,包含在 ClickHouse 二进制可执行文件中。使用通用安装程序进行安装:
这会将最新的 clickhouse 可执行文件下载到当前目录。验证安装是否成功:
你应该会看到显示 ClickHouse 版本号的输出,这表明 clickhouse-client 已可使用。
2

准备一个样例 CSV 文件

创建一个小型样例 CSV 文件,以便本快速入门内容完整,可独立完成。请在终端中运行以下命令:
3

连接到你的 Cloud 服务

以下命令假定你已按照获取你的 Cloud 连接信息快速入门中的说明,将 CLICKHOUSE_HOSTCLICKHOUSE_USERCLICKHOUSE_PASSWORD 导出为环境变量。如果还没有,你也可以直接替换为你自己的值。通过对你的 Cloud 服务运行一个简单查询来测试连通性:
如果连接成功,终端会输出 1。如果出现连接错误,请检查你的服务是否已在 Cloud 控制台中启动,以及主机名和密码是否正确。
端口 9440 是 ClickHouse Cloud 的安全原生协议端口。--secure 标志用于启用 TLS 加密。所有 Cloud 连接都必须使用这些设置。
4

创建目标表并插入数据

首先,在您的 Cloud 服务中创建一个用于接收这些数据的表:
现在插入本地 CSV 文件中的数据。这是关键一步——clickhouse-client 会从 stdin 读取该文件,并将其流式发送到远程服务:
clickhouse-client 会将 CSV 文件内容直接发送到你的 Cloud 服务。CSVWithNames 格式会告知 ClickHouse,第一行包含列名。
5

验证数据是否已插入

查询您的 Cloud 服务,确认这些行已写入:
你应该会看到 10,即示例 CSV 中的行数。预览数据:
同样的工作流也适用于 Parquet、TSV、JSON、Avro、ORC 以及许多其他支持的格式——只需更改 FORMAT 子句,并将相应文件通过管道传入即可。

后续步骤

在本快速入门中,你安装了 clickhouse-client,将其连接到 ClickHouse Cloud 服务,并使用它将本地 CSV 文件中的数据流式传输到 Cloud。对于 Parquet、JSON 以及其他数十种格式,这种方法同样适用。 接下来请查看以下快速入门: 或者查阅参考文档,进一步了解:
ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level

Check out the ClickHouse academy for on-demand and live training

Last modified on June 19, 2026