Как начать работать с Managed Service for ClickHouse
Совет
Новым клиентам Yandex Cloud доступен специальный стартовый грант на сервисы управляемых баз данных. Подробнее об условиях получения гранта см. в разделе Стартовый грант.
Чтобы начать работу с сервисом:
Перед началом работы
-
Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.
-
Если у вас еще нет каталога, создайте его:
-
В консоли управления выберите облако и нажмите кнопку
Создать каталог.
-
Введите имя каталога. Требования к имени:
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
-
(опционально) Введите описание каталога.
-
Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.
-
Нажмите кнопку Создать.
-
-
Подключаться к кластерам БД можно как изнутри, так и извне Yandex Cloud:
-
Чтобы подключиться изнутри Yandex Cloud, создайте виртуальную машину на основе Linux в той же сети, что и кластер БД.
-
Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам при создании кластера.
Примечание
Следующие шаги предполагают, что подключение к кластеру производится с ВМ на основе 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-сертификат:
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
. -
Используйте для подключения ClickHouse CLI:
-
Укажите путь к 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>
-
Запустите ClickHouse CLI со следующими параметрами:
clickhouse-client --host <FQDN любого хоста ClickHouse> \ --secure \ --user <имя пользователя> \ --database <имя БД> \ --port 9440 \ --ask-password
-
Что дальше
- Изучите концепции сервиса.
- Узнайте подробнее о создании кластера и подключении к БД.
- Ознакомьтесь с вопросами и ответами.