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

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

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

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

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

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

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

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

    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-сертификат:

    mkdir --parents /usr/local/share/ca-certificates/Yandex/ && \
wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
    --output-document /usr/local/share/ca-certificates/Yandex/YandexCA.crt && \
chmod 655 /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

Что дальше

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