Windows 用户ClickHouse 可在 Linux 和 macOS 上原生运行。在 Windows 上,请在
Windows Subsystem for Linux (WSL) 中执行以下步骤。
clickhousectl,别名 chctl) 可用于安装和管理本地
ClickHouse 版本、运行本地 ClickHouse 和 Postgres 服务器、执行查询,
以及管理 ClickHouse Cloud。本页将指导您安装该命令行客户端、
启动本地 ClickHouse 服务器并进行连接。
如果您已使用快速安装
脚本,则 clickhousectl 已安装完毕,可直接跳至
安装 ClickHouse。
1
安装 ClickHouse 命令行客户端
该安装脚本支持 x86_64 和 ARM64 架构的 macOS 与 Linux 系统:该脚本会将
如需检查命令行客户端是否有更新的发行版并进行安装:
clickhousectl 安装到 ~/.local/bin,并在同一目录下创建别名 chctl。
如果脚本提示 ~/.local/bin 不在你的 PATH 中,请将其添加到 PATH,
同时将同样的配置行写入你的 shell 配置文件 (~/.bashrc、~/.zshrc) ,使其在之后的
会话中也能生效:其他安装方法
其他安装方法
只有安装脚本和 npm 会创建
chctl 别名。2
安装 ClickHouse
安装最新版本的 ClickHouse,并将其设为默认版本:要查看哪些次版本可供下载,以及您已安装了哪些版本,请执行:
local use 会在该版本尚未安装时自动安装,将其设为默认版本,并在 ~/.local/bin 中创建 clickhouse 符号链接,这样你就可以直接运行 clickhouse 二进制文件。只要 ~/.local/bin 已加入 PATH,本文档后续所有运行
clickhouse 命令的步骤都可以直接照做,无需修改。你也可以选择最新的长期支持 (LTS) 发行版,或指定某个特定
版本:use 与 install 的区别
clickhousectl local use <version> 会安装指定版本,并将其设为默认版本,同时更新
clickhouse 符号链接。clickhousectl local install <version>
则仅下载指定版本:只有在尚未设置默认版本时,它才会成为默认版本,
且不会更新符号链接。如需仅设置默认版本,而不创建或
更新符号链接,请使用 clickhousectl local use <version> --no-global。3
启动 clickhouse-server
clickhousectl 会将本地服务器的作用域限定在其运行时所在的目录中。请先创建一个
项目目录,然后在该目录中启动服务器:default。其数据存放在
./.clickhouse/ 中,因此后续的 clickhousectl local 命令需在同一
目录下运行;clickhousectl 不会搜索上级目录。服务器默认监听
HTTP 端口 8123 和 TCP 端口 9000;若这些端口已被占用,则改用空闲端口。
如需指定端口,请传入 --http-port 和 --tcp-port。如需运行多个
服务器,请为每个服务器指定名称,例如 clickhousectl local server start dev。验证服务器是否正在运行:4
启动 ClickHouse 客户端
在同一目录下,使用 现在可以开始向 ClickHouse 发送 SQL 命令了!输入
clickhouse-client 连接到服务器:local client 会连接到名为 default 的服务器,并使用与该服务器相同的
ClickHouse 版本。如需连接其他服务器,请传入服务器名称,
例如 clickhousectl local client dev。您将看到类似以下的输出:exit 即可
退出客户端。如果只想运行单个查询而不进入交互式会话,请传入 -q 参数:5
停止服务器
服务器会一直在后台运行,直到您手动停止。请在
同一目录下执行以下命令停止服务器:停止服务器后,其数据会被保留,供下次执行
clickhousectl local server start 时使用。后续步骤
-
在本地运行 Postgres。 确保 Docker 正在运行,然后启动本地 Postgres 服务器,
并使用
psql连接: -
连接到 ClickHouse Cloud。 注册新账户,或登录现有账户。
通过浏览器登录仅具有只读权限;如需创建或修改 Cloud 资源,则需要使用
API key,运行
clickhousectl cloud auth login --interactive时会提示您输入。 -
进一步了解命令行客户端。 请参阅 clickhousectl 参考文档,
或运行
clickhousectl --help。