Подключение к кластеру

1. В веб-консоли выберите нужный проект.

2. В списке сервисов выберите Managed ClickHouse.

3. Нажмите на имя нужного кластера.

4. Сохраните имя администратора из строки Администратор.

5. Перейдите на вкладку Сети.

6. Определите, к какому объекту необходимо подключиться:

   • Подключение к кластеру — к случайному активному узлу кластера.
   • Подключение к шардам — к случайному активному узлу шарда.
   • Подключение к узлам — к конкретному узлу в кластере.

   Сохраните внутренний IPv4-адрес ресурса из соответствующего блока.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

7. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

8. Подключитесь к ВМ по SSH.

9. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

10. Установите утилиту ClickHouse Client:

    1
    sudo apt install clickhouse-client

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

11. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

    1
    <clickhouse>
    2
        <openSSL>
    3
            <client>
    4
                <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
    5
                <loadDefaultCAFile>false</loadDefaultCAFile>
    6
                <invalidCertificateHandler>
    7
                    <name>RejectCertificateHandler</name>
    8
                </invalidCertificateHandler>
    9
            </client>
    10
        </openSSL>
    11
    </clickhouse>

12. Выполните команду:

    1
    clickhouse-client \
    2
      --secure \
    3
      --host <внутренний IPv4-адрес ресурса> \
    4
      --port 9440 \
    5
      --user <имя администратора кластера> \
    6
      --password <пароль администратора кластера> \
    7
      --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

2. Получите информацию о кластере:

   1
   mws mclickhouse cluster get <имя кластера>

3. Найдите в выводе команды внутренний IPv4-адрес ресурса, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру — status.cluster.endpoints.address.ipAddress;
   • к шарду — status.cluster.shards.endpoints.address.ipAddress;
   • к конкретному узлу — status.cluster.shards.instances.endpoints.address.ipAddress.

   Сохраните нужный IPv4-адрес.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

4. Найдите и сохраните значение параметра spec.bootstrapAdmin.username. Это имя администратора кластера.

5. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

6. Подключитесь к ВМ по SSH.

7. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

8. Установите утилиту ClickHouse Client:

   1
   sudo apt install clickhouse-client

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

9. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

   1
   <clickhouse>
   2
       <openSSL>
   3
           <client>
   4
               <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
   5
               <loadDefaultCAFile>false</loadDefaultCAFile>
   6
               <invalidCertificateHandler>
   7
                   <name>RejectCertificateHandler</name>
   8
               </invalidCertificateHandler>
   9
           </client>
   10
       </openSSL>
   11
   </clickhouse>

10. Выполните команду:

    1
    clickhouse-client \
    2
      --secure \
    3
      --host <внутренний IPv4-адрес ресурса> \
    4
      --port 9440 \
    5
      --user <имя администратора кластера> \
    6
      --password <пароль администратора кластера> \
    7
      --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.

1. Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

2. Получите информацию о кластере:

   1
   curl -X GET https://mclickhouse.mwsapis.ru/mclickhouse/v1/projects/<имя проекта>/clusters/<имя кластера> \
   2
     -H "Authorization: Bearer <IAM-токен>"

3. Найдите в ответе внутренний IPv4-адрес ресурса, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру — status.cluster.endpoints.address.ipAddress;
   • к шарду — status.cluster.shards.endpoints.address.ipAddress;
   • к конкретному узлу — status.cluster.shards.instances.endpoints.address.ipAddress.

   Сохраните нужный IPv4-адрес.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

4. Найдите и сохраните значение параметра spec.bootstrapAdmin.username. Это имя администратора кластера.

5. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

6. Подключитесь к ВМ по SSH.

7. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

8. Установите утилиту ClickHouse Client:

   1
   sudo apt install clickhouse-client

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

9. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

   1
   <clickhouse>
   2
       <openSSL>
   3
           <client>
   4
               <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
   5
               <loadDefaultCAFile>false</loadDefaultCAFile>
   6
               <invalidCertificateHandler>
   7
                   <name>RejectCertificateHandler</name>
   8
               </invalidCertificateHandler>
   9
           </client>
   10
       </openSSL>
   11
   </clickhouse>

10. Выполните команду:

    1
    clickhouse-client \
    2
      --secure \
    3
      --host <внутренний IPv4-адрес ресурса> \
    4
      --port 9440 \
    5
      --user <имя администратора кластера> \
    6
      --password <пароль администратора кластера> \
    7
      --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.

1. В веб-консоли выберите нужный проект.

2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

   • источник трафика — IP-адрес клиента;
   • назначение трафика — внутренний IP-адрес ресурса;
   • протокол и порт — TCP:9440.

3. В списке сервисов выберите Managed ClickHouse.

4. Нажмите на имя нужного кластера.

5. Сохраните имя администратора из строки Администратор.

6. Перейдите на вкладку Сети.

7. Определите, к какому объекту необходимо подключиться:

   • Подключение к кластеру — к случайному активному узлу кластера.
   • Подключение к шардам — к случайному активному узлу шарда.
   • Подключение к узлам — к конкретному узлу в кластере.

   Сохраните внешний IPv4-адрес ресурса из соответствующего блока.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

8. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

9. Установите утилиту ClickHouse Client:

   1
   sudo apt install clickhouse-client

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

10. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

    1
    <clickhouse>
    2
        <openSSL>
    3
            <client>
    4
                <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
    5
                <loadDefaultCAFile>false</loadDefaultCAFile>
    6
                <invalidCertificateHandler>
    7
                    <name>RejectCertificateHandler</name>
    8
                </invalidCertificateHandler>
    9
            </client>
    10
        </openSSL>
    11
    </clickhouse>

11. Выполните команду:

    1
    clickhouse-client \
    2
      --secure \
    3
      --host <внешний IPv4-адрес ресурса> \
    4
      --port 9440 \
    5
      --user <имя администратора кластера> \
    6
      --password <пароль администратора кластера> \
    7
      --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

   • источник трафика — IP-адрес клиента;
   • назначение трафика — внутренний IP-адрес ресурса;
   • протокол и порт — TCP:9440.

3. Получите информацию о кластере:

   1
   mws mclickhouse cluster get <имя кластера>

4. Найдите в выводе команды внешний IPv4-адрес ресурса, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру — status.cluster.endpoints.externalAddress.ipAddress;
   • к шарду — status.cluster.shards.endpoints.externalAddress.ipAddress;
   • к конкретному узлу — status.cluster.shards.instances.endpoints.externalAddress.ipAddress.

   Сохраните нужный IPv4-адрес.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

5. Найдите и сохраните значение параметра spec.bootstrapAdmin.username. Это имя администратора кластера.

6. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

7. Установите утилиту ClickHouse Client:

   1
   sudo apt install clickhouse-client

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

8. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

   1
   <clickhouse>
   2
       <openSSL>
   3
           <client>
   4
               <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
   5
               <loadDefaultCAFile>false</loadDefaultCAFile>
   6
               <invalidCertificateHandler>
   7
                   <name>RejectCertificateHandler</name>
   8
               </invalidCertificateHandler>
   9
           </client>
   10
       </openSSL>
   11
   </clickhouse>

9. Выполните команду:

   1
   clickhouse-client \
   2
     --secure \
   3
     --host <внешний IPv4-адрес ресурса> \
   4
     --port 9440 \
   5
     --user <имя администратора кластера> \
   6
     --password <пароль администратора кластера> \
   7
     --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.

1. Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

   • источник трафика — IP-адрес клиента;
   • назначение трафика — внутренний IP-адрес ресурса;
   • протокол и порт — TCP:9440.

3. Получите информацию о кластере:

   1
   curl -X GET https://mclickhouse.mwsapis.ru/mclickhouse/v1/projects/<имя проекта>/clusters/<имя кластера> \
   2
     -H "Authorization: Bearer <IAM-токен>"

4. Найдите в ответе внешний IPv4-адрес ресурса, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру — status.cluster.endpoints.externalAddress.ipAddress;
   • к шарду — status.cluster.shards.endpoints.externalAddress.ipAddress;
   • к конкретному узлу — status.cluster.shards.instances.endpoints.externalAddress.ipAddress.

   Сохраните нужный IPv4-адрес.

   Примечание

   При подключении по адресу кластера или шарда выбирается случайный активный узел. Каждое новое подключение может попасть на новый узел. Если узел недоступен, он выйдет из балансировки через одну минуту.

5. Найдите и сохраните значение параметра spec.bootstrapAdmin.username. Это имя администратора кластера.

6. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

7. Установите утилиту ClickHouse Client:

   1
   sudo apt install clickhouse-client

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

8. Создайте XML-файл конфигурации ClickHouse Client, например clickhouse-client.xml, со следующим содержимым:

   1
   <clickhouse>
   2
       <openSSL>
   3
           <client>
   4
               <caConfig><!-- Укажите путь к файлу mws-root-ca.crt --></caConfig>
   5
               <loadDefaultCAFile>false</loadDefaultCAFile>
   6
               <invalidCertificateHandler>
   7
                   <name>RejectCertificateHandler</name>
   8
               </invalidCertificateHandler>
   9
           </client>
   10
       </openSSL>
   11
   </clickhouse>

9. Выполните команду:

   1
   clickhouse-client \
   2
     --secure \
   3
     --host <внешний IPv4-адрес ресурса> \
   4
     --port 9440 \
   5
     --user <имя администратора кластера> \
   6
     --password <пароль администратора кластера> \
   7
     --config-file <путь к XML-файлу конфигурации>

При успешном подключении будет выведено сообщение с версией сервера и номером ревизии, например Connected to ClickHouse server version 25.1.8 revision 54475.