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

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

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

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

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

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

   1. В консоли управления выберите облако и нажмите кнопку Создать каталог.

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

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

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

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

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

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

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

   • Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам при создании кластера.

   Примечание

   Следующие шаги предполагают, что подключение к кластеру производится с ВМ на основе 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-сертификат:

   sudo mkdir --parents /usr/local/share/ca-certificates/Yandex/ && \
   sudo wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
       --output-document /usr/local/share/ca-certificates/Yandex/YandexCA.crt && \
   sudo chmod 655 /usr/local/share/ca-certificates/Yandex/YandexCA.crt
   

   Сертификат будет сохранен в файле /usr/local/share/ca-certificates/Yandex/YandexCA.crt.

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

   1. Укажите путь к SSL-сертификату в конфигурационном файле, в элементе <caConfig>:

      <config>
        <openSSL>
          <client>
            <loadDefaultCAFile>true</loadDefaultCAFile>
            <caConfig>/usr/local/share/ca-certificates/Yandex/YandexCA.crt</caConfig>
            <cacheSessions>true</cacheSessions>
            <disableProtocols>sslv2,sslv3</disableProtocols>
            <preferServerCiphers>true</preferServerCiphers>
            <invalidCertificateHandler>
              <name>RejectCertificateHandler</name>
            </invalidCertificateHandler>
          </client>
        </openSSL>
      </config>
      

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

      clickhouse-client --host <FQDN любого хоста ClickHouse> \
                        --secure \
                        --user <имя пользователя> \
                        --database <имя БД> \
                        --port 9440 \
                        --ask-password
      

Что дальше

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