进阶 tableplus.com 2026-11-16 08:30:30 · 10 阅读

第12章 TablePlus 连接管理与命令行(CLI)指南

GUI 工具 连接与命令行(CLI)

TablePlus 从你的电脑直接连接数据库服务器,数据不经过我们的服务器:TablePlus 不会把你的数据发送或存储到其他任何地方,数据库和 SSH 密码则保存在 Mac 的钥匙串中。详见我们的隐私政策。

连接之前,先准备好数据库凭证:数据库驱动、主机、端口、用户名和密码。

欢迎窗口

启动 TablePlus 后,欢迎窗口右侧会列出已保存的连接。左侧可以创建连接、备份数据库或恢复数据库。

欢迎窗口

- 双击某个连接即可打开。 - 在顶部搜索框(⌘ + F)中输入名称查找连接。 - 右键点击连接可以进行更多操作:Connect、New、Edit...、Duplicate、Copy as URL、Sort By(Tag、Name、Driver)、Import Connection、Export Connections 和 Delete。

创建连接

通过连接表单创建

- 在欢迎窗口点击 Create Connection(或搜索框旁的 + 按钮),也可以通过菜单 Connection > New...。 - 选择数据库驱动,点击 Create。 - 填写连接信息,如主机、端口、用户、密码和数据库。 - 点击 Test 测试连接,点击 Connect 直接打开,或点击 Save 只保存不连接。

连接表单

表单顶部可以设置:

- Name:连接在列表中的显示名称。 - Status Color:工作区窗口状态栏的颜色,方便区分连接,比如生产和测试环境。 - Tag:连接的环境标签(见连接标签)。 - Safe Mode:发送查询前是否弹出警告或要求输入密码。见安全模式。

密码框有一个菜单,可以选择密码的保存方式:

- Store in keychain:保存在钥匙串中(默认)。 - Ask every time:每次连接时询问密码。 - No password:不带密码连接。 - Command Line:用 shell 命令代替密码。连接时 TablePlus 会运行该命令并用其输出作为密码,适合短期 token。支持 PostgreSQL、MySQL、MariaDB 和 Redshift。SQL Server 则将 Auth Type 设为 Microsoft Entra ID (Token Only),并选择 Get from CLI 通过命令获取 access token。

Bootstrap commands 可以设置在连接建立后立即执行的 SQL 语句。

导入连接 URL

如果已有连接 URL,可以直接据此创建连接:

- 在欢迎窗口右键选择 New > Import Connection > From URL...(或在驱动窗口点击 Import Connection > From URL...)。 - 粘贴 URL,点击 Import。 - 检查 TablePlus 自动填充的连接表单,然后连接或保存。

例如 PostgreSQL 的 URL 形如:postgresql://user:password@host:port/database。所有支持的 scheme 和选项见连接 URL 格式。

SSH 隧道

要通过 SSH 服务器连接,在连接表单点击 Over SSH,填入 SSH 服务器、端口、用户和密码。TablePlus 内置了原生 SSH 客户端。

要使用密钥认证,勾选 Use SSH key,点击 Import a private key... 选择私钥文件(不是 .pub 文件)。如果勾选了 Use SSH key 但不填私钥,TablePlus 会读取你的 ~/.ssh/config。

通过 SSH 连接

SSH 密码菜单与数据库密码一样,有 Store in keychain、Ask every time 和 No password 选项。

如果 SSH 连接有问题,可在 Help > Enable SSH & Bash Script Log 中开启日志,然后发送到 [email protected],有助于我们更快排查。

SSL

支持的驱动可以在连接表单中设置 SSL 模式。PostgreSQL 的选项有 PREFERRED、DISABLED、REQUIRED、ALLOW、VERIFY-CA 和 VERIFY-FULL;MySQL 的选项有 PREFERRED、DISABLED、REQUIRED、VERIFY-CA 和 VERIFY-IDENTITY。

在 SSL keys 旁边,用 Key...、Cert... 和 CA Cert... 分别选择客户端密钥、客户端证书和 CA 证书文件。

连接标签

每个连接都可以带一个描述其环境的标签。默认有五个标签:local、testing、development、staging 和 production。选择 NO TAG 则不设标签。

要创建自定义标签或修改标签颜色,打开连接表单中的 Tag 菜单,选择 Add/remove tags...。默认标签不能删除,但可以修改颜色,或点击 Default Color 恢复默认。

已保存的连接

编辑已保存的连接

在欢迎窗口右键点击连接,选择 Edit...。

已连接时也可以点击工作区窗口顶部的状态栏,然后点击 Edit。同一个弹窗里还有 Reconnect 和 Disconnect 按钮。

复制连接

右键点击连接,选择 Duplicate。这是快速创建类似连接的方式,比如连接另一台服务器。

恢复上次会话

TablePlus 可以在启动时重新打开你退出时的工作区:

- 打开 Settings(⌘ + ,),进入 General。 - 开启 Reopen closed workspaces at startup。

保持连接活跃

默认情况下,TablePlus 每 30 秒 ping 一次服务器以保持连接。要关闭此功能,打开 Settings(⌘ + ,)> General,关闭 Connections 下的 Keep connection alive。

连接分组

可以把连接分组管理,比如按项目或按环境。

创建分组

- 在欢迎窗口右键选择 New > Group...。 - 输入分组名称,可选点击 Choose icon 选择图标,点击 Save。

把连接拖入分组即可添加,拖出分组即可移除。分组内还可以嵌套其他分组。

编辑或删除分组

- 编辑分组:右键点击分组,选择 Edit...。 - 删除分组:右键点击分组,选择 Delete。分组内的连接也会一并删除。

导出和导入连接

可以用 TablePlus 连接文件(.tableplusconnection)在电脑之间迁移连接。

导出连接

- 在欢迎窗口右键选择 Export Connections,然后选择: - Export all...:导出所在分区下的全部连接(如果只有 Local 来源,就是所有已保存的连接); - Export this group...:导出所选分组内的连接;或 - Export this connection..:只导出所选连接。 - 选择是否 Include databases password 和 Include servers password。 - 设置一个保护文件的密码,点击 Save...,选择保存位置。

导出文件包含分组名称和图标,但不包含 SSH 和 SSL 私钥,导入后需要重新选择。

导入连接

- 在欢迎窗口右键选择 Import Connection > From File...。也可以直接在 Finder 中双击 .tableplusconnection 文件。 - 选择文件,如有密码则输入。

要与团队共享连接或在多台电脑间同步,可进入 Settings > Connections,在 Connection Sources 下点击 Add,选择一个同步文件夹(如 iCloud Drive 或 Dropbox 文件夹)。其中的连接会以独立分区显示在欢迎窗口上,把连接拖入该分区即可移动过去。密码不会存放在该文件夹中,而是保存在每台电脑的钥匙串里。

切换连接

已连接时,点击工具栏的 Connection 按钮,或按 ⌘ + Shift + K(Connection > Open a Connection...),即可显示连接列表并切换到其他连接。

从命令行打开连接

TablePlus 能处理连接 URL,因此可以从 Terminal、脚本或链接打开连接。运行:

open -a TablePlus "postgresql://[email protected]/acme"

要获取已保存连接的 URL,在欢迎窗口右键点击该连接,选择 Copy as URL。复制的 URL 包含密码和连接的各项选项。

也可以直接打开 SQLite 数据库文件:1

open -a TablePlus ~/Desktop/acme_store.sqlite

连接 URL 格式

连接 URL 的格式如下:

driver://user:password@host:port/database?option=value&option=value

要通过 SSH 连接,在 scheme 后加 +ssh,并把 SSH 服务器放在前面:

driver+ssh://ssh_user:ssh_password@ssh_host:ssh_port/user:password@host:port/database?option=value

所有值必须 URL 编码。省略端口则使用该驱动的默认端口。

支持的 scheme:postgresql(或 postgres)、mysql、mariadb、sqlserver(或 microsoftsqlserver)、redshift、cockroach、greenplum、vertica、oracle、clickhouse、cassandra、redis、mongodb、elasticsearch、duckdb、d1(或 cloudflared1)和 sqlite。从欢迎窗口导入 URL 时,还支持 snowflake、bigquery 和 libsql。

连接选项:

| 选项 | 说明 | 示例 | | --- | --- | --- | | name | 连接名称 | name=Acme%20Production | | statusColor | 状态栏颜色,不带 # 的十六进制值 | statusColor=007F3D | | env | 标签名称 | env=production | | windowMode | isolated 打开新窗口(默认),tabbed 在当前窗口打开新标签页 | windowMode=tabbed | | tLSMode | SSL 模式 | tLSMode=0 | | usePrivateKey | 使用 SSH 私钥 | usePrivateKey=true | | safeModeLevel | 安全模式级别,0 到 2 | safeModeLevel=0 | | advancedSafeModeLevel | 高级安全模式级别,0 或 1 | advancedSafeModeLevel=0 | | driverVersion | 驱动版本 | driverVersion=0 | | lazyload | 懒加载各 schema 中的条目 | lazyload=true |

要获取 tLSMode 和安全模式选项的正确值,最简单的方法是先在连接表单中设置好,然后用 Copy as URL。

带筛选打开表

还可以指定 TablePlus 打开哪张表以及如何筛选。在 URL 中添加以下选项:

| 选项 | 说明 | 示例 | | --- | --- | --- | | schema | 表所在的 schema(或数据库) | schema=public | | table | 要打开的表或视图(view 和 item 也可用) | table=orders | | column | 筛选的列 | column=status | | operation | 筛选运算符(operator 也可用),同筛选器中的选项 | operation=Contains | | value | 筛选值 | value=shipped | | condition | 原生 SQL 条件,替代 column、operation 和 value(raw 和 query 也可用) | condition=id%3D29%20OR%20id%3D28 |

按某列筛选打开 orders 表:

open -a TablePlus "postgresql://[email protected]/acme?schema=public&table=orders&column=status&operation=Contains&value=shipped"

用原生 SQL 条件打开 orders 表:

open -a TablePlus "postgresql://[email protected]/acme?schema=public&table=orders&condition=id%3D29%20OR%20id%3D28"

TablePlus 会建立连接,在新标签页中打开该表,并把条件作为原生 SQL 筛选应用。

open 命令仅适用于 macOS。↩︎

评论 (0)