导出与导入连接

功能的

把服务器、数据库和登录(带不带密码都行)连同标签颜色和图标装进一个文件带到另一台机器,并精确挑选要包含的内容。

A 连接文件 可以一步把整套工作配置迁移到别的机器或队友那里:服务器、上面的数据库、要用的登录名,如果你愿意还包括它们的密码,连同这些连接所属的客户端、项目和环境标签,包括每个标签的 颜色 和 图标。两种导出方式写入相同的文件;唯一的区别是文件中是否包含密码。从 SQLly 导出一个,或者手动编写一个来为团队配置,然后在任何 SQLly 副本中导入它。

存有密码的文件会把密码以明文保存。 这就是它有用的原因,也是它敏感的原因。SQLly 会保存一个只有你能读取的导出文件,在导入时将每个密码移动到你的系统钥匙串,并且从不保留文件的副本。在你信任的通道中发送它,导入后删除它。要共享连接 无 密码,请使用 文件 → 导出连接….

导出连接

选择 文件 → 导出连接… 导出不带密码的文件,或者 文件 → 导出连接及凭据… 带密码的文件(这两个命令也在命令面板里)。任一操作都会打开一个选择器,把所有已保存的连接显示为一棵树:每个 服务器 (主机、端口和引擎)以及 数据库 以及你在其下方保存的凭据。“导出连接(含凭据)”打开时,顶部会警告文件将包含明文密码。

  • 选择任意或所有服务器 - 勾选某个服务器即可选中其下所有数据库,再次勾选则全部取消。
  • 选择任意或所有数据库 - 展开服务器并勾选单个数据库;服务器行显示已选择的数据库数量。
  • 全选 / 清除 一次切换所有内容。默认全部选中。
  • 只有你选择的内容会被导出 - 只包含所选连接用到的共享登录、隧道配置,以及客户端、项目和环境标签,别无其他。

点击 导出 然后选择保存位置。无论哪种方式,连接编辑器里的每一项设置都会带上,包括每个连接的登录方式。带凭据导出时,SQLly 会把每个密码、密码短语和令牌从你的钥匙串读回并写进文件;不带凭据时,所有机密信息都会省略,且 SQLly 会在保存前检查文件中确实不含任何机密。被多个导出连接共用的登录会作为共享登录只写一次;只被一个连接使用的登录则写在该连接上。标签图标会嵌入文件,因此文件本身是自足完整的。

SQLly
SQLLY 导出连接对话框,可选择包含密码及目标文件SQLLY 导出连接对话框,可选择包含密码及目标文件
导出连接对话框:选择是否包含密码,然后选择文件。

导入连接

选择 文件 → 导入连接… 然后选择文件。同一命令既能读取带密码和不带密码的文件,也能读取早期版本 SQLly 用“导出连接”保存的文件。在改动任何内容之前,它会先检查整个文件;如果有任何条目有问题,会列出全部问题并且不导入任何内容,因此不会出现只导入一半的情况。拼错的设置名会被报告出来,而不是被默默跳过。导入的连接会立即出现在服务器资源管理器中。

  • 密码会存到你的钥匙串 - macOS 上的钥匙串、Windows 上的凭据管理器、Linux 上的 Secret Service——绝不会写进 SQLly 的已保存连接文件。状态栏会显示导入了多少条。
  • 标签按名称合并 - 已存在的客户端、项目或环境会保留文件未设置的任何内容,只有文件列出的安全开关会被更改。
  • 共享登录会就地更新 - 相同名称和用户名的已保存登录会获取新密码,因此每个已经使用它的连接都会继续工作。
  • 没有密码,也没问题 - 没有密码的登录(未带凭据导出的文件里,所有登录都是如此)也照样导入,SQLly 会在你首次连接时询问密码。

从 Redis Insight 导入

在 Redis Insight 中,选择你的数据库并选择 导出 (勾选 包含密码 如果你想把它们也带过去)。在 SQLly 中选择 从其他工具导入… 并选择导出的文件,普通 JSON 或 Redis Insight 也接受的 base64 形式。每个数据库都会成为一个带有其主机、端口、逻辑数据库、ACL 用户名、SSH 隧道和 TLS 设置的 Redis 连接。

  • TLS 永远保留 - 使用 TLS(或带有 CA 或客户端证书)导出的数据库以加密方式导入: 验证 CA 当 Redis Insight 验证了服务器证书时, 要求 当没有验证时。证书和密钥内容会作为 PEM 文件保存在 SQLly 的数据文件夹中(密钥仅你可读),连接会指向它们。
  • 机密存入你的钥匙串 - 导出文件里的密码、SSH 密码和密钥口令,存储方式与连接文件里的完全一样,绝不会进已保存的连接文件。事后请删除导出文件:里面是明文。
  • Azure Entra 数据库 通过 Microsoft Entra 登录导入;在连接编辑器中选择 Azure 账户。
  • 集群数据库 导入为 Redis 集群连接,并以它们指明的节点作为种子(如果 Redis Insight 被要求强制单机模式,则导入为单个节点); Sentinel 会导入为 Sentinel 连接,带有主组、哨兵密码(已移入钥匙串)和主节点自身的登录信息;无法迁移的内容会在状态栏中列出。

连接文件可以包含的内容

部分它所包含的内容
连接任意数量的服务器以及每台服务器上的任意数量的数据库:引擎、主机、端口、数据库、环境、客户端和项目、登录方式及(凭证)密码、TLS 模式和证书文件、连接和语句超时、应用名称、启动 SQL、每连接安全开关、收藏星标、掩码规则、中继路由,以及内联 SSH 隧道、代理或 Kubernetes 端口转发。
共享登录多个命名登录(用户名,外加保存在凭据文件中的密码),可供多个连接共用。
隧道配置文件具名的 SSH(含跳板机)、代理和 Kubernetes 链式连接,SSH 密码和密钥口令则保存在凭据文件中。
客户端、项目、环境名称、颜色、图标图片(内嵌在文件里),以及任意查询保护选项。

SQLly 支持的每种登录方式都能描述:用户名和密码、Windows 集成身份验证、Microsoft Entra(浏览器或设备代码)、AWS RDS IAM、Google Cloud SQL IAM,以及 libSQL / Turso 令牌。SQLite 和 DuckDB 文件无需登录。

手工编写一个

连接文件是纯 JSON,因此管理员可以编写一个文件来为团队提供现成的设置。只有连接的 name, engine,以及 server 是必需的——其余一切都会回退到连接编辑器所用的默认值。这个文件在一台服务器上添加了共用一个只读登录的两个数据库,又添加了一台有自己密码的第二服务器,以及一个带图标的彩色客户端:

{
  "format": "sqlly-credentials",
  "version": 1,
  "clients": [
    { "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
  ],
  "sql_auth_accounts": [
    { "name": "Reader", "username": "ro", "password": "ro-secret" }
  ],
  "connections": [
    { "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
      "client": "Acme", "environment": "production",
      "authentication": { "type": "sql-login", "account": "Reader" },
      "tls": { "mode": "verify-full" } },
    { "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
      "client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
    { "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
      "authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
  ]
}
  • 引擎 可以松散地编写—— postgres, PostgreSQL, mssql, sql-server, mysql, sqlite, duckdb, clickhouse, redis,等等。
  • 颜色 是 #RGB, #RRGGBB,或 #RRGGBBAA.
  • 图标 是 base64——一个 data:image/…;base64, URI,或不带前缀的 base64 —— PNG、JPEG、GIF、WebP、BMP、ICO 或 SVG 图像,最大 1 MB。
  • 环境 是 local, dev, test, staging,或 production.

预配置连接(Docker、Kubernetes、托管机器)

与其只导入一次文件,不如让 SQLly 配置 连接——在桌面应用中,在 sqlly-cli 智能体命令,以及自托管的 sqlly-bridge embedded 服务器上。将 SQLLY_PROVISIONED_CONNECTIONS_FILE 一个文件(或者放在 provisioned-connections.json 放在 SQLly 的设置文件夹中,紧挨着 connections.json),和/或设置一个 SQLLY_CONNECTION_<NAME> 保存其 URL 的变量。该文件使用上述连接文件格式(format 和 version 可以省略,只读取 connections 会被读取),而且任何连接都可以给出一个 url 而不是它的引擎、服务器、端口、数据库和登录字段:

{
  "connections": [
    { "name": "Cache",
      "url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
      "environment": "production" },
    { "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
      "authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
      "tls": { "mode": "verify-full" } }
  ]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=...        # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
  • Sentinel URL - redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>],带有 rediss+sentinel:// 用于 TLS 的 valkey+sentinel:// / valkeys+sentinel:// 用于 Valkey。 ?sentinelPassword= 设置哨兵自身的密码并 ?preferReplica=true 向副本发送只读脚本。未带端口的哨兵使用 26379。同样的 URL 也可用于连接编辑器中的“粘贴 URL”。
  • ${VARIABLE} 文件中的任何位置(或 SQLLY_CONNECTION_ URL 中)都将被该环境变量替换;写作 $${ 表示字面量 ${.
  • 密码不存储在文件中 - 密码、令牌、 redis_sentinel_password,URL 里的密码,或者 sentinelPassword 只要原样写成 ${VARIABLE} 每次 SQLly 连接时都会从环境变量里读取,并且绝不会复制进配置文件,也不会存到任何地方。
  • 托管、只读 - 预配置的连接会和你自己的连接并列显示,但绝不会写入 connections.json,而且对它们来说保存和删除都会被拒绝:请改为修改文件或变量,或者用 创建副本 来创建你自己的可编辑副本。
  • 单个条目出问题,也不会卡住其余条目 - 未知设置、未设置的变量或读不了的 URL 只跳过那一个连接,并打印一条警告说明是哪个、为什么;之后碰到重名的连接也会同样跳过。
  • 在桥接程序上 - sqlly-bridge embedded 会把它们作为只读配置文件 provisioned (也可以通过 --provisioned-connections <file>);启动令牌可以像引用其他配置文件一样引用它,而且它绝不会写入状态目录。