Интеграция Yandex Managed Service for ClickHouse® с внешней базой данных Microsoft SQL Server через ClickHouse® JDBC Bridge

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

Обновлена 5 ноября 2026 г.

Подготовьте облако к работе
- Необходимые платные ресурсы
Подготовьте инфраструктуру
Подготовьте внешнюю базу данных Microsoft SQL Server
Запросите данные с помощью JDBC Table Function
Создайте таблицу с помощью JDBC Table Engine
Удалите созданные ресурсы

С помощью ClickHouse® JDBC Bridge вы можете запрашивать данные из таблицы внешней базы данных Microsoft SQL Server функцией JDBC Table Function. Для создания таблиц в кластере ClickHouse®, которые ссылаются на таблицу внешней базы данных Microsoft SQL Server, будет использоваться инструмент JDBC Table Engine.

Чтобы интегрировать кластер ClickHouse® с БД Microsoft SQL Server через ClickHouse® JDBC Bridge:

Подготовьте облако к работе

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

Необходимые платные ресурсы

Кластер Managed Service for ClickHouse®: использование вычислительных ресурсов выделенных хостов, объем хранилища и резервных копий (тарифы Managed Service for ClickHouse®).
NAT-шлюз: почасовое использование шлюза и исходящий через него трафик, если для хостов кластера не включен публичный доступ (тарифы Virtual Private Cloud).
Публичные IP-адреса, если для хостов кластера включен публичный доступ (тарифы Virtual Private Cloud).

Подготовьте инфраструктуру

Создайте группу безопасности и настройте ее.

Также добавьте правило для исходящего трафика:
- Диапазон портов — 0-65535;
- Протокол — TCP;
- Источник — Диапазон адресов;
- IPv4 CIDR — 0.0.0.0/0.
Это правило разрешает любой исходящий трафик, что позволит ClickHouse® JDBC Bridge подключаться к внешним базам данных, в том числе к Microsoft SQL Server.
Создайте кластер Managed Service for ClickHouse®.

При создании кластера укажите группу безопасности, подготовленную ранее.

В разделе Настройки СУБД нажмите Настроить и добавьте опцию jdbcBridge с параметрами:
- host — IP-адрес вашей инсталляции базы данных Microsoft SQL Server;
- port — 9019.
Создайте NAT-шлюз для подсети, в которой будет создан кластер Managed Service for ClickHouse®, если вы не используете публичный доступ.

Подготовьте внешнюю базу данных Microsoft SQL Server

Убедитесь, что к вашей инсталляции внешней базы данных Microsoft SQL Server разрешено подключение по портам 9019 и 1433.

Подключитесь к вашей инсталляции внешней базы данных Microsoft SQL Server и загрузите JDBC-драйвер в директорию /opt/drivers:

sudo mkdir -p /opt/drivers && \
curl -s https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/ | grep -oP '(?<=href=")[^"]+(?=/")' | grep 'jre8$' | grep -v 'preview' | sort -V | tail -n1 | xargs -I{} bash -c 'ver="{}"; file=$(curl -s https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/$ver/ | grep -oP "(?<=href=\")[^\"]+\.jar" | grep -vE "javadoc|sources" | head -n1); sudo curl -o /opt/drivers/$file https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/$ver/$file'

Установите Docker Engine.
Запустите ClickHouse® JDBC Bridge:
```
docker run -d --name jdbc_bridge --network host -v /opt/drivers:/app/drivers clickhouse/jdbc-bridge
```
Если у вас уже запущен контейнер, перезапустите его, чтобы новые драйверы загрузились в ClickHouse® JDBC Bridge:
```
docker container restart jdbc_bridge
```
Создайте файл init.sql следующего содержания:
```
CREATE LOGIN jdbc_user WITH PASSWORD = '<пароль_пользователя>';
GO
CREATE DATABASE mydb;
GO
USE mydb;
GO
CREATE USER jdbc_user FOR LOGIN jdbc_user;
GO
ALTER ROLE db_owner ADD MEMBER jdbc_user;
GO
CREATE SCHEMA jdbc_schema AUTHORIZATION jdbc_user;
GO
ALTER USER jdbc_user WITH DEFAULT_SCHEMA = jdbc_schema;
GO
```
Где <пароль_пользователя> должен быть длиной минимум 8 символов и содержать хотя бы три из четырех типов:
- буквы верхнего регистра;
- буквы нижнего регистра;
- цифры;
- спецсимволы.
Выполните скрипт init.sql через sqlcmd от имени административного пользователя SA:
```
sqlcmd -S <хост_Microsoft_SQL_Server> -U SA -P '<пароль_администратора>' -i init.sql
```
Где:
- <хост_Microsoft_SQL_Server> — IP-адрес вашей инсталляции Microsoft SQL Server.
- <пароль_администратора> — пароль от административной учетной записи SA.
В результате его выполнения будут созданы:
- база данных mydb;
- пользователь jdbc_user;
- схема jdbc_schema.

Подключитесь от имени нового пользователя jdbc_user:

sqlcmd -S <хост_Microsoft_SQL_Server> -U jdbc_user -P '<пароль_пользователя>' -i init.sql

Создайте набор тестовых данных:

CREATE TABLE Employees (
    Id INT PRIMARY KEY IDENTITY(1,1),
    Name NVARCHAR(100),
    Position NVARCHAR(100),
    Salary DECIMAL(10,2)
);
GO

INSERT INTO Employees (Name, Position, Salary) VALUES
('Alice Johnson', 'Developer', 75000),
('Bob Smith', 'Manager', 90000),
('Charlie Rose', 'Analyst', 65000);
GO

SELECT * FROM Employees;
GO

Запросите данные с помощью JDBC Table Function

Подключитесь к кластеру Managed Service for ClickHouse®.
Отправьте запрос к внешней базе данных Microsoft SQL Server с помощью JDBC Table Function:
```
SELECT * FROM jdbc('jdbc:sqlserver://<хост_Microsoft_SQL_Server_DB>:1433;databaseName=mydb;user=jdbc_user;password=<пароль_пользователя>;encrypt=false;', 'jdbc_schema', 'Employees')
```
Где:
- <пароль_пользователя> — пароль пользователя jdbc_user.
- <хост_Microsoft_SQL_Server_DB> — IP-адрес вашей инсталляции базы данных Microsoft SQL Server.
Если запрос выполнен успешно, то вы получите данные из внешней базы данных Microsoft SQL Server.

Создайте таблицу с помощью JDBC Table Engine

С помощью JDBC Table Engine вы можете запрашивать данные через SELECT. Чтобы использовать JDBC Table Engine:

Подключитесь к кластеру Managed Service for ClickHouse®.

Создайте таблицу с JDBC Table Engine на основе таблицы из внешней базы данных Microsoft SQL Server.

CREATE TABLE mssql_employees
(
    Id Int32,
    Name String,
    Position String,
    Salary Decimal(10, 2)
)
ENGINE = JDBC(
    'jdbc:sqlserver://<хост_Microsoft_SQL_Server_DB>:1433;databaseName=mydb;user=jdbc_user;password=<пароль_пользователя>;encrypt=false;',
    'jdbc_schema',
    'Employees'
);

Вы также можете создать таблицу с частичным указанием полей.

Проверьте результат:
```
SELECT * FROM mssql_employees;
```
Если таблица создалась корректно, то вы увидите вывод данных из таблицы внешней базы данных Microsoft SQL Server.

Удалите созданные ресурсы

Чтобы перестать платить за созданные ресурсы:

ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc.

Интеграция Yandex Managed Service for ClickHouse® с внешней базой данных Microsoft SQL Server через ClickHouse® JDBC Bridge

Подготовьте облако к работеПодготовьте облако к работе

Необходимые платные ресурсыНеобходимые платные ресурсы

Подготовьте инфраструктуруПодготовьте инфраструктуру

Подготовьте внешнюю базу данных Microsoft SQL ServerПодготовьте внешнюю базу данных Microsoft SQL Server

Запросите данные с помощью JDBC Table FunctionЗапросите данные с помощью JDBC Table Function

Создайте таблицу с помощью JDBC Table EngineСоздайте таблицу с помощью JDBC Table Engine

Удалите созданные ресурсыУдалите созданные ресурсы

Была ли статья полезна?