Подключиться
Yandex Managed Service for ClickHouse

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

Статья создана

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

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

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

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

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

    2. Введите имя каталога.

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

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

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

  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.tech/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

Что дальше

В этой статье: