文档中心

AI 原生 BaaS 平台 Supabase 版

算力管理

管理数据湖连接

管理数据湖连接

AI 原生数据库管理平台为使用 PostgreSQL 引擎的 Workspace 提供了数据湖能力，支持从对象存储 TOS 进行数据的读取和写入。本文介绍为分支创建和管理数据湖连接的操作步骤。

前提条件

已创建 Workspace 且 Workspace 的状态为运行中。

目标分支的状态为运行中。

分支主算力的 AP 加速功能已开启，或已为分支创建 DuckDB 算力。

操作步骤

创建连接

登录 AI 原生数据库管理平台。

在顶部导航栏，选择目标项目和目标地域。

进入目标 Workspace 的分支管理页面。可通过以下两种途径中的任意一种进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的分支管理，再单击页面左上角的 Workspace 名称右侧的，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的 Workspaces 进入 Workspaces 页面。在 Workspaces 页面单击目标 Workspace 名称进入目标 Workspace 的概览页。在概览页，单击分支区域右侧的全部分支，即可进入目标 Workspace 的分支管理页面。

在分支管理页面，单击目标分支名称，进入分支总览页。

在分支总览页的 DuckDB 页签，单击创建连接，进入创建连接页面。

在创建连接页面，完成以下配置后，单击创建。

配置	是否必选	说明
连接名称	是	设置连接的名称。连接名称应满足以下规则：只能包含大小写的英文字母、数字和下划线（_），长度需要在 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 插件。

测试连接

登录 AI 原生数据库管理平台。

在顶部导航栏，选择目标项目和目标地域。

进入目标 Workspace 的分支管理页面。可通过以下两种途径中的任意一种进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的分支管理，再单击页面左上角的 Workspace 名称右侧的，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的 Workspaces 进入 Workspaces 页面。在 Workspaces 页面单击目标 Workspace 名称进入目标 Workspace 的概览页。在概览页，单击分支区域右侧的全部分支，即可进入目标 Workspace 的分支管理页面。

在分支管理页面，单击目标分支名称，进入分支总览页。

在分支总览页的 DuckDB 页签下，您可在下拉列表中按照创建了数据湖连接的库对连接进行筛选查看，也可通过连接名称搜索连接。

删除连接

注意

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

登录 AI 原生数据库管理平台。

在顶部导航栏，选择目标项目和目标地域。

进入目标 Workspace 的分支管理页面。可通过以下两种途径中的任意一种进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的分支管理，再单击页面左上角的 Workspace 名称右侧的，在弹出的下拉列表中选择目标 Workspace，即可进入目标 Workspace 的分支管理页面。

单击页面中间导航栏中的 Workspaces 进入 Workspaces 页面。在 Workspaces 页面单击目标 Workspace 名称进入目标 Workspace 的概览页。在概览页，单击分支区域右侧的全部分支，即可进入目标 Workspace 的分支管理页面。

在分支管理页面，单击目标分支名称，进入分支总览页。

在分支总览页的 DuckDB 页签下，单击目标连接行的 ... > 删除。

在弹出的确定删除连接吗？页面中，单击确定，即可删除连接。

相关 API

API	说明
CreateDataLakeSecretConnection	调用 CreateDataLakeSecretConnection 接口创建数据湖连接。
DeleteDataLakeSecretConnection	调用 DeleteDataLakeSecretConnection 接口删除数据湖连接。
DescribeDataLakeSecretConnection	调用 DescribeDataLakeSecretConnection 接口查询数据湖连接。
CheckDataLakeSecretConnection	调用 CheckDataLakeSecretConnection 验证数据湖连接的连通性。
ListDatabasesDataLakeSecretConnection	调用 ListDatabasesDataLakeSecretConnection 接口查询创建了数据湖连接的库。

最近更新时间：2026.07.17 17:32:17

这个页面对您有帮助吗？

有用

有用

无用

无用