如果你不需要为生产环境安装 ClickHouse，最快的搭建方法是使用 ClickHouse CLI，或通过 curl 运行安装脚本。

ClickHouse CLI

ClickHouse CLI (clickhousectl) 可帮助你安装和管理本地 ClickHouse 版本、启动服务器以及执行查询。

安装 ClickHouse CLI

curl https://clickhouse.com/cli | sh

为方便使用，还会自动创建一个 chctl 别名。

安装 ClickHouse

clickhousectl local install stable

启动 clickhouse-server

clickhousectl local server start

服务器会在后台运行。要验证其是否正在运行：

clickhousectl local server list

启动 clickhouse-client

clickhousectl local client

你会看到类似下面的内容：

ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)

现在你已经可以开始向 ClickHouse 发送 SQL 命令了！

提示

快速开始 将逐步引导你完成创建表和插入数据。

Curl 脚本

通过 curl 脚本安装 ClickHouse

如果您不需要在生产环境中安装 ClickHouse，您可以使用 curl 运行安装脚本。该脚本会为您的操作系统选择合适的二进制文件。

使用 curl 安装 ClickHouse

运行以下命令，为您的操作系统下载单个二进制文件。

curl https://clickhouse.com/ | sh

在 Linux 和 macOS 上，这还会将 clickhousectl 安装到 ~/.local/bin 中 (并创建一个 chctl 符号链接) ，这样您就可以管理本地 ClickHouse 版本和服务器。如果 ~/.local/bin 尚未包含在您的 PATH 中，安装程序会输出需要添加到 shell profile 中的那一行。

若只安装 clickhouse 二进制文件而不安装 clickhousectl，请设置 CLICKHOUSE_ONLY=1：

curl https://clickhouse.com/ | CLICKHOUSE_ONLY=1 sh

注意

对于 Mac 用户：如果您收到“无法验证二进制文件开发者”的错误，请参阅此处。

启动 clickhouse-local

clickhouse-local 允许您使用 ClickHouse 强大的 SQL 语法处理本地和远程文件，且无需配置。表数据存储在临时位置，这意味着在重启 clickhouse-local 后，之前创建的表将不再可用。

运行以下命令启动 clickhouse-local:

./clickhouse

启动 clickhouse-server

如果您希望持久化数据，则需要运行 clickhouse-server。您可以使用以下命令启动 ClickHouse 服务器：

./clickhouse server

启动 clickhouse-client

服务器启动并运行后,打开新的终端窗口并运行以下命令以启动 clickhouse-client:

./clickhouse client

您将看到类似如下的输出:

./clickhouse client
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)

表数据存储在当前目录中,ClickHouse 服务器重启后数据仍然可用。如有必要,您可以将 -C config.xml 作为额外的命令行参数传递给 ./clickhouse server,并在配置文件中提供进一步的配置。所有可用的配置设置记录在此处以及示例配置文件模板中。

现在您可以开始向 ClickHouse 发送 SQL 命令了!

提示

快速入门将引导您完成创建表和插入数据的步骤。