快速上手
通过 SQL 访问表格数据
适用于私有化部署或云端企业版
创建数据库连接
- 进入表格：首先，打开您想要连接的表格。
- 选择 API 按钮：在右侧找到并点击 API 按钮。
- 选择 Postgresql Connection：在弹出的选项中，选择 Postgresql Connection。
- 进入设置界面：点击创建，系统将自动创建一个只读的 Postgres 用户，包括用户名、密码和数据库链接地址。
连接方式
- 标准 PostgreSQL 客户端：如 DataGrip, Navcat, TablePlus 等。
- BI 产品：如 PowerBI, Metabase, Superset 等。
- 低代码软件：如 Appsmith, Budibase 等。
- 应用程序代码：通过选择对应语言的 Postgres Driver。
获取 BaseId
- 点击任意表格进入界面，URL 上方以
bse开头的字符串就是 baseId。
- 进入数据库设计界面（表格右上角的 ⚙ 图标），里面的 schema 名就是 baseId。
连接数据库
在不同的产品上，连接数据库的方式略有不同，但大同小异，我们这里进行一个简单的示例
关闭数据库连接
- 进入 Database Connection 界面：在 Database Connection 界面点击删除，即可关闭连接。
- 密码清除：删除后旧的密码将被清除。重新新建将会是新的连接。
数据库表中的内容
点击表格右上角的 ⚙️ 图标进入数据库设计界面，里面包含了关于当前表格在数据库中的名称和结构详情，对于如何在外部进行数据查询非常有帮助数据库表名称
修改Teable 中的表名称不会同步修改数据库中的 table name，您必须显式的修改物理数据库中的表名。
当你完成表名修改之后，就可以直接使用 SQL 进行查询，下面是一个例子查询当前表格的前 100 行数据
" 将 schema 和 table 名称包住才能够正确的区分大小写。
用户创建的字段
您在表格中创建的所有字段。 注意，数据库表中的字段 (列) 名与用户在 Teable 界面上的命名不会完全一致，请在进行查询前先在数据库设计界面页面检查字段在数据库中的名称，并进行必要的修改。 修改 teable 中的字段名并不会同步修改 dbFieldName, 您必须显式的修改 dbFieldName 以修改 Postgres 中实际的 column name
Teable 系统字段
系统字段无法被重命名__id唯一 ID__version版本号__auto_number自增数字，主键__created_time创建时间__last_modified_time最近修改时间__created_by创建人 ID__last_modified_by最近修改人 ID- 视图索引字段：以
__row开头的字段，用于维护当前视图中记录的顺序。 - 外键：如果存在关联字段，会创建逻辑外键，命名以
__fk开头。
中间表
以junction_ 开头的表，用于处理 ManyToMany 以及单向关联关系。
连接数限制
数据库默认限制为 20 个并发连接。权限说明
创建的连接用户权限访问范围为当前所在的 Base (Teable界面上称数据库），它对应 Postgres 中的 schema, schema 是 Postgres 中命名空间概念，提供了非常好的权限隔离特性，保证当前连接仅可访问该 schema 中的表，但是 postgres 中创建的角色会拥有所有 schema 的名称查看能力，这也就是为什么当你使用外部应用连接上数据库是时可能会看到下图一样非常多的 baseId (实际上是schema 名称）。但是可以放心的是，除了这个 Id 之外任何其他的用户内容是无法被访问的。