Подключиться к кластеру ClickHouse

Последнее изменение: 18 июня 2026

К кластеру ClickHouse можно подключиться:

• через консольные клиенты, например clickhouse-client;
• программный код.

Для всех способов используется подключение с SSL.

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

Порты для подключения

Для подключения к ClickHouse используйте порты:

• 9440 — порт для подключения через нативный интерфейс (TCP);
• 8443 — порт для подключения через HTTP-интерфейс.

Адреса для подключения

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

• подключение к кластеру из приватной подсети;
• подключение к кластеру из интернета.

Подключение к кластеру из приватной подсети

Если вы подключаетесь к кластеру из приватной подсети, используйте приватный IP-адрес.

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

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

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

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

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

Посмотреть адрес для подключения

1. В панели управления в верхнем меню нажмите Продукты и выберите Облачные базы данных.
2. Откройте вкладку Активные.
3. Откройте страницу кластера баз данных → вкладка Подключение.
4. В блоке Адреса для подключения откройте вкладку группы нод, адреса которой хотите посмотреть.

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

clickhouse-client

1. Создайте конфигурационный файл config.xml:

   if [ "$USER" = "root" ]; then
       CONFIG_DIR="/root/.clickhouse-client"
   else
       CONFIG_DIR="/home/${USER}/.clickhouse-client"
   fi
   
   mkdir -p ${CONFIG_DIR}
   
   cat > ${CONFIG_DIR}/config.xml << EOF
   <config>
       <openSSL>
           <client>
               <caConfig>${CONFIG_DIR}/root.crt</caConfig>
               <verificationMode>strict</verificationMode>
               <invalidCertificateHandler>
                   <name>RejectCertificateHandler</name>
               </invalidCertificateHandler>
           </client>
       </openSSL>
   </config>
   EOF

2. Скачайте корневой сертификат и поместите его в папку ~/.clickhouse-client/:

   wget https://storage.dbaas.selcloud.ru/CA.pem -O ~/.clickhouse-client/root.crt
   chmod 0600 ~/.clickhouse-client/root.crt

3. Подключитесь к ноде:

   clickhouse-client --host <host> \
                     --secure \
                     --user admin \
                     --database <database_name> \
                     --port <port> \
                     --password <password>

   Укажите:

   • <host> — IP-адрес ноды;
   • <database_name> — имя базы данных. При первом подключении к кластеру укажите базу данных по умолчанию — default. После первого подключения вы можете создать новые базы данных;
   • <port> — порт для подключения;
   • <password> — пароль пользователя-администратора. Пароль задается при создании кластера. После создания пароль нельзя посмотреть в панели управления, но можно изменить.

Python

1. Скачайте корневой сертификат и поместите его в папку ~/.clickhouse/:

   mkdir -p ~/.clickhouse/
   wget https://storage.dbaas.selcloud.ru/CA.pem -O ~/.clickhouse/root.crt
   chmod 0600 ~/.clickhouse/root.crt

2. Установите библиотеку clickhouse-driver:

   pip3 install clickhouse-driver

3. Подключитесь к ноде:

   from clickhouse_driver import Client
   
   client = Client(host='<host>',
                   user='admin',
                   password='<password>',
                   port=<port>,
                   secure=True,
                   verify=True,
                   ca_certs='/root/.clickhouse/root.crt')
   
   print(client.execute('SELECT version()'))

   Укажите:

   • <host> — IP-адрес ноды;
   • <password> — пароль пользователя-администратора. Пароль задается при создании кластера. После создания пароль нельзя посмотреть в панели управления, но можно изменить;
   • <port> — порт для подключения.

Go

1. Скачайте корневой сертификат и поместите его в папку ~/.clickhouse/:

   mkdir -p ~/.clickhouse/
   wget https://storage.dbaas.selcloud.ru/CA.pem -O ~/.clickhouse/root.crt
   chmod 0600 ~/.clickhouse/root.crt

2. Подключитесь к ноде:

   package main
   
   import (
       "fmt"
       "net/http"
       "io/ioutil"
       "crypto/x509"
       "crypto/tls"
   )
   
   func main() {
   
       const DB_HOST = "<host>"
       const DB_NAME = "<database_name>"
       const DB_USER = "admin"
       const DB_PASS = "<password>"
   
       const CACERT = "/root/.clickhouse/root.crt";
   
       caCert, err := ioutil.ReadFile(CACERT)
       if err != nil {
           panic(err)
       }
       caCertPool := x509.NewCertPool()
       caCertPool.AppendCertsFromPEM(caCert)
       conn := &http.Client{
           Transport: &http.Transport{
           TLSClientConfig: &tls.Config{
               RootCAs: caCertPool,
           },
       },
       }
   
       req, _ := http.NewRequest("GET", fmt.Sprintf("https://%s:<port>/", DB_HOST), nil)
       query := req.URL.Query()
       query.Add("database", DB_NAME)
       query.Add("query", "SELECT version()")
   
       req.URL.RawQuery = query.Encode()
   
       req.Header.Add("X-ClickHouse-User", DB_USER)
       req.Header.Add("X-ClickHouse-Key", DB_PASS)
   
       resp, err := conn.Do(req)
       if err != nil {
           panic(err)
       }
   
       defer resp.Body.Close()
   
       data, _ := ioutil.ReadAll(resp.Body)
       fmt.Println(string(data))
   }

   Укажите:

   • <host> — IP-адрес ноды;
   • <database_name> — имя базы данных. При первом подключении к кластеру укажите базу данных по умолчанию — default. После первого подключения вы можете создать новые базы данных;
   • <port> — порт для подключения;
   • <password> — пароль пользователя-администратора. Пароль задается при создании кластера. После создания пароль нельзя посмотреть в панели управления, но можно изменить;
   • <port> — порт для подключения.

Node.js

1. Скачайте корневой сертификат и поместите его в папку ~/.clickhouse/:

   mkdir -p ~/.clickhouse/
   wget https://storage.dbaas.selcloud.ru/CA.pem -O ~/.clickhouse/root.crt
   chmod 0600 ~/.clickhouse/root.crt

2. Установите зависимости:

   npm install querystring

3. Подключитесь к ноде:

   "use strict"
   const https = require('https');
   const querystring = require('querystring');
   const fs = require('fs');
   
   const DB_HOST = "<host>";
   const DB_NAME = "<database_name>";
   const DB_USER = "admin";
   const DB_PASS = "<password>";
   
   const CACERT = "/root/.clickhouse/root.crt";
   
   const options = {
       'method': 'GET',
       'ca': fs.readFileSync(CACERT),
       'path': '/?' + querystring.stringify({
           'database': DB_NAME,
           'query': 'SELECT version()',
       }),
       'port': <port>,
       'hostname': DB_HOST,
       'headers': {
           'X-ClickHouse-User': DB_USER,
           'X-ClickHouse-Key': DB_PASS,
       },
   };
   
   const rs = https.request(options, (res) => {
       res.setEncoding('utf8');
       res.on('data', (chunk) => {
           console.log(chunk);
       });
   });
   
   rs.end();

   Укажите:

   • <host> — IP-адрес ноды;
   • <database_name> — имя базы данных. При первом подключении к кластеру укажите базу данных по умолчанию — default. После первого подключения вы можете создать новые базы данных;
   • <port> — порт для подключения;
   • <password> — пароль пользователя-администратора. Пароль задается при создании кластера. После создания пароль нельзя посмотреть в панели управления, но можно изменить;
   • <port> — порт для подключения.

Java

1. Скачайте корневой сертификат и поместите его в папку ~/.clickhouse/:

   mkdir -p ~/.clickhouse/
   wget https://storage.dbaas.selcloud.ru/CA.pem -O ~/.clickhouse/root.crt
   chmod 0600 ~/.clickhouse/root.crt

2. Установите зависимости:

   sudo apt update && sudo apt install --yes default-jdk maven

3. Создайте конфигурационный файл для Maven:

   pom.xml

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.example</groupId>
       <artifactId>app</artifactId>
       <version>0.1.0</version>
       <packaging>jar</packaging>
   
       <properties>
           <maven.compiler.source>1.8</maven.compiler.source>
           <maven.compiler.target>1.8</maven.compiler.target>
           <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       </properties>
   
       <dependencies>
           <dependency>
               <groupId>com.clickhouse</groupId>
               <artifactId>clickhouse-jdbc</artifactId>
               <version>0.9.8</version>
           </dependency>
   
           <dependency>
               <groupId>org.slf4j</groupId>
               <artifactId>slf4j-simple</artifactId>
               <version>1.7.36</version>
           </dependency>
       </dependencies>
   
       <build>
           <sourceDirectory>src</sourceDirectory>
           <finalName>${project.artifactId}-${project.version}</finalName>
   
           <plugins>
               <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-compiler-plugin</artifactId>
                   <version>3.11.0</version>
                   <configuration>
                       <source>1.8</source>
                       <target>1.8</target>
                   </configuration>
               </plugin>
   
               <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-assembly-plugin</artifactId>
                   <version>3.7.1</version>
   
                   <configuration>
                       <descriptorRefs>
                           <descriptorRef>jar-with-dependencies</descriptorRef>
                       </descriptorRefs>
   
                       <archive>
                           <manifest>
                               <mainClass>com.example.App</mainClass>
                           </manifest>
                       </archive>
                   </configuration>
   
                   <executions>
                       <execution>
                           <id>make-assembly</id>
                           <phase>package</phase>
                           <goals>
                               <goal>single</goal>
                           </goals>
                       </execution>
                   </executions>
               </plugin>
           </plugins>
       </build>
   
   </project>

4. Подключитесь к ноде:

   package com.example;
   
   import java.sql.Connection;
   import java.sql.DriverManager;
   import java.sql.ResultSet;
   
   public class App {
       public static void main(String[] args) {
           String DB_HOST = "<host>";
           String DB_NAME = "<database_name>";
           String DB_USER = "admin";
           String DB_PASS = "<password>";
   
           String CACERT = "/root/.clickhouse/root.crt";
   
           String DB_URL = String.format(
               "jdbc:clickhouse://%s:<port>/%s?ssl=true&sslrootcert=%s",
               DB_HOST,
               DB_NAME,
               CACERT
           );
   
           try {
               Class.forName("com.clickhouse.jdbc.ClickHouseDriver");
   
               Connection conn = DriverManager.getConnection(
                   DB_URL,
                   DB_USER,
                   DB_PASS
               );
   
               ResultSet rs = conn.createStatement().executeQuery(
                   "SELECT version()"
               );
   
               if (rs.next()) {
                   System.out.println("ClickHouse version: " + rs.getString(1));
               }
   
               rs.close();
               conn.close();
           } catch (Exception ex) {
               ex.printStackTrace();
           }
       }
   }

   Укажите:

   • <host> — IP-адрес ноды;
   • <database_name> — имя базы данных. При первом подключении к кластеру укажите базу данных по умолчанию — default. После первого подключения вы можете создать новые базы данных;
   • <port> — порт для подключения;
   • <password> — пароль пользователя-администратора. Пароль задается при создании кластера. После создания пароль нельзя посмотреть в панели управления, но можно изменить;
   • <port> — порт для подключения.