8623cb232c
* CLICKHOUSE-4063: less manual html @ index.md * CLICKHOUSE-4063: recommend markdown="1" in README.md * CLICKHOUSE-4003: manually purge custom.css for now * CLICKHOUSE-4064: expand <details> before any print (including to pdf) * CLICKHOUSE-3927: rearrange interfaces/formats.md a bit * CLICKHOUSE-3306: add few http headers * Remove copy-paste introduced in #3392 * Hopefully better chinese fonts #3392 * get rid of tabs @ custom.css * Apply comments and patch from #3384 * Add jdbc.md to ToC and some translation, though it still looks badly incomplete * minor punctuation * Add some backlinks to official website from mirrors that just blindly take markdown sources * Do not make fonts extra light * find . -name '*.md' -type f | xargs -I{} perl -pi -e 's//g' {} * find . -name '*.md' -type f | xargs -I{} perl -pi -e 's/ sql/g' {} * Remove outdated stuff from roadmap.md * Not so light font on front page too * Refactor Chinese formats.md to match recent changes in other languages
5.7 KiB
Начало работы
Системные требования
Для установки из официального репозитория требуется ОС Linux; архитектура x86_64 с поддержкой набора инструкций SSE 4.2.
Для проверки наличия SSE 4.2, выполните:
grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
Рекомендуется использовать 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.
Установка
В целях тестирования и разработки, система может быть установлена на один сервер или на рабочий компьютер.
Установка из пакетов для Debian/Ubuntu
Пропишите в /etc/apt/sources.list (или в отдельный файл /etc/apt/sources.list.d/clickhouse.list) репозитории:
deb http://repo.yandex.ru/clickhouse/deb/stable/ main/
Если вы хотите использовать наиболее свежую тестовую версию, замените stable на testing.
Затем выполните:
sudo apt-key adv --keyserver keyserver.ubuntu.com --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 без пароля. См. секцию users/default/networks. Подробнее смотрите в разделе "конфигурационные файлы".
Установка из исходников
Для сборки воспользуйтесь инструкцией: build.md
Вы можете собрать пакеты и установить их. Также вы можете использовать программы без установки пакетов.
Client: dbms/programs/clickhouse-client
Server: dbms/programs/clickhouse-server
Для сервера создаёте директории с данными, например:
/opt/clickhouse/data/default/
/opt/clickhouse/metadata/default/
(Настраивается в конфиге сервера.) Сделайте chown под нужного пользователя.
Обратите внимание на путь к логам в конфиге сервера (src/dbms/programs/server/config.xml).
Другие методы установки
Docker образ: https://hub.docker.com/r/yandex/clickhouse-server/
RPM пакеты для CentOS, RHEL: https://github.com/Altinity/clickhouse-rpm-install
Gentoo: emerge clickhouse
Запуск
Для запуска сервера (в качестве демона), выполните:
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
Параметры по умолчанию обозначают - соединяться с localhost:9000, от имени пользователя default без пароля. Клиент может быть использован для соединения с удалённым сервером. Пример:
clickhouse-client --host=example.com
Подробнее смотри раздел "Клиент командной строки".
Проверим работоспособность системы:
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.
:)
Поздравляем, система работает!
Для дальнейших экспериментов можно попробовать загрузить из тестовых наборов данных.