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} 变量中），您应按照数据库连接的标准语法进行指定，其中额外信息作为 URI 的参数传递（请注意，URI 的所有组件都应进行 URL 编码）。连接也可以指定为 JSON 字符串。

例如

AIRFLOW_CONN_YDB_DEFAULT1='ydb://grpcs://my_name:[email protected]: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"}}'