[Документация Yandex Cloud](../index.md) > [Yandex Managed Service for ClickHouse®](index.md) > Начало работы

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




@[youtube](qdaGELCN8fs)

[Смотреть видео в Yandex Cloud Video](https://runtime.strm.yandex.ru/player/episode/vpleqgrv2vfmu7sbwkge?autoplay=0&mute=0).



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


* [Создайте кластер базы данных](#cluster-create).
* [Подключитесь к БД](#connect).



{% note info %}

О том, как создать кластер ClickHouse®, подключиться к нему и выполнять простые запросы, вы также можете узнать из урока [«Установка, базовая настройка, управление сервером»](https://practicum.yandex.ru/introduction/?slug=ycloud-clickhouse&platform=desktop&lang=ru) в обучающем курсе по Managed Service for ClickHouse®.

{% endnote %}



## Перед началом работы {#before-you-begin}

1. Перейдите в [консоль управления](https://kz.console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.
1. Если у вас еще нет [каталога](../resource-manager/concepts/resources-hierarchy.md#folder), создайте его:

   1. В [консоли управления](https://kz.console.yandex.cloud) на панели сверху нажмите ![image](../_assets/console-icons/layout-side-content-left.svg) или ![image](../_assets/console-icons/chevron-down.svg) и выберите нужное [облако](../resource-manager/concepts/resources-hierarchy.md#cloud).
   1. Справа от названия облака нажмите ![image](../_assets/console-icons/ellipsis.svg).
   1. Выберите ![image](../_assets/console-icons/plus.svg) **Создать каталог**.
   
      ![create-folder1](../_assets/resource-manager/create-folder-1.png)
   
   1. Введите имя [каталога](../resource-manager/concepts/resources-hierarchy.md#folder). Требования к имени:
   
       * длина — от 3 до 63 символов;
       * может содержать строчные буквы латинского алфавита, цифры и дефисы;
       * первый символ — буква, последний — не дефис.
   
   1. (Опционально) Введите описание каталога.
   1. Выберите опцию **Создать сеть по умолчанию**. Будет создана [сеть](../vpc/concepts/network.md#network) с подсетями в каждой зоне доступности. Также в этой сети будет создана [группа безопасности по умолчанию](../vpc/concepts/security-groups.md#default-security-group), внутри которой весь сетевой трафик разрешен.
   1. Нажмите кнопку **Создать**.
   
      ![create-folder2](../_assets/resource-manager/create-folder-2.png)

1. [Назначьте](../iam/operations/roles/grant.md) вашему аккаунту в Yandex Cloud роли:

   * [managed-clickhouse.editor](security.md#managed-clickhouse-editor) или выше — чтобы создать кластер;
   * [vpc.user](../vpc/security/index.md#vpc-user) — чтобы работать с [сетью](../vpc/concepts/network.md#network) кластера;
   * [mdb.viewer](../iam/roles-reference.md#mdb-viewer) — чтобы просматривать кластеры управляемых баз данных (MDB) на дашборде в [консоли управления](https://kz.console.yandex.cloud).

   Для привязки сервисного аккаунта к кластеру (например, для [работы с Yandex Object Storage](operations/s3-access.md)) вашему аккаунту дополнительно нужна роль [iam.serviceAccounts.user](../iam/security/index.md#iam-serviceAccounts-user) или выше.

   {% note info %}
   
   Если вы не можете управлять ролями, обратитесь к администратору вашего облака или организации.
   
   {% endnote %}

1. Подключаться к [кластерам](concepts/index.md) БД можно изнутри и извне Yandex Cloud:
   * Чтобы подключиться изнутри Yandex Cloud, создайте [виртуальную машину](../compute/concepts/vm.md) на основе [Linux](../compute/quickstart/quick-create-linux.md) в той же [сети](../vpc/concepts/network.md#network), что и кластер БД.
   * Чтобы подключиться к кластеру из интернета, запросите публичный доступ к хостам при создании кластера.

   {% note info %}

   Следующие шаги предполагают, что подключение к кластеру производится с ВМ на основе [Linux](../compute/quickstart/quick-create-linux.md).

   {% endnote %}

1. [Подключитесь](../compute/operations/vm-connect/ssh.md) к ВМ по [SSH](../glossary/ssh-keygen.md).
1. Подключите [DEB-репозиторий](https://clickhouse.com/docs/ru/install#install-from-deb-packages) ClickHouse®:

   ```bash
   sudo apt update && sudo apt install --yes apt-transport-https ca-certificates dirmngr && \
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD******** && \
   echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
   /etc/apt/sources.list.d/clickhouse.list
   ```

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

   ```bash
   sudo apt update && sudo apt install --yes clickhouse-client
   ```

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

   ```bash
   mkdir -p ~/.clickhouse-client && \
   wget "https://storage.yandexcloud.net/doc-files/clickhouse-client.conf.example" \
     --output-document ~/.clickhouse-client/config.xml
   ```


## Создайте кластер {#cluster-create}

1. В консоли управления выберите каталог, в котором нужно создать кластер БД.
1. Перейдите в сервис **Managed Service for ClickHouse**.
1. Нажмите кнопку **Создать кластер**.
1. Задайте параметры кластера и нажмите кнопку **Создать кластер**. Процесс подробно рассмотрен в разделе [Создание кластера](operations/cluster-create.md).
1. Дождитесь, когда кластер будет готов к работе: его статус на панели Managed Service for ClickHouse® сменится на **Running**, а состояние — на **Alive**. Это может занять некоторое время.


## Подключитесь к БД {#connect}

1. Если вы используете [группы безопасности](../vpc/concepts/security-groups.md) для облачной сети, [настройте их](operations/connect/index.md#configuring-security-groups) так, чтобы был разрешен весь необходимый трафик между кластером и хостом, с которого выполняется подключение.

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

   {% list tabs group=operating_system %}
   
   - Linux (Bash) {#linux}
   
      ```bash
      sudo mkdir --parents /usr/local/share/ca-certificates/Yandex/ && \
      sudo wget "https://storage.yandexcloud.kz/cloud-certs/RootCA.pem" \
           --output-document /usr/local/share/ca-certificates/Yandex/RootCA.crt && \
      sudo wget "https://storage.yandexcloud.kz/cloud-certs/IntermediateCA.pem" \
           --output-document /usr/local/share/ca-certificates/Yandex/IntermediateCA.crt && \
      sudo chmod 655 \
           /usr/local/share/ca-certificates/Yandex/RootCA.crt \
           /usr/local/share/ca-certificates/Yandex/IntermediateCA.crt && \
      sudo update-ca-certificates
      ```
   
      Сертификаты будут сохранены в файлах:
   
      * `/usr/local/share/ca-certificates/Yandex/RootCA.crt`
      * `/usr/local/share/ca-certificates/Yandex/IntermediateCA.crt`
   
   - macOS (Zsh) {#macos}
   
      ```bash
      sudo mkdir -p /usr/local/share/ca-certificates/Yandex/ && \
      sudo wget "https://storage.yandexcloud.kz/cloud-certs/RootCA.pem" \
           --output-document /usr/local/share/ca-certificates/Yandex/RootCA.crt && \
      sudo wget "https://storage.yandexcloud.kz/cloud-certs/IntermediateCA.pem" \
           --output-document /usr/local/share/ca-certificates/Yandex/IntermediateCA.crt && \
      sudo chmod 655 \
           /usr/local/share/ca-certificates/Yandex/RootCA.crt \
           /usr/local/share/ca-certificates/Yandex/IntermediateCA.crt && \
      security import /usr/local/share/ca-certificates/Yandex/RootCA.crt -k ~/Library/Keychains/login.keychain; \
      security import /usr/local/share/ca-certificates/Yandex/IntermediateCA.crt -k ~/Library/Keychains/login.keychain
      ```
   
      Сертификаты будут сохранены в файлах:
   
      * `/usr/local/share/ca-certificates/Yandex/RootCA.crt`
      * `/usr/local/share/ca-certificates/Yandex/IntermediateCA.crt`
   
   - Windows (PowerShell) {#windows}
   
      1. Скачайте и импортируйте сертификаты:
   
         ```powershell
         mkdir -Force $HOME\.yandex; `
         curl.exe https://storage.yandexcloud.kz/cloud-certs/RootCA.pem `
           --output $HOME\.yandex\RootCA.crt; `
         curl.exe https://storage.yandexcloud.kz/cloud-certs/IntermediateCA.pem `
           --output $HOME\.yandex\IntermediateCA.crt; `
         Import-Certificate `
           -FilePath $HOME\.yandex\RootCA.crt `
           -CertStoreLocation cert:\CurrentUser\Root; `
         Import-Certificate `
           -FilePath $HOME\.yandex\IntermediateCA.crt `
           -CertStoreLocation cert:\CurrentUser\Root
         ```
   
         Корпоративные политики и антивирус могут блокировать скачивание сертификата. Подробнее в разделе [Вопросы и ответы](qa/connection.md#get-ssl-error).
   
      1. Подтвердите согласие с установкой сертификатов в хранилище <q>Доверенные корневые центры сертификации</q>.
   
      Сертификаты будут сохранены в файлах:
   
      * `$HOME\.yandex\RootCA.crt`
      * `$HOME\.yandex\IntermediateCA.crt`
   
   {% endlist %}

1. Используйте для подключения ClickHouse® CLI:
   1. Укажите путь к SSL-сертификату `RootCA.crt` в [конфигурационном файле](https://clickhouse.com/docs/ru/interfaces/cli#interfaces_cli_configuration), в элементе `<caConfig>`:

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

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

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


## Что дальше {#whats-next}

* Изучите [концепции сервиса](concepts/index.md).
* Узнайте подробнее о [создании кластера](operations/cluster-create.md) и [подключении к БД](operations/connect/index.md).
* Ознакомьтесь с [вопросами и ответами](qa/general.md).

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._