跳转到主要内容
  • 私有化部署:所有版本均可用,无连接数限制
  • 云端版本:仅企业版可用,限制 20 个连接
Teable 允许您通过外部工具连接底层 PostgreSQL 数据库进行只读查询。支持 BI 工具(PowerBI、Metabase、Superset)、数据库客户端(DataGrip、Navicat、TablePlus)、低代码平台(Appsmith、Budibase)以及应用程序代码。

创建数据库连接

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

连接数据库

使用获取的凭证通过您喜欢的工具进行连接,示例如下: Connection example

查询数据

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

获取 BaseId(Schema 名称)

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

获取表名

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

获取字段名

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

系统字段

Teable 自动创建以下系统字段(无法重命名):
字段说明
__id唯一 ID
__version版本号
__auto_number自增数字,主键
__created_time创建时间
__last_modified_time最近修改时间
__created_by创建人 ID
__last_modified_by最近修改人 ID
__row*视图索引字段,用于维护记录顺序
__fk*关联字段的外键

中间表

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

权限说明

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

连接数限制

默认限制为 20 个并发连接。

写入数据

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

关闭连接

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