Skip to main content
仅适用于私有化部署:无连接数限制。
Teable 允许您通过外部工具连接底层 PostgreSQL 数据库进行只读查询。支持 BI 工具(PowerBI、Metabase、Superset)、数据库客户端(DataGrip、Navicat、TablePlus)、低代码平台(Appsmith、Budibase)以及应用程序代码。

创建数据库连接

  1. 进入表格:首先,打开您想要连接的数据库中的任意一个表格。
  2. 进入设计页面:点击右上角的 ⚙️ 图标,进入数据库设计页面。
进入数据库设计页面
  1. 找到数据库连接面板:在设计页面中,找到「数据库连接」面板。
  2. 创建连接:点击创建,系统将自动生成一个只读的 PostgreSQL 连接,包括用户名、密码和连接地址。
数据库连接面板

连接数据库

使用获取的凭证通过您喜欢的工具进行连接,示例如下: 外部数据库连接示例

查询数据

连接成功后,您可以使用 SQL 查询数据:
注意:在 PostgreSQL 中,必须使用双引号 " 将 schema 和表名包裹起来以保持大小写敏感。 编写查询语句需要知道以下三个信息:
  • Schema 名称(数据库ID):以 bse 开头的数据库标识符
  • 表名:PostgreSQL 中的物理表名
  • 字段名:数据库中的实际列名
以下章节将说明如何获取这些信息。

获取数据库 ID(BaseId / Schema 名称)

Teable 中的每个数据库(Base)对应 PostgreSQL 中的一个 schema。BaseId 就是 SQL 查询中使用的 schema 名称。 方法一:查看 URL,以 bse 开头的字符串就是 BaseId。 URL 中的数据库 ID 方法二:在数据库设计界面中,显示的 schema 名就是 BaseId。 数据库设计页面中的 schema 名称

获取表名

Teable 界面上的表名不会自动同步到物理数据库表名。请在数据库设计界面中查看实际的数据库表名。 设计页面中的物理表名 提示:如需修改物理表名,可以在设计界面中进行修改。

获取字段名

数据库中的字段(列)名可能与 Teable 界面上显示的不同。请在设计界面中查看 dbFieldName 设计页面中的物理字段名 提示:修改 Teable 中的字段名不会自动同步。如需修改 PostgreSQL 中的实际列名,请显式修改 dbFieldName

系统字段

Teable 自动创建以下系统字段(无法重命名):

中间表

junction_ 开头的表是系统自动生成的,用于处理多对多和单向关联关系。

权限说明

数据库连接的访问范围仅限于当前数据库。PostgreSQL 的 schema 提供了权限隔离,确保您只能访问自己数据库中的表。 连接时您可能会看到其他的 BaseId(schema 名称),但无法访问它们的内容。 TablePlus 中的数据库 ID

写入数据

Teable 不允许通过外部连接直接写入数据库。如需修改数据,请使用 Teable API

关闭连接

在数据库连接面板中点击删除即可关闭连接。旧密码将被清除,重新创建连接将生成新的凭证。
Last modified on July 15, 2026