Как начать работать с Managed Service for ClickHouse

Чтобы начать работу с сервисом:

• Создайте кластер БД.
• Подключитесь к БД.

Перед началом работы

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.

2. Если у вас еще нет каталога, создайте его:

   1. На странице облака нажмите кнопку Создать каталог.

   2. Введите имя каталога. Требования к имени:

      • Длина — от 3 до 63 символов.
      • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
      • Первый символ — буква. Последний символ — не дефис.

   3. (опционально) Введите описание каталога.

   4. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

   5. Нажмите кнопку Создать.

3. Подключаться к кластерам БД можно как изнутри, так и извне Yandex Cloud:

   • Чтобы подключиться изнутри Yandex Cloud, создайте виртуальную машину на основе Linux или Windows в той же сети, что и кластер БД.
   • Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам при создании кластера.

   Примечание

   Следующие шаги предполагают, что подключение к кластеру производится с ВМ на основе Linux.

4. Подключитесь к виртуальной машине по SSH.

5. Подключите 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
   

6. Установите зависимости и клиентское приложение clickhouse-client:

   sudo apt update && sudo apt install -y clickhouse-client
   

7. Загрузите файл конфигурации для clickhouse-client:

   mkdir -p ~/.clickhouse-client && wget "https://storage.yandexcloud.net/mdb/clickhouse-client.conf.example" -O ~/.clickhouse-client/config.xml
   

Создайте кластер

1. В консоли управления выберите каталог, в котором нужно создать кластер БД.
2. Выберите сервис Managed Service for ClickHouse.
3. Нажмите кнопку Создать кластер.
4. Задайте параметры кластера и нажмите кнопку Создать кластер. Процесс подробно рассмотрен в разделе Создание ClickHouse-кластера.
5. Когда кластер будет готов к работе, его статус на панели Managed Service for ClickHouse сменится на Running, а состояние — на Alive. Это может занять некоторое время.

Подключитесь к БД

1. Настройте группы безопасности для облачной сети так, чтобы был разрешен весь необходимый трафик между кластером и хостом, с которого выполняется подключение.

2. Для подключения к серверу БД получите SSL-сертификат:

   1. Создайте каталог:

      $ mkdir ~/.clickhouse
      

   2. Получите сертификат:

      $ wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" -O ~/.clickhouse/root.crt
      

   3. Настройте права доступа к сертификату:

      $ chmod 0600 ~/.clickhouse/root.crt
      

3. Используйте для подключения ClickHouse CLI:

   1. Укажите путь к 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>
   

   1. Запустите ClickHouse CLI со следующими параметрами:

   clickhouse-client --host <FQDN хоста> \
                     -s \
                     --user <имя пользователя БД> \
                     --password <пароль пользователя БД> \
                     -q "<запрос к БД>" \
                     --port 9440
   

Что дальше

• Изучите концепции сервиса.
• Узнайте подробнее о создании кластера и подключении к БД.
• Ознакомьтесь с вопросами и ответами.