CREATE EXTERNAL DATA SOURCE

Вызов CREATE EXTERNAL DATA SOURCE создает внешний источник данных.

CREATE EXTERNAL DATA SOURCE external_data_source WITH (
  SOURCE_TYPE="source_type",
  LOCATION="ip_address_or_fqdn:port",
  USE_TLS="use_tls",
  AUTH_METHOD="auth_method",
  LOGIN="login",
  PASSWORD_SECRET_NAME="password_secret_name"
)

Где:

• external_data_source - название внешнего источника данных.
• source_type - тип внешнего источника данных. Возможные значения: ClickHouse, PostgreSQL, ObjectStorage.
• ip_address_or_fqdn:port - полный сетевой адрес внешнего источника данных, включая порт. В качестве сетевого адреса можно указывать IP-адрес или FQDN.
• use_tls - флаг, указывающий требование подключения через безопасное соединение (TLS). Возможные значения: TRUE, FALSE.
• auth_method - способ аутентификации во внешнем источника данных. Для внешних источников типов ClickHouse, PostgreSQL поддерживается только тип аутентификации BASIC. Для внешнего источника ObjectStorage в данный момент поддерживает только тип аутентификации NONE.
• login - логин, используемый для подключения к внешнему источнику данных.
• password_secret_name - имя секрета, содержащего пароль для подключения к внешнему источнику данных.

При работе по защищенным TLS каналам связи используется системные сертификаты, расположенные на серверах YDB.

Пример

Запрос ниже создает внешний источник с именем TestDataSource к кластеру ClickHouse c IP-адресом 192.168.1.1 и портом 8443, логином admin и именем секрета test_secret:

CREATE EXTERNAL DATA SOURCE TestDataSource WITH (
  SOURCE_TYPE="ClickHouse",
  LOCATION="192.168.1.1:8443",
  USE_TLS="TRUE",
  AUTH_METHOD="BASIC",
  LOGIN="admin",
  PASSWORD_SECRET_NAME="test_secret"
)

Подключение к ClickHouse

Для создания подключения к кластеру ClickHouse необходимо создать внешний источник данных EXTERNAL DATA SOURCE, указав:

• В поле SOURCE_TYPE значение ClickHouse.
• В поле LOCATION полный сетевой адрес кластера ClickHouse, включая порт. В качестве сетевого адреса можно указывать IP-адрес или FQDN. В данный момент подключение к кластеру ClickHouse всегда выполняется про HTTP протоколу.
• В поле USE_TLS флаг, указывающий требование подключения к кластеру ClickHouse через безопасное соединение (TLS).
• В поле AUTH_METHOD значение BASIC.
• В поле LOGIN логин, используемый для подключения к кластеру ClickHouse.
• В поле PASSWORD_SECRET_NAME имя секрета, содержащего пароль для подключения к кластеру ClickHouse.

При работе по защищенным TLS каналам связи используется системные сертификаты, расположенные на серверах YDB.

Пример

Запрос ниже создает внешний источник с именем TestDataSource к кластеру ClickHouse c IP-адресом 192.168.1.1 и портом 8443, логином admin и именем секрета test_secret:

CREATE EXTERNAL DATA SOURCE TestDataSource WITH (
  SOURCE_TYPE="ClickHouse",
  LOCATION="192.168.1.1:8443",
  USE_TLS="TRUE",
  AUTH_METHOD="BASIC",
  LOGIN="admin",
  PASSWORD_SECRET_NAME="test_secret"
)

Подключение к PostgreSQL

Для создания подключения к кластеру PostgreSQL необходимо создать объект EXTERNAL DATA SOURCE, указав в полях:

• в поле SOURCE_TYPE значение PostgreSQL;
• в поле LOCATION полный сетевой адрес кластера PostgreSQL, включая порт. В качестве сетевого адреса можно указывать IP-адрес или FQDN;
• в поле USE_TLS флаг, указывающий требование подключения к кластеру PostgreSQL через безопасное соединение (TLS);
• в поле AUTH_METHOD значение BASIC;
• в поле LOGIN логин, используемый для подключения к кластеру PostgreSQL;
• в поле PASSWORD_SECRET_NAME имя секрета, содержащего пароль для подключения к кластеру PostgreSQL.

В данный момент подключение к кластеру PostgreSQL всегда выполняется про стандартному (Frontend/Backend Protocol) по транспорту TCP. При работе по защищенным TLS каналам связи используется системные сертификаты, расположенные на серверах YDB.

Пример

Запрос ниже создает внешний источник с именем TestDataSource, ведущий на кластер PostgreSQL c IP-адресом 192.168.1.2 и портом 5432, логином admin и именем секрета test_secret:

CREATE EXTERNAL DATA SOURCE TestDataSource WITH (
  SOURCE_TYPE="PostgreSQL",
  LOCATION="192.168.1.1:5432",
  USE_TLS="TRUE",
  AUTH_METHOD="BASIC",
  LOGIN="admin",
  PASSWORD_SECRET_NAME="test_secret"
)

Подключение к S3 (Object Storage)

Для создания внешнего источника данных, ведущего на бакет с данными в S3 (Object Storage) необходимо создать объект EXTERNAL DATA SOURCE, указав в полях:

• в поле SOURCE_TYPE значение ObjectStorage;
• в поле LOCATION сетевой путь к бакету;
• в поле AUTH_METHOD значение NONE.

Подключение возможно к любым источникам данных с протоколом доступа AWS S3. Возможно указание любых URL к системам, поддерживающим этот протокол.

Типовые значения поля LOCATION при подключении к различным системам к бакету bucket:

Пример

Запрос ниже создает внешний источник данных с именем TestDataSource, ведущий в каталог folder в бакете bucket в Object Storage:

CREATE EXTERNAL DATA SOURCE TestDataSource WITH (
  SOURCE_TYPE="ObjectStorage",
  LOCATION="http://s3.amazonaws.com/bucket/folder/",
  AUTH_METHOD="NONE"