使用 DBeaver 访问 Aurora DSQL
DBeaver 是一款通用 SQL 客户端,可用于管理任何具有 JDBC 驱动程序的数据库。由于其强大的数据查看、编辑和管理功能,该工具被开发人员和数据库管理员广泛使用。使用 DBeaver 的云连接选项,可将 DBeaver 以原生方式连接到 Aurora DSQL。
DBeaver Pro
从版本 25.3 开始,DBeaver PRO 产品提供与 Aurora DSQL 的原生集成。按照 DBeaver Documentation
DBeaver 社区版
DBeaver 社区版是免费的开源版本。请访问下载页面
Aurora DSQL Plugin for DBeaver
功能
-
IAM 身份验证支持:使用 AWS IAM 凭证连接到 Aurora DSQL 集群,以实现安全、免密码的身份验证
-
自动驱动程序管理:无缝地安装和配置适用于 JDBC 的 Aurora DSQL 连接器
-
灵活的连接选项:在基于主机的连接配置或基于 JDBC URL 的连接配置之间选择
适用于 DBeaver 的 Aurora DSQL 插件安装
-
打开 DBeaver 后,转至下拉菜单帮助 → 安装新软件
-
单击添加以添加新的存储库
-
输入:
-
名称:
Aurora DSQL Plugin -
位置:
https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/
-
-
选择适用于 JDBC 的 Aurora DSQL 连接器
-
单击下一步,接受许可证,然后完成安装
-
当系统提示时,重新启动 DBeaver
创建 Aurora DSQL 连接
-
单击新建数据库连接
-
选择 Aurora DSQL
-
在服务器下,为连接方式设置选择以下选项之一
-
主机
-
为以下字段启用用户界面文本输入:
-
端点:DSQL 集群端点
-
用户名:DSQL 用户名(例如 admin)
-
AWS 配置文件:例如,默认配置文件,即未指定特定配置文件时使用的标准配置文件
-
AWS 区域(可选):必须与您的 DSQL 集群所在的区域匹配,否则身份验证将失败
-
-
-
URL
-
采用以下格式的 JDBC URL:
jdbc:aws-dsql:postgresql://{cluster_endpoint}/{database}?user=admin&profile=default®ion=us-east-1 -
注意:在此模式下,仅启用 URL 输入。为了向 JDBC 连接字符串添加参数,请使用以 ? 开头的 URL 查询参数格式作为第一个参数,并为后续参数附加一个 &。
-
-
-
单击测试连接以验证 Aurora DSQL 连接是否有效
-
单击完成
问题排查
Windows Trust Store 问题
Windows 用户在从 Maven Central 下载适用于 JDBC 的 Aurora DSQL 连接器驱动程序时可能会遇到问题。
原因:Windows Trust Store 可能不包含访问 Maven Central 存储库所需的证书。
解决方案:
-
以“管理员”身份运行 DBeaver
-
取消选中此设置:Windows > 偏好设置 > 连接 >“使用 Windows Trust Store”
缺失驱动程序错误
如果您看到缺失驱动程序图标或连接错误,则说明您当前的 DBeaver 版本中可能未安装 Aurora DSQL(社区插件)。以下是一些错误示例及其修复方法:
-
创建与缺失驱动程序的新连接:
-
尝试在没有驱动程序的情况下进行连接:
原因:安装多个 DBeaver 版本时,连接设置是共享的,但驱动程序是按应用程序单独安装的。
解决方案:按照上述安装步骤重新安装 Aurora DSQL(社区插件)。
重要
DBeaver 为 PostgreSQL 数据库提供的管理功能(如会话管理器和锁定管理器)由于其独特的架构而不适用于 Aurora DSQL 数据库。虽然这些屏幕可供访问,但它们不提供有关数据库运行状况或状态的可靠信息。