使用 DBeaver 访问 Aurora DSQL - Amazon Aurora DSQL

使用 DBeaver 访问 Aurora DSQL

DBeaver 是一款通用 SQL 客户端,可用于管理任何具有 JDBC 驱动程序的数据库。由于其强大的数据查看、编辑和管理功能,该工具被开发人员和数据库管理员广泛使用。使用 DBeaver 的云连接选项,可将 DBeaver 以原生方式连接到 Aurora DSQL。

DBeaver Pro

从版本 25.3 开始,DBeaver PRO 产品提供与 Aurora DSQL 的原生集成。按照 DBeaver Documentation 中的说明连接到 Aurora DSQL 集群。

DBeaver 社区版

DBeaver 社区版是免费的开源版本。请访问下载页面以查看安装说明。要从 DBeaver 社区版连接到 DSQL,您需要安装 Aurora DSQL Plugin for DBeaver

Aurora DSQL Plugin for DBeaverAurora DSQL Connector for JDBC 之上构建,支持对 Aurora DSQL 集群进行 IAM 身份验证。它可通过 DBeaver UI 方便地安装,无需编写令牌生成代码或手动提供有效的 IAM 令牌,从而简化了身份验证,同时消除了与传统用户生成的密码关联的安全风险。

功能

  • IAM 身份验证支持:使用 AWS IAM 凭证连接到 Aurora DSQL 集群,以实现安全、免密码的身份验证

  • 自动驱动程序管理:无缝地安装和配置适用于 JDBC 的 Aurora DSQL 连接器

  • 灵活的连接选项:在基于主机的连接配置或基于 JDBC URL 的连接配置之间选择

适用于 DBeaver 的 Aurora DSQL 插件安装

  1. 打开 DBeaver 后,转至下拉菜单帮助安装新软件

  2. 单击添加以添加新的存储库

  3. 输入:

    • 名称Aurora DSQL Plugin

    • 位置https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/

  4. 选择适用于 JDBC 的 Aurora DSQL 连接器

  5. 单击下一步,接受许可证,然后完成安装

  6. 当系统提示时,重新启动 DBeaver

创建 Aurora DSQL 连接

  1. 单击新建数据库连接

  2. 选择 Aurora DSQL

  3. 服务器下,为连接方式设置选择以下选项之一

    • 主机

      • 为以下字段启用用户界面文本输入:

        • 端点:DSQL 集群端点

        • 用户名:DSQL 用户名(例如 admin)

        • AWS 配置文件:例如,默认配置文件,即未指定特定配置文件时使用的标准配置文件

        • AWS 区域(可选):必须与您的 DSQL 集群所在的区域匹配,否则身份验证将失败

    • URL

      • 采用以下格式的 JDBC URL:

        jdbc:aws-dsql:postgresql://{cluster_endpoint}/{database}?user=admin&profile=default&region=us-east-1
      • 注意:在此模式下,仅启用 URL 输入。为了向 JDBC 连接字符串添加参数,请使用以 ? 开头的 URL 查询参数格式作为第一个参数,并为后续参数附加一个 &。

  4. 单击测试连接以验证 Aurora DSQL 连接是否有效

  5. 单击完成

问题排查

Windows Trust Store 问题

Windows 用户在从 Maven Central 下载适用于 JDBC 的 Aurora DSQL 连接器驱动程序时可能会遇到问题。

原因:Windows Trust Store 可能不包含访问 Maven Central 存储库所需的证书。

解决方案:

  1. 以“管理员”身份运行 DBeaver

  2. 取消选中此设置:Windows > 偏好设置 > 连接 >“使用 Windows Trust Store”

缺失驱动程序错误

如果您看到缺失驱动程序图标或连接错误,则说明您当前的 DBeaver 版本中可能未安装 Aurora DSQL(社区插件)。以下是一些错误示例及其修复方法:

  • 创建与缺失驱动程序的新连接:

    DBeaver 中的缺失驱动程序图标
  • 尝试在没有驱动程序的情况下进行连接:

    缺失驱动程序时的错误对话框

原因:安装多个 DBeaver 版本时,连接设置是共享的,但驱动程序是按应用程序单独安装的。

解决方案:按照上述安装步骤重新安装 Aurora DSQL(社区插件)。

重要

DBeaver 为 PostgreSQL 数据库提供的管理功能(如会话管理器锁定管理器)由于其独特的架构而不适用于 Aurora DSQL 数据库。虽然这些屏幕可供访问,但它们不提供有关数据库运行状况或状态的可靠信息。