2020-03-20 18:20:59 +00:00
|
|
|
|
## 系统要求 {#xi-tong-yao-qiu}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
ClickHouse可以在任何具有x86\_64,AArch64或PowerPC64LE CPU架构的Linux,FreeBSD或Mac OS X上运行。
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
虽然预构建的二进制文件通常是为x86 \_64编译并利用SSE 4.2指令集,但除非另有说明,否则使用支持它的CPU将成为额外的系统要求。这是检查当前CPU是否支持SSE 4.2的命令:
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
``` bash
|
|
|
|
|
$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
要在不支持SSE 4.2或具有AArch64或PowerPC64LE体系结构的处理器上运行ClickHouse,您应该[通过源构建ClickHouse](#from-sources)进行适当的配置调整。
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
## 可用的安装选项 {#ke-yong-de-an-zhuang-xuan-xiang}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
2020-02-03 14:10:45 +00:00
|
|
|
|
<a name="install-from-deb-packages"></a>
|
2020-03-20 18:20:59 +00:00
|
|
|
|
\#\#\# 为Debian/Ubuntu安装 {\#from-deb-packages}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
在`/etc/apt/sources.list` (或创建`/etc/apt/sources.list.d/clickhouse.list`文件)中添加仓库:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` text
|
2019-12-05 16:36:51 +00:00
|
|
|
|
deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
如果你想使用最新的测试版本,请使用’testing’替换’stable’。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
然后运行:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
sudo apt-get install dirmngr # optional
|
|
|
|
|
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4 # optional
|
|
|
|
|
sudo apt-get update
|
|
|
|
|
sudo apt-get install clickhouse-client clickhouse-server
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
你也可以从这里手动下载安装包:https://repo.yandex.ru/clickhouse/deb/stable/main/。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
ClickHouse包含访问控制配置,它们位于`users.xml`文件中(与’config.xml’同目录)。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
默认情况下,允许从任何地方使用默认的‘default’用户无密码的访问ClickHouse。参考‘user/default/networks’。
|
2020-03-20 18:20:59 +00:00
|
|
|
|
有关更多信息,请参考«Configuration files»部分。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
### 来自RPM包 {#from-rpm-packages}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
Yandex ClickHouse团队建议使用官方预编译的`rpm`软件包,用于CentOS,RedHat和所有其他基于rpm的Linux发行版。
|
|
|
|
|
|
|
|
|
|
首先,您需要添加官方存储库:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
sudo yum install yum-utils
|
|
|
|
|
sudo rpm --import https://repo.yandex.ru/clickhouse/CLICKHOUSE-KEY.GPG
|
|
|
|
|
sudo yum-config-manager --add-repo https://repo.yandex.ru/clickhouse/rpm/stable/x86_64
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
如果您想使用最新版本,请将`stable`替换为`testing`(建议您在测试环境中使用)。
|
|
|
|
|
|
|
|
|
|
然后运行这些命令以实际安装包:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
sudo yum install clickhouse-server clickhouse-client
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
您也可以从此处手动下载和安装软件包:https://repo.yandex.ru/clickhouse/rpm/stable/x86\_64。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
### 来自Docker {#from-docker-image}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
要在Docker中运行ClickHouse,请遵循[Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/)上的指南。那些图像使用官方的`deb`包。
|
|
|
|
|
|
|
|
|
|
### 使用源码安装 {#from-sources}
|
|
|
|
|
|
|
|
|
|
具体编译方式可以参考build.md。
|
|
|
|
|
|
|
|
|
|
你可以编译并安装它们。
|
|
|
|
|
你也可以直接使用而不进行安装。
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` text
|
2019-12-05 16:36:51 +00:00
|
|
|
|
Client: dbms/programs/clickhouse-client
|
|
|
|
|
Server: dbms/programs/clickhouse-server
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
在服务器中为数据创建如下目录:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` text
|
2019-12-05 16:36:51 +00:00
|
|
|
|
/opt/clickhouse/data/default/
|
|
|
|
|
/opt/clickhouse/metadata/default/
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
(它们可以在server config中配置。)
|
|
|
|
|
为需要的用户运行‘chown’
|
|
|
|
|
|
|
|
|
|
日志的路径可以在server config (src/dbms/programs/server/config.xml)中配置。
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
## 启动 {#qi-dong}
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
可以运行如下命令在后台启动服务:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
sudo service clickhouse-server start
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
可以在`/var/log/clickhouse-server/`目录中查看日志。
|
|
|
|
|
|
|
|
|
|
如果服务没有启动,请检查配置文件 `/etc/clickhouse-server/config.xml`。
|
|
|
|
|
|
|
|
|
|
你也可以在控制台中直接启动服务:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
clickhouse-server --config-file=/etc/clickhouse-server/config.xml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
在这种情况下,日志将被打印到控制台中,这在开发过程中很方便。
|
2020-03-20 18:20:59 +00:00
|
|
|
|
如果配置文件在当前目录中,你可以不指定‘–config-file’参数。它默认使用‘./config.xml’。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
你可以使用命令行客户端连接到服务:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
clickhouse-client
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
默认情况下它使用‘default’用户无密码的与localhost:9000服务建立连接。
|
|
|
|
|
客户端也可以用于连接远程服务,例如:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
clickhouse-client --host=example.com
|
|
|
|
|
```
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
有关更多信息,请参考«Command-line client»部分。
|
2019-12-05 16:36:51 +00:00
|
|
|
|
|
|
|
|
|
检查系统是否工作:
|
|
|
|
|
|
2020-03-20 18:20:59 +00:00
|
|
|
|
``` bash
|
2019-12-05 16:36:51 +00:00
|
|
|
|
milovidov@hostname:~/work/metrica/src/dbms/src/Client$ ./clickhouse-client
|
|
|
|
|
ClickHouse client version 0.0.18749.
|
|
|
|
|
Connecting to localhost:9000.
|
|
|
|
|
Connected to ClickHouse server version 0.0.18749.
|
|
|
|
|
|
|
|
|
|
:) SELECT 1
|
|
|
|
|
|
|
|
|
|
SELECT 1
|
|
|
|
|
|
|
|
|
|
┌─1─┐
|
|
|
|
|
│ 1 │
|
|
|
|
|
└───┘
|
|
|
|
|
|
|
|
|
|
1 rows in set. Elapsed: 0.003 sec.
|
|
|
|
|
|
|
|
|
|
:)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**恭喜,系统已经工作了!**
|
|
|
|
|
|
|
|
|
|
为了继续进行实验,你可以尝试下载测试数据集。
|
|
|
|
|
|
2020-01-30 10:34:55 +00:00
|
|
|
|
[Original article](https://clickhouse.tech/docs/en/getting_started/install/) <!--hide-->
|