ClickHouse/docs/zh/getting_started/install.md
Ivan Blinkov 387cbca505
Introduction refactoring + a bunch of docs fixes (#8010)
* Create SECURITY.md

* [experimental] auto-mark documentation PRs with labels

* revert #6544

* Sync RPM packages instructions to other docs languages

* Move tutorial to documentation with old content (for now)

* refactor installation guide a bit

* add ../en/getting_started/index.md

* Rename ya_metrica_task.md

* Rename ya_metrica_task.md

* Refactor Yandex.Metrica dataset description

* WIP on rewriting tutorial

* tmp commit

* lots of docs fixes

* partially revert c136bee4ce

* try to fix docs build in CI

* try to fix docs build in CI

* few minor improvements

* Quick refactoring of last portion of tutorial (not thoroughly tested though)

* fix link
2019-12-05 19:36:51 +03:00

4.5 KiB
Raw Blame History

系统要求

ClickHouse可以在任何具有x86_64AArch64或PowerPC64LE CPU架构的LinuxFreeBSD或Mac OS X上运行。

虽然预构建的二进制文件通常是为x86 \ _64编译并利用SSE 4.2指令集但除非另有说明否则使用支持它的CPU将成为额外的系统要求。这是检查当前CPU是否支持SSE 4.2的命令:

$ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"

要在不支持SSE 4.2或具有AArch64或PowerPC64LE体系结构的处理器上运行ClickHouse您应该通过源构建ClickHouse进行适当的配置调整。

##可用的安装选项

为Debian/Ubuntu安装

/etc/apt/sources.list (或创建/etc/apt/sources.list.d/clickhouse.list文件)中添加仓库:

deb http://repo.yandex.ru/clickhouse/deb/stable/ main/

如果你想使用最新的测试版本,请使用'testing'替换'stable'。

然后运行:

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

你也可以从这里手动下载安装包:https://repo.yandex.ru/clickhouse/deb/stable/main/

ClickHouse包含访问控制配置它们位于users.xml文件中(与'config.xml'同目录)。 默认情况下允许从任何地方使用默认的default用户无密码的访问ClickHouse。参考user/default/networks。 有关更多信息,请参考"Configuration files"部分。

###来自RPM包 {#from-rpm-packages}

Yandex ClickHouse团队建议使用官方预编译的rpm软件包用于CentOSRedHat和所有其他基于rpm的Linux发行版。

首先,您需要添加官方存储库:

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(建议您在测试环境中使用)。

然后运行这些命令以实际安装包:

sudo yum install clickhouse-server clickhouse-client

您也可以从此处手动下载和安装软件包:https://repo.yandex.ru/clickhouse/rpm/stable/x86_64

###来自Docker {#from-docker-image}

要在Docker中运行ClickHouse请遵循Docker Hub上的指南。那些图像使用官方的deb包。

使用源码安装

具体编译方式可以参考build.md。

你可以编译并安装它们。 你也可以直接使用而不进行安装。

Client: dbms/programs/clickhouse-client
Server: dbms/programs/clickhouse-server

在服务器中为数据创建如下目录:

/opt/clickhouse/data/default/
/opt/clickhouse/metadata/default/

(它们可以在server config中配置。) 为需要的用户运行chown

日志的路径可以在server config (src/dbms/programs/server/config.xml)中配置。

启动

可以运行如下命令在后台启动服务:

sudo service clickhouse-server start

可以在/var/log/clickhouse-server/目录中查看日志。

如果服务没有启动,请检查配置文件 /etc/clickhouse-server/config.xml

你也可以在控制台中直接启动服务:

clickhouse-server --config-file=/etc/clickhouse-server/config.xml

在这种情况下,日志将被打印到控制台中,这在开发过程中很方便。 如果配置文件在当前目录中,你可以不指定‘--config-file参数。它默认使用./config.xml

你可以使用命令行客户端连接到服务:

clickhouse-client

默认情况下它使用default用户无密码的与localhost:9000服务建立连接。 客户端也可以用于连接远程服务,例如:

clickhouse-client --host=example.com

有关更多信息,请参考"Command-line client"部分。

检查系统是否工作:

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.

:)

恭喜,系统已经工作了!

为了继续进行实验,你可以尝试下载测试数据集。

Original article