Как начать работать с Managed Service for ClickHouse
Чтобы начать работу с сервисом:
Перед началом работы
-
Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.
-
Если у вас еще нет каталога, создайте его:
-
На странице облака нажмите кнопку Создать каталог.
-
Введите имя каталога. Требования к имени:
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
-
(опционально) Введите описание каталога.
-
Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.
-
Нажмите кнопку Создать.
-
-
Подключаться к кластерам БД можно как изнутри, так и извне Yandex Cloud:
- Чтобы подключиться изнутри Yandex Cloud, создайте виртуальную машину на основе Linux или Windows в той же сети, что и кластер БД.
- Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам при создании кластера.
Примечание
Следующие шаги предполагают, что подключение к кластеру производится с ВМ на основе Linux.
-
Подключитесь к виртуальной машине по SSH.
-
Подключите DEB-репозиторий ClickHouse:
sudo apt update && sudo apt install -y apt-transport-https ca-certificates dirmngr && \ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E0C56BD4 && \ echo "deb https://repo.clickhouse.com/deb/stable/ main/" | sudo tee \ /etc/apt/sources.list.d/clickhouse.list
-
Установите зависимости и клиентское приложение
clickhouse-client
:sudo apt update && sudo apt install -y clickhouse-client
-
Загрузите файл конфигурации для
clickhouse-client
:mkdir -p ~/.clickhouse-client && wget "https://storage.yandexcloud.net/mdb/clickhouse-client.conf.example" -O ~/.clickhouse-client/config.xml
Создайте кластер
- В консоли управления выберите каталог, в котором нужно создать кластер БД.
- Выберите сервис Managed Service for ClickHouse.
- Нажмите кнопку Создать кластер.
- Задайте параметры кластера и нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание ClickHouse-кластера.
- Когда кластер будет готов к работе, его статус на панели Managed Service for ClickHouse сменится на Running, а состояние — на Alive. Это может занять некоторое время.
Подключитесь к БД
-
Настройте группы безопасности для облачной сети так, чтобы был разрешен весь необходимый трафик между кластером и хостом, с которого выполняется подключение.
-
Для подключения к серверу БД получите SSL-сертификат:
-
Создайте каталог:
$ mkdir ~/.clickhouse
-
Получите сертификат:
$ wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" -O ~/.clickhouse/root.crt
-
Настройте права доступа к сертификату:
$ chmod 0600 ~/.clickhouse/root.crt
-
-
Используйте для подключения ClickHouse CLI:
- Укажите путь к SSL-сертификату в конфигурационном файле, в элементе
<caConfig>
:
<config> <openSSL> <client> <loadDefaultCAFile>true</loadDefaultCAFile> <caConfig>~/.clickhouse/root.crt</caConfig> <cacheSessions>true</cacheSessions> <disableProtocols>sslv2,sslv3</disableProtocols> <preferServerCiphers>true</preferServerCiphers> <invalidCertificateHandler> <name>RejectCertificateHandler</name> </invalidCertificateHandler> </client> </openSSL> </config>
- Запустите ClickHouse CLI со следующими параметрами:
clickhouse-client --host <FQDN хоста> \ -s \ --user <имя пользователя БД> \ --password <пароль пользователя БД> \ -q "<запрос к БД>" \ --port 9440
- Укажите путь к SSL-сертификату в конфигурационном файле, в элементе
Что дальше
- Изучите концепции сервиса.
- Узнайте подробнее о создании кластера и подключении к БД.
- Ознакомьтесь с вопросами и ответами.