# 使用 DBeaver 访问 Aurora DSQL
<a name="accessing-dbeaver"></a>

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

## DBeaver Pro
<a name="dbeaver-pro"></a>

从版本 25.3 开始，DBeaver PRO 产品提供与 Aurora DSQL 的原生集成。按照 [DBeaver Documentation](https://dbeaver.com/docs/dbeaver/Database-driver-Aurora-DSQL/) 中的说明连接到 Aurora DSQL 集群。

## DBeaver 社区版
<a name="dbeaver-community"></a>

DBeaver 社区版是免费的开源版本。请访问[下载页面](https://dbeaver.io/download/)以查看安装说明。要从 DBeaver 社区版连接到 DSQL，您需要安装 [Aurora DSQL Plugin for DBeaver](https://github.com/awslabs/aurora-dsql-dbeaver-plugin)。

[Aurora DSQL Plugin for DBeaver](https://github.com/awslabs/aurora-dsql-dbeaver-plugin) 在 [Aurora DSQL Connector for JDBC](https://github.com/awslabs/aurora-dsql-jdbc-connector) 之上构建，支持对 Aurora DSQL 集群进行 IAM 身份验证。它可通过 DBeaver UI 方便地安装，无需编写令牌生成代码或手动提供有效的 IAM 令牌，从而简化了身份验证，同时消除了与传统用户生成的密码关联的安全风险。

### 功能
<a name="features"></a>
+  IAM 身份验证支持：使用 AWS IAM 凭证连接到 Aurora DSQL 集群，以实现安全、免密码的身份验证 
+  自动驱动程序管理：无缝地安装和配置适用于 JDBC 的 Aurora DSQL 连接器 
+  灵活的连接选项：在基于主机的连接配置或基于 JDBC URL 的连接配置之间选择 

### 适用于 DBeaver 的 Aurora DSQL 插件安装
<a name="installation"></a>

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

1.  单击**添加**以添加新的存储库 

1.  输入：
   +  **名称**：`Aurora DSQL Plugin`
   +  **位置**：`https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/`

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

1.  单击**下一步**，接受许可证，然后完成安装 

1.  当系统提示时，重新启动 DBeaver 

### 创建 Aurora DSQL 连接
<a name="create-connection"></a>

1.  单击**新建数据库连接** 

1.  选择 **Aurora DSQL** 

1.  在**服务器**下，为**连接方式**设置选择以下选项之一 
   + **主机** 
     +  为以下字段启用用户界面文本输入：
       +  **端点：**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 查询参数格式作为第一个参数，并为后续参数附加一个 &。

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

1.  单击**完成** 

## 问题排查
<a name="troubleshooting"></a>

### Windows Trust Store 问题
<a name="windows-trust-store"></a>

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

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

**解决方案：**

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

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

### 缺失驱动程序错误
<a name="missing-driver"></a>

如果您看到缺失驱动程序图标或连接错误，则说明您当前的 DBeaver 版本中可能未安装 Aurora DSQL（社区插件）。以下是一些错误示例及其修复方法：
+ 创建与缺失驱动程序的新连接：  
![\[DBeaver 中的缺失驱动程序图标\]](http://docs.aws.amazon.com/zh_cn/aurora-dsql/latest/userguide/images/dbeaver-missing-driver-icon.png)
+ 尝试在没有驱动程序的情况下进行连接：  
![\[缺失驱动程序时的错误对话框\]](http://docs.aws.amazon.com/zh_cn/aurora-dsql/latest/userguide/images/dbeaver-version-error-dialog.png)

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

**解决方案：**按照上述安装步骤重新安装 Aurora DSQL（社区插件）。



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