创建数据库连接
- 进入表格:首先,打开您想要连接的 Base 中的任意一个表格。
- 进入设计页面:点击右上角的 ⚙️ 图标,进入 Base 设计页面。
- 找到数据库连接面板:在设计页面中,找到「数据库连接」面板。
- 创建连接:点击创建,系统将自动生成一个只读的 PostgreSQL 连接,包括用户名、密码和连接地址。
连接数据库
使用获取的凭证通过您喜欢的工具进行连接,示例如下:
查询数据
连接成功后,您可以使用 SQL 查询数据:" 将 schema 和表名包裹起来以保持大小写敏感。
编写查询语句需要知道以下三个信息:
- Schema 名称(BaseId):以
bse开头的 Base 标识符 - 表名:PostgreSQL 中的物理表名
- 字段名:数据库中的实际列名
获取 BaseId(Schema 名称)
Teable 中的每个 Base 对应 PostgreSQL 中的一个 schema。BaseId 就是 SQL 查询中使用的 schema 名称。 方法一:查看 URL,以bse 开头的字符串就是 BaseId。


获取表名
Teable 界面上的表名不会自动同步到物理数据库表名。请在 Base 设计界面中查看实际的数据库表名。
获取字段名
数据库中的字段(列)名可能与 Teable 界面上显示的不同。请在设计界面中查看dbFieldName。

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 名称),但无法访问它们的内容。