2017-12-11 12:07:26 +00:00
# Начало работы
2017-07-04 12:53:50 +00:00
2017-12-11 12:07:26 +00:00
## Системные требования
2017-03-12 17:58:51 +00:00
2018-07-13 19:25:33 +00:00
Для установки из официального репозитория требуется О С Linux; архитектура x86_64 с поддержкой набора инструкций SSE 4.2.
2017-03-12 17:58:51 +00:00
Для проверки наличия SSE 4.2, выполните:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
grep -q sse4_2 /proc/cpuinfo & & echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
```
2017-03-12 17:58:51 +00:00
2018-07-13 19:25:33 +00:00
Рекомендуется использовать Ubuntu или Debian. Терминал должен работать в кодировке UTF-8.
Для rpm-based систем вы можете использовать 3rd-party пакеты: https://packagecloud.io/altinity/clickhouse либо установить debian пакеты.
ClickHouse также работает на FreeBSD и Mac OS X; может быть собран для процессоров x86_64 без поддержки SSE 4.2, и для процессоров AArch64.
2017-03-12 17:58:51 +00:00
2017-12-11 12:07:26 +00:00
## Установка
2017-03-12 17:58:51 +00:00
В целях тестирования и разработки, система может быть установлена на один сервер или на рабочий компьютер.
2018-06-29 12:07:07 +00:00
### Установка из пакетов для Debian/Ubuntu
2017-06-13 20:35:07 +00:00
2017-10-25 05:27:09 +00:00
Пропишите в `/etc/apt/sources.list` (или в отдельный файл `/etc/apt/sources.list.d/clickhouse.list` ) репозитории:
2017-05-08 05:06:04 +00:00
2018-10-16 10:47:17 +00:00
```
2018-03-13 19:45:15 +00:00
deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
2017-10-25 05:27:09 +00:00
```
2017-03-12 17:58:51 +00:00
2017-07-04 12:53:50 +00:00
Если вы хотите использовать наиболее свежую тестовую версию, замените stable на testing.
2017-03-12 17:58:51 +00:00
Затем выполните:
2017-06-13 20:35:07 +00:00
2017-10-25 05:27:09 +00:00
```bash
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv E0C56BD4 # optional
sudo apt-get update
2018-04-17 20:57:02 +00:00
sudo apt-get install clickhouse-client clickhouse-server
2017-10-25 05:27:09 +00:00
```
2017-07-04 12:53:50 +00:00
2018-03-13 19:45:15 +00:00
Также можно скачать и установить пакеты вручную, отсюда: < https: / / repo . yandex . ru / clickhouse / deb / stable / main / > .
2017-03-12 17:58:51 +00:00
ClickHouse содержит настройки ограничения доступа. Они расположены в файле users.xml (рядом с config.xml).
По умолчанию, разрешён доступ отовсюду для пользователя default без пароля. См. секцию users/default/networks.
Подробнее смотрите в разделе "конфигурационные файлы".
2017-10-25 05:27:09 +00:00
### Установка из исходников
2017-03-12 17:58:51 +00:00
Для сборки воспользуйтесь инструкцией: build.md
Вы можете собрать пакеты и установить их.
Также вы можете использовать программы без установки пакетов.
2017-06-13 20:35:07 +00:00
2018-10-16 10:47:17 +00:00
```
2018-06-05 20:09:51 +00:00
Client: dbms/programs/clickhouse-client
Server: dbms/programs/clickhouse-server
2017-10-25 05:27:09 +00:00
```
2017-03-12 17:58:51 +00:00
Для сервера создаёте директории с данными, например:
2017-06-13 20:35:07 +00:00
2018-10-16 10:47:17 +00:00
```
2017-10-25 05:27:09 +00:00
/opt/clickhouse/data/default/
/opt/clickhouse/metadata/default/
```
2017-07-04 12:53:50 +00:00
2017-03-12 17:58:51 +00:00
(Настраивается в конфиге сервера.)
Сделайте chown под нужного пользователя.
2018-06-05 20:09:51 +00:00
Обратите внимание на путь к логам в конфиге сервера (src/dbms/programs/server/config.xml).
2017-03-12 17:58:51 +00:00
2017-10-25 05:27:09 +00:00
### Другие методы установки
2017-03-12 17:58:51 +00:00
2017-10-25 05:27:09 +00:00
Docker образ: < https: / / hub . docker . com / r / yandex / clickhouse-server / >
2017-09-12 19:43:30 +00:00
2017-10-25 05:27:09 +00:00
RPM пакеты для CentOS, RHEL: < https: / / github . com / Altinity / clickhouse-rpm-install >
2017-03-12 17:58:51 +00:00
2018-06-29 12:07:07 +00:00
Gentoo: `emerge clickhouse`
2017-03-12 17:58:51 +00:00
2017-12-11 12:07:26 +00:00
## Запуск
2017-03-12 17:58:51 +00:00
Для запуска сервера (в качестве демона), выполните:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
sudo service clickhouse-server start
```
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
Смотрите логи в директории `/var/log/clickhouse-server/`
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
Если сервер не стартует - проверьте правильность конфигурации в файле `/etc/clickhouse-server/config.xml`
2017-03-12 17:58:51 +00:00
Также можно запустить сервер из консоли:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
clickhouse-server --config-file=/etc/clickhouse-server/config.xml
```
2017-07-04 12:53:50 +00:00
2017-03-12 17:58:51 +00:00
При этом, лог будет выводиться в консоль - удобно для разработки.
Если конфигурационный файл лежит в текущей директории, то указывать параметр --config-file не требуется - по умолчанию будет использован файл ./config.xml
Соединиться с сервером можно с помощью клиента командной строки:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
clickhouse-client
```
2017-03-12 17:58:51 +00:00
Параметры по умолчанию обозначают - соединяться с localhost:9000, от имени пользователя default без пароля.
Клиент может быть использован для соединения с удалённым сервером. Пример:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
clickhouse-client --host=example.com
```
2017-07-04 12:53:50 +00:00
2017-03-12 17:58:51 +00:00
Подробнее смотри раздел "Клиент командной строки".
Проверим работоспособность системы:
2017-05-08 05:06:04 +00:00
2017-10-25 05:27:09 +00:00
```bash
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.
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
:) SELECT 1
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
SELECT 1
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
┌─1─┐
│ 1 │
└───┘
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
1 rows in set. Elapsed: 0.003 sec.
2017-07-04 12:53:50 +00:00
2017-10-25 05:27:09 +00:00
:)
```
2017-03-12 17:58:51 +00:00
2017-06-20 14:19:03 +00:00
**Поздравляем, система работает!**
2018-03-13 19:45:15 +00:00
Для дальнейших экспериментов можно попробовать загрузить из тестовых наборов данных.
2018-10-16 10:47:17 +00:00
[Оригинальная статья ](https://clickhouse.yandex/docs/ru/getting_started/ ) <!--hide-->