SQL Client

当客户端工具默认不支持 Redis，或已有支持无法满足使用需求时，可以选择 dbVisitor 提供的 JDBC 驱动，在 DataGrip、DBeaver 等 SQL Client 中访问数据源。

准备驱动

从 Maven 中央仓库下载单包驱动：jdbc-redis-6.8.1-alone.jar。

alone 已包含运行依赖，只加载这个文件，不再添加普通驱动包或 SDK JAR。运行驱动的 Java 环境需为 17 或以上。编程开发的依赖配置见引入依赖。

项目	配置
驱动名称	dbVisitor Redis
驱动类	`net.hasor.dbvisitor.driver.JdbcDriver`
主机	`127.0.0.1`
端口	`6379`
数据库	`0`

数据库名填写数字编号，如 0。URL 前缀是 jedis，数据库编号放在 database 参数中，不写成 /0。

DataGrip URL 模板
jdbc:dbvisitor:jedis://{host}:{port}\?database={database}

DBeaver URL 模板
jdbc:dbvisitor:jedis://{host}:{port}?database={database}

模板变量对应连接配置中的字段。填入上述示例值后，生成的 JDBC URL 为：

jdbc:dbvisitor:jedis://127.0.0.1:6379?database=0

仅密码认证时，只填写 Password，User 留空；使用 ACL 账号时同时填写两项。示例面向本地非 TLS 服务；安全连接和自定义配置见建立连接与连接参数，不要把密码、token 放入 URL。

官方操作说明：添加自定义 JDBC 驱动。工具界面与操作流程可参照该说明，JAR、驱动类和 URL 模板使用本页给出的配置。

打开 File → Data Sources → Drivers，点击 +，按上表填写驱动名称。
在 Driver Files → + → Custom JARs 中选择下载的 JAR，Class 填入上述驱动类。
在 General → URL templates 中添加上面的 DataGrip 模板，点击 Apply → Create Data Source。
选择模板对应的连接类型，填写连接字段并核对生成的 URL。点击 Test Connection，测试通过后保存。
打开查询控制台，事务模式选择 Auto，Switch schema 设为 Disable。

测试连接前，按需在数据源的 Advanced 页签添加驱动参数键值对，不填入 VM options。位置见官方连接属性说明。例如名称填 timeZone、值填 UTC；可用名称和值见本驱动的连接参数。

官方操作说明：驱动管理器与主要配置项。其中介绍了驱动类、URL 模板和依赖文件的配置位置，具体值使用本页提供的内容。

打开 数据库（Database）→ 驱动管理器（Driver Manager）→ 新建（New），填写驱动名称，类型选择 Generic。
在 库（Libraries）→ 添加文件（Add File） 中选择下载的 JAR；按上文设置 Class Name、Default Port，URL Template 使用上面的 DBeaver 模板。
保存驱动，用它新建数据库连接，填写连接字段，点击 Test Connection，通过后完成配置。
打开该连接的 SQL 编辑器 → 新建 SQL 脚本，保持 自动提交（Auto-commit）。

测试连接前，按需在连接设置的 Driver properties（驱动属性） 中添加参数键值对，位置见官方驱动属性说明。名称和值以本驱动的连接参数为准，例如 timeZone=UTC。

两个工具中，同名参数若已写入 JDBC URL，均以 URL 中的值为准。

选中完整命令执行：

PING

正常连接时返回 PONG。

SQL Client 只是执行入口，这里仍使用 Redis 命令，不会自动转换任意关系型 SQL。完整语法见命令参考。

若工具使用 SELECT 1 等不支持的默认验证语句，可在其允许自定义时改用上面的命令。连接或元信息读取失败时，结合使用限制排查；JDBC 连通不等于支持工具的全部语法补全和表格编辑功能。