AI 原生数据库管理平台为使用 PostgreSQL 引擎的 Workspace 提供了数据湖能力，支持从对象存储 TOS 进行数据的读取和写入。本文介绍为分支创建和管理数据湖连接的操作步骤。 ## 前提条件 * 已创建 Workspace 且 Workspace 的状态为**运行中**。 * 目标分支的状态为**运行中**。 * 分支主算力的 AP 加速功能已开启，或已为分支创建 DuckDB 算力。 ## 操作步骤 ### 创建连接 1. 登录 [AI 原生数据库管理平台](https://console.volcengine.com/aidap)。 2. 在顶部导航栏，选择目标项目和目标地域。 3. 进入目标 Workspace 的**分支管理**页面。可通过以下两种途径中的任意一种进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d6a6bd14e29a4147670589c8181cc1a.png)**分支管理**，再单击页面左上角的 Workspace 名称右侧的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a1b21e2628b99b7cc66d1f2a7f9b1fcb.png)，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_91cbf438e775b519ccb60e548fbb0a79.png) **Workspaces** 进入 **Workspaces** 页面 **。** 在 **Workspaces** 页面单击目标 Workspace 名称进入目标 Workspace 的**概览**页。在**概览**页，单击分支区域右侧的**全部分支**，即可进入目标 Workspace 的**分支管理**页面。 4. 在**分支管理**页面，单击目标分支名称，进入**分支总览**页。 5. 在**分支总览**页的 ** DuckDB ** 页签，单击**创建连接**，进入**创建连接**页面。 6. 在**创建连接**页面，完成以下配置后，单击**创建**。 |**配置** |**是否必选** |**说明** | |---|---|---| |连接名称 |是 |设置连接的名称。连接名称应满足以下规则：

* 只能包含大小写的英文字母、数字和下划线（_），

* 长度需要在 1~64 个字符之间。 | |类型 |否 |无需设定，当前仅支持设置为 TOS。 | |数据库 |是 |选择需要创建数据湖连接的数据库。 | |账号 |是 |选择使用数据库连接的账号。 | |Access Key ID |是 |输入可用于使用对象存储 TOS 服务的 Access Key 的 ID。 | |Secret Access Key |是 |输入可用于使用对象存储 TOS 服务的 Access Key 的 Secret。 | |Endpoint |否

|无需设定，会根据 Workspace 所在的地域自动取值。

* 华北 2（北京），该配置取值为 `tos-cn-beijing.volces.com`。

* 华东 2（上海），该配置取值为 `tos-cn-shanghai.volces.com`。

* 亚太东南（柔佛），该配置取值为 `tos-ap-southeast-1.volces.com`。 | |Scope |否 |指定用于进行数据湖的 TOS 服务的桶。

说明

如不指定，则使用 TOS 服务下是所有桶进行数据湖连接。

说明

创建数据湖连接过程中，会为数据库安装 pg_duckdb 插件。

### 测试连接 1. 登录 [AI 原生数据库管理平台](https://console.volcengine.com/aidap)。 2. 在顶部导航栏，选择目标项目和目标地域。 3. 进入目标 Workspace 的**分支管理**页面。可通过以下两种途径中的任意一种进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d6a6bd14e29a4147670589c8181cc1a.png)**分支管理**，再单击页面左上角的 Workspace 名称右侧的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a1b21e2628b99b7cc66d1f2a7f9b1fcb.png)，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_91cbf438e775b519ccb60e548fbb0a79.png) **Workspaces** 进入 **Workspaces** 页面 **。** 在 **Workspaces** 页面单击目标 Workspace 名称进入目标 Workspace 的**概览**页。在**概览**页，单击分支区域右侧的**全部分支**，即可进入目标 Workspace 的**分支管理**页面。 4. 在**分支管理**页面，单击目标分支名称，进入**分支总览**页。 5. 在**分支总览**页的 ** DuckDB ** 页签下，您可在下拉列表中按照创建了数据湖连接的库对连接进行筛选查看，也可通过连接名称搜索连接。 ### 删除连接

注意

数据库连接删除后不可恢复，请谨慎操作。

1. 登录 [AI 原生数据库管理平台](https://console.volcengine.com/aidap)。 2. 在顶部导航栏，选择目标项目和目标地域。 3. 进入目标 Workspace 的**分支管理**页面。可通过以下两种途径中的任意一种进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d6a6bd14e29a4147670589c8181cc1a.png)**分支管理**，再单击页面左上角的 Workspace 名称右侧的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a1b21e2628b99b7cc66d1f2a7f9b1fcb.png)，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的**分支管理**页面。 * 单击页面中间导航栏中的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_91cbf438e775b519ccb60e548fbb0a79.png) **Workspaces** 进入 **Workspaces** 页面 **。** 在 **Workspaces** 页面单击目标 Workspace 名称进入目标 Workspace 的**概览**页。在**概览**页，单击分支区域右侧的**全部分支**，即可进入目标 Workspace 的**分支管理**页面。 4. 在**分支管理**页面，单击目标分支名称，进入**分支总览**页。 5. 在**分支总览**页的 ** DuckDB ** 页签下，单击目标连接行的 **...** \> **删除**。 6. 在弹出的**确定删除连接吗？** 页面中，单击**确定**，即可删除连接。 ## 相关 API |API |说明 | |---|---| |[CreateDataLakeSecretConnection](https://www.volcengine.com/docs/87275/2479957) |调用 CreateDataLakeSecretConnection 接口创建数据湖连接。 | |[DeleteDataLakeSecretConnection](https://www.volcengine.com/docs/87275/2479959) |调用 DeleteDataLakeSecretConnection 接口删除数据湖连接。 | |[DescribeDataLakeSecretConnection](https://www.volcengine.com/docs/87275/2479960) |调用 DescribeDataLakeSecretConnection 接口查询数据湖连接。 | |[CheckDataLakeSecretConnection](https://www.volcengine.com/docs/87275/2479961) |调用 CheckDataLakeSecretConnection 验证数据湖连接的连通性。 | |[ListDatabasesDataLakeSecretConnection](https://www.volcengine.com/docs/87275/2479962) |调用 ListDatabasesDataLakeSecretConnection 接口查询创建了数据湖连接的库。 | ##

AI 原生 BaaS 平台 Supabase 版