数据库

功能的

SQLly 如今能连接的 30 种引擎——从 SQL Server、PostgreSQL 到 DuckDB、ClickHouse、Oracle 和 Redis——每种引擎上有哪些工具可用,以及如何连接。

SQLly 支持 38 个数据库引擎。其中三十种 今天 通过原生 Rust 驱动连接,围绕这些引擎实际使用的七种线路协议和文件格式分组,其中一个根本不是 SQL 数据库。其余八个是 完整性能分析: SQLly 了解它们的能力、引号规则、行数限制和类型存储,实时连接器仍在路上。

每个第一方引擎也都有自己的页面,说明在该引擎上可用的功能、如何连接,以及哪些功能不适用,从 SQLly 可连接的数据库.

每个引擎都有一份能力档案。 无论今天能不能连上,每个引擎都会描述自己支持的操作和关键字、标识符加引号规则、行数上限、upsert 以及类型映射。正因如此,一个操作才能为每个引擎生成正确的方言,工具也能在你打开它之前就说明这个引擎没有对应功能。

立即连接,原生驱动

协议兼容的引擎共享一个驱动程序:PostgreSQL 协议的引擎使用 PostgreSQL 连接器,MySQL 系列共享 MySQL 的连接器,兼容 Redis 的存储共享 Redis 连接器。兼容性保持明确,因此托管或分布式引擎会说明它使用的是哪种原生协议以及有哪些差异。

TDS - SQL Server 系列

引擎SQL 方言备注
Microsoft SQL ServerT-SQL第一方。默认模式 dbo, [bracket] 加引号, SELECT TOP n.
Azure SQL 数据库T-SQL托管型 SQL Server;支持 Entra ID 登录和 Azure 发现。无 SQL Agent。

PostgreSQL wire

引擎兼容备注
PostgreSQL-第一方。默认模式 public, "double-quote" 加引号, LIMIT, ILIKE, RETURNING, ON CONFLICT upsert。
CockroachDBPostgreSQL通过 pg 协议的分布式 SQL。没有 VACUUM,因此维护菜单不可用;没有存储过程模式或安全编辑器。
YugabyteDBPostgreSQL通过 pg 协议的分布式 SQL(YSQL,端口 5433)。
Amazon Aurora PostgreSQLPostgreSQLAWS 托管的 PostgreSQL 兼容版本。支持 IAM 登录。
Amazon RDS for PostgreSQLPostgreSQLAWS 托管的 PostgreSQL。支持 IAM 登录。
Azure Database for PostgreSQLPostgreSQL灵活服务器。 需要 TLS。
Google Cloud SQL for PostgreSQLPostgreSQLGCP 管理的 PostgreSQL。支持 IAM 登录。
NeonPostgreSQL无服务器 PostgreSQL。 需要 TLS。
SupabasePostgreSQLSupabase 托管的 PostgreSQL。

MySQL 协议

引擎兼容备注
MySQL-第一方。 `backtick` 加引号, LIMIT, ON DUPLICATE KEY upsert。
MariaDBMySQL添加序列和 RETURNING;它自己的执行计划(ANALYZE FORMAT=JSON)和活动方言。
Amazon Aurora MySQLMySQLAWS 托管的 MySQL 兼容版本。
Amazon RDS for MySQLMySQLAWS 托管的 MySQL。
Azure Database for MySQLMySQL灵活服务器。 需要 TLS。
Google Cloud SQL for MySQLMySQLGCP 管理的 MySQL。
PlanetScaleMySQL基于 Vitess。 需要 TLS。 没有维护菜单或安全编辑器。
TiDBMySQL分布式 SQL(端口 4000);没有存储过程,也没有 OPTIMIZE TABLE.

进程内文件

引擎SQL 方言备注
SQLiteSQLite文件或内存数据库,可直接打开。日期和 UUID 为文本编码;没有存储过程。双击一个 .sqlite, .db,或 .sqlite3 文件来打开它。
DuckDBPostgreSQL 系列内置——无需安装。一个 .duckdb 文件,或者 :memory:,没有凭据。实际计划(EXPLAIN / EXPLAIN ANALYZE), read_parquet / read_csv / read_json 离线。 正在连接

HTTP

引擎SQL 方言备注
ClickHouseClickHouse(MySQL 家族语法)其 HTTP 接口 - 端口 8123,启用 TLS 时为 8443。结果随 ClickHouse 发送即流式返回;宽整数和小数都保留全部位数。不支持事务,因此回滚包装会被预先拒绝。 正在连接
libSQL / TursoSQLite基于 HTTP 的 Hrana - 自托管 sqld 端口 8080,或通过 HTTPS 连接 Turso Cloud。登录时使用保存在操作系统钥匙串中的认证令牌。 正在连接

Oracle Net

引擎SQL 方言备注
Oracle 数据库Oracle(FETCH FIRST, MERGE,PL/SQL)端口 1521;服务名,或者 SID: 通过 SID 连接。需要在你的机器上安装免费的 Oracle Instant Client 在你的机器上——“测试连接”会准确告诉你要安装什么。 正在连接

RESP - Redis 家族

引擎兼容备注
Redis-不是 SQL:查询标签页按 redis-cli 语法每行运行一条命令,资源管理器是按前缀分组的键浏览器。端口 6379, redis:// 或者 rediss://. 正在连接
ValkeyRedisLinux 基金会的分支,通信协议兼容。
KeyDBRedis多线程分支;不支持 FUNCTION LIST.
DragonflyDBRedis兼容 Redis 的内存存储; CLIENT LIST 省略用户列。
Amazon ElastiCacheRedisRedis 或 Valkey;传输中加密即 TLS 要求 或者 完全验证。通过配置端点支持集群模式(Redis Cluster).
Amazon MemoryDBRedis需要 TLS;ACL 用户名填在用户名字段中。始终为集群:命令按槽位路由(Redis Cluster).

功能适用范围

凡在引擎上有对应功能的工具,都会基于该引擎自己的系统目录和系统视图工作。引擎没有对应功能时,菜单项仍然可见,并说明原因 - “DuckDB 在 SQLly 中运行,没有服务器会话需要监控” - 而不是等你点了才失败。线路兼容的标签继承其基础引擎那一列的内容,除非它们自己那一行另有说明。

工具SQL ServerPostgreSQLMySQL / MariaDBSQLitelibSQL / TursoDuckDBClickHouseOracleRedis
资源管理器、IntelliSense、悬停卡片、对象浏览器是是是是是是是是键浏览器
估计计划是是是是是是是是-
实际计划是是是--是---
行编辑器是是是是-是---
维护菜单是是是是是是是是-
服务器仪表板是是是是是是是是是
活动监视器是是是---是是是
查询洞察是是是---是-是
磁盘使用情况是是是是是是是是是
索引分析器是是是------
备份 / 恢复是是是---是--
模式比较与历史是是是是是是是--
数据比较是是是是是是是--
数据传输(作为目标)是是是是-是是--
结构编辑器是是是是是是是--
测试数据生成器是是是是是是是--
依赖关系(查看依赖 / 查找用法)是是是是是是是--
安全编辑器是是是---只读视图--
设计器、扩展事件、SQL Agent是--------
过程模式是是-------
手动提交模式是是是------
SSH 隧道、代理、Kubernetes 端口转发是是是-是-是-是

每个破折号背后的解释都是应用自己给出的原话。SQLite、libSQL 和 DuckDB 不记录索引使用计数,因此无内容可分析;DuckDB 运行在 SQLly 内部,没有可监控的服务器会话,而 libSQL 各自独立处理请求、没有会话列表;ClickHouse 没有 EXPLAIN ANALYZE 并且没有行级别的 UPDATE (在查询标签页中使用 ALTER TABLE … UPDATE 在查询标签页中运行);Oracle 的执行计划来自 EXPLAIN PLAN 而无需执行。其备份通过服务器上的 RMAN 或 Data Pump 运行,Oracle 客户端直接连接监听器,因此隧道和代理目前不适用;Redis 没有模式、表、索引或执行计划,并通过 ACL SETUSER管理用户。SQL Agent、扩展事件和引导式设计器是 SQL Server 专属功能,页面中也会如实注明。

连接到较新的引擎

SQL Server、PostgreSQL、MySQL 和 SQLite 的连接方式如你所预期。下面的每个引擎在第一次连接之前都有一个值得了解的特点。

DuckDB

DuckDB 已随 SQLly 内置,无需安装任何东西。请选择 DuckDB 在连接编辑器中,在“服务器”字段输入文件路径(不存在则会新建)或 :memory: 即可得到一个临时数据库,SQLly 运行期间一直存在。无需凭证,无需端口。双击或拖入一个 .duckdb 或者 .ddb 文件即可直接打开,连接 URL 输入框也支持 duckdb:/path/to/analytics.duckdb, duckdb::memory:,或者一个裸的 .duckdb 路径。

DuckDB 的列表、结构体和映射在网格中显示为 JSON 文本。备份就是文件本身,复制它,或运行 EXPORT DATABASE - 而且没有创建数据库的对话框,因为一个 DuckDB 数据库 是 一个文件。维护菜单提供 VACUUM, VACUUM ANALYZE, ANALYZE, CHECKPOINT 和 FORCE CHECKPOINT.

ClickHouse

选择 ClickHouse,输入主机、HTTP 端口(8123,或 8443 使用 TLS)、一个用户和密码,以及可选的数据库 - 或粘贴一个 clickhouse://user:password@host:8123/database URL。任何 TLS 模式 除禁用之外的任何选项都会把连接切换到 HTTPS;SSH 隧道、代理和 Kubernetes 端口转发的工作方式与 PostgreSQL、MySQL 相同。

可选的 原生端口 字段是服务器的原生协议 TCP 端口。SQLly 本身只讲 HTTP;该字段由 在终端中打开,因为 clickhouse-client 使用原生协议。常规映射(9000,启用 TLS 时为 9440)就留空即可。在 SSH 隧道连接上,终端会有自己到该端口的转发。

包含多条语句的脚本会逐条运行,并报告每个结果集或写入的行数;取消会停止服务器上的查询。查询洞察读取 system.query_log (排名靠前的查询和最近的失败),估计计划会显示每个索引裁剪掉的 parts 和 granules,数据传输会以 MergeTree 创建目标表,备份/恢复脚本 BACKUP / RESTORE DATABASE 到服务器的备份磁盘,维护菜单里唯一的动作就是 OPTIMIZE TABLE … FINAL。创建和删除数据库用 CREATE DATABASE / DROP DATABASE 在查询标签页中。

Oracle 数据库

SQLly 的 Oracle 驱动会加载 Oracle 的免费 Instant Client (Basic 或 Basic Light),所以请先从 oracle.com 并重新启动 SQLly。如果缺失,“测试连接”会明确指出它查找了哪个库以及位置:

  • macOS - Apple Silicon(ARM64)DMG 安装程序;SQLly 会查找 libclntsh.dylib in ~/lib, /usr/local/lib,或 DYLD_LIBRARY_PATH.
  • Linux - 解压 Basic 压缩包,把其中的文件夹添加到 LD_LIBRARY_PATH 或者一个 ldconfig 目录;SQLly 会查找 libclntsh.so.
  • Windows - 解压 Basic 压缩包,把其中的文件夹放到 PATH;SQLly 会查找 oci.dll.
  • 在任何平台上, SQLLY_ORACLE_CLIENT_DIR 设为 Instant Client 文件夹时,会覆盖自动搜索。

然后选择 Oracle 数据库,输入主机、端口(1521)、 服务名称 在数据库字段中,以 SID: 改为通过 SID 连接,或者在服务器字段中为 TCPS 或钱包填写完整连接描述——以及你的用户名和密码。添加  AS SYSDBA 或者  AS SYSOPER 放在用户名后面,用于管理会话。

PL/SQL 块以 / 单独显示为一行, DBMS_OUTPUT 行会显示在消息窗格中,资源管理器会显示模式、表、视图、包、序列、同义词和类型。维护菜单会收集统计信息(DBMS_STATS)、验证结构并重建索引。行编辑、安全编辑器、备份以及比较和传输工具在 Oracle 上尚不可用,每个工具都会显示这一信息。

libSQL 和 Turso

选择 libSQL / Turso,输入主机、 …turso.io 地址,或者运行 sqld ,端口 8080 - 并粘贴数据库的 认证令牌 替代用户名和密码(对于无认证的本地服务器可以留空)。对于 Turso,可以使用 turso db tokens create <database> 或从 Turso 控制台创建令牌;SQLly 会把它保存在操作系统的安全存储中,Turso 主机则始终通过 HTTPS 访问。URL 输入框接受 libsql://name-org.turso.io?authToken=…,或 http://127.0.0.1:8080 用于本地 sqld.

它是 SQLite 的网络方言,因此读取 sqlite_master 的工具——模式比较、数据比较、测试数据生成器、结构编辑器、依赖项——的工作方式与 SQLite 相同。脚本作为一个单元运行,所以 BEGIN … COMMIT 以及回滚包装是怎么工作的;取消会放弃请求而不是打断服务器,而且整个结果会先于第一行完整到达,因此读取超大数据要分页时请用 LIMIT/OFFSET。服务器拒绝 VACUUM 和 ANALYZE,因此维护菜单提供了 REINDEX 以及完整性检查。行编辑和向 libSQL 的数据传输功能尚未提供。

Redis、Valkey、KeyDB、DragonflyDB、ElastiCache 和 MemoryDB

选择 Redis (或与你的服务器匹配的兼容标签),输入主机、端口(6379)、如果服务器启用了 ACL,则是 ACL 用户名,以及密码、可选的逻辑数据库编号和 TLS 模式,或者粘贴一个 redis://user:password@host:6379/2 或者 rediss:// URL。隧道、代理和端口转发的工作方式与 SQL 引擎相同。

  • 用命令,而不是 SQL。 查询标签页会 每行一个命令 语法与 redis-cli (引号和转义都支持,特殊值也可以用 JSON 参数列表)。每个回复都会作为一个结果集返回——哈希是字段/值行,有序集合是成员/分数, INFO 作为 section/key/value, CLIENT LIST 和 SLOWLOG 作为表格。 SELECT 切换逻辑数据库以便接下来的脚本使用,并且会拒绝发送那些会永远挂起的命令(SUBSCRIBE, MONITOR,比如不带超时的阻塞式弹出)都会在发送前就被拒绝。
  • 键浏览器。 资源管理器会列出带键数量的编号数据库,用有边界的非阻塞扫描遍历键,并按你选择的分隔符将它们折叠成文件夹(: 默认情况下如此,因此 user:42:profile 位于下方,即 user → 42)。每个键都会显示其类型和剩余 TTL;双击某个键,就会为它的类型运行相应的读取器 - GET, HGETALL, LRANGE, SMEMBERS, ZRANGE 带有分数, XRANGE, JSON.GET - 并且键菜单提供复制键、复制命令、设置 TTL、移除 TTL 和删除键,这些操作会先进行确认。
  • 只读意味着只读命令。 仅限 SELECT 的锁定和 AI 的只读模式只允许只读命令;破坏性的命令 - FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN 及相关命令——会经过常规确认。服务器仪表板会读取 INFO,活动监视器读取 CLIENT LIST (使用 kill),Query Insights 读取慢查询日志,Disk Usage 显示每个逻辑数据库的内存。

已建模 - 驱动即将推出

这些引擎在能力模型中已有完整描述,因此 SQLly 能为它们生成 SQL、标识符引用和类型映射。它们还没有原生连接器,这意味着目前无法从应用建立实时连接。

引擎通过以下方式连接SQL 方言
IBM Db2DRDAOracle 系列
IBM InformixDRDAOracle 系列 (SELECT FIRST n)
Microsoft AccessODBC / ACESQL Server 系列(功能受限)
SnowflakeHTTP APIPostgreSQL 系列 (GoogleSQL,QUALIFY, MERGE)
Databricks SQLHTTP APIPostgreSQL 系列(Spark SQL)
Google Cloud SpannerHTTP APIPostgreSQL 系列 (Spark SQL) INSERT OR UPDATE)
Teradata专有Oracle 系列 (SELECT TOP n, QUALIFY)
SAP HANA专有Oracle 系列

一个意图,各引擎的 SQL

因为引擎规则都放在模型里,同一个 UI 操作无论在哪里运行都能呈现正确的方言。行数限制就是一个熟悉的例子:“查看前 1000 行”会变成:

模式渲染后的 SQL引擎
TOPSELECT TOP 1000 …SQL Server、Azure SQL、Access、Teradata
LIMIT… LIMIT 1000PostgreSQL 系和 MySQL 系,以及 SQLite、libSQL、DuckDB、ClickHouse、Snowflake
FETCH FIRST… FETCH FIRST 1000 ROWS ONLYOracle, Db2
FIRSTSELECT FIRST 1000 …Informix

同样的各引擎专属处理涵盖标识符加引号、字符串、布尔和二进制字面量、upsert(ON CONFLICT, ON DUPLICATE KEY,或 MERGE),以及全部 15 种逻辑类型如何映射到原生存储。Redis 没有行的概念,它把每种逻辑类型都映射成二进制安全的字符串,把每次写入都映射成一次键设置。