YDB 连接¶

YDB 连接类型提供了到 YDB 数据库的连接。

配置连接¶

主机 (必需)

要连接的主机，不含端口。可接受的协议：grpc/grpcs，例如grpc://my_host、ydb.serverless.yandexcloud.net 或lb.etn9txxxx.ydb.mdb.yandexcloud.net。

数据库 (必需)

指定要连接的数据库，例如/local 或/ru-central1/b1gtl2kg13him37quoo6/etndqstq7ne4v68n6c9b。

端口 (可选)

要连接的端口或 YDB 集群。默认值为 2135。

登录名 (可选)

指定用于连接的用户名。

密码 (可选)

指定用于连接的密码。

服务账户认证 JSON (可选)

服务账户认证 JSON，例如 {“id”: “…”, “service_account_id”: “…”, “private_key”: “…”}。

服务账户认证 JSON 文件路径 (可选)

服务账户认证 JSON 文件路径。文件内容类似于：{“id”: “…”, “service_account_id”: “…”, “private_key”: “…”}。

访问令牌 (可选)

用户账户 IAM 令牌。

使用 VM 元数据 (可选)

是否使用 VM 元数据检索访问令牌

将连接指定为 URI 时（在AIRFLOW_CONN_{CONN_ID} 变量中），您应按照数据库连接的标准语法进行指定，其中 extras（额外参数）作为 URI 的参数传递（请注意，URI 的所有组件都应进行 URL 编码）。连接也可以指定为 JSON 字符串。

例如

AIRFLOW_CONN_YDB_DEFAULT1='ydb://grpcs://my_name:my_password@example.com:2135/?database=%2Flocal'
AIRFLOW_CONN_YDB_DEFAULT2='{"conn_type": "ydb", "host": "grpcs://example.com", "login": "my_name", "password": "my_password", "port": 2135, "extra": {"database": "/local"}}'