docs: dbeaver

zh_CN/integration/datalayers-with-dbeaver.md

@@ -1,58 +1,78 @@
 ---
-title: "Datalayers 集成 DBeaver 指南"
-description: "介绍如何将 Datalayers 集成到 DBeaver，包括 Arrow Flight SQL JDBC 驱动配置、连接参数设置与常见使用步骤。"
+title: "Datalayers 集成 DBeaver 使用指南"
+description: "介绍如何在 DBeaver 中通过 PostgreSQL 或 Arrow Flight SQL 协议连接 Datalayers，包括驱动配置、连接参数设置和基础 SQL 操作。"
 ---
-# Datalayers 集成 DBeaver 指南
+# Datalayers 集成 DBeaver 使用指南
 
-[DBeaver](https://github.com/dbeaver/dbeaver) 是常用的开源数据库管理工具，适合用于连接、查询和管理多种数据库。从 Datalayers 2.2.4 开始，可以通过 Arrow Flight SQL JDBC 驱动在 DBeaver 中连接和管理 Datalayers。
+[DBeaver](https://github.com/dbeaver/dbeaver) 是一款常用的开源数据库管理工具，可用于连接数据库、浏览对象、执行 SQL 查询以及进行基础数据管理。
 
-该方案适用于希望使用图形化客户端浏览库表、执行 SQL、查看结果集和进行日常调试的场景。
+Datalayers 支持 PostgreSQL 协议和 Arrow Flight SQL 协议。你可以根据实例配置与使用场景，在 DBeaver 中选择对应协议连接并访问 Datalayers。
 
-## 前置条件
+## 使用 PostgreSQL 协议接入
+
+### PostgreSQL 接入条件
+
+- 已安装 Datalayers，版本不低于 `v2.4.1`
+- 已安装 DBeaver，可参考 [DBeaver 安装文档](https://github.com/dbeaver/dbeaver/wiki/Installation)
+- Datalayers 实例已启用 PostgreSQL 协议监听服务
+- 已获取 Datalayers 实例地址、PostgreSQL 协议端口、用户名和密码
+
+### 如何接入
+
+在 DBeaver 中新建数据库连接时，选择内置的 **PostgreSQL** 驱动，并填写 Datalayers 实例地址、端口、用户名和密码。连接成功后，即可在 DBeaver 中浏览数据库对象并执行 SQL 查询。
+
+## 使用 Arrow Flight SQL 接入
+
+### Arrow Flight SQL 接入条件
 
 - 已安装 Datalayers，版本不低于 `v2.2.4`
 - 已安装 DBeaver，可参考 [DBeaver 安装文档](https://github.com/dbeaver/dbeaver/wiki/Installation)
 - 已下载 [Arrow Flight SQL JDBC Driver](https://mvnrepository.com/artifact/org.apache.arrow/flight-sql-jdbc-driver/19.0.0)
-- 已获取 Datalayers 实例地址、端口、用户名和密码
+- 已获取 Datalayers 实例地址、Arrow Flight SQL 协议端口、用户名和密码
 
-## 配置 DBeaver
+### 配置 DBeaver
 
-Datalayers 支持 Arrow Flight SQL 协议，因此可以通过在 DBeaver 中新增自定义驱动的方式完成接入。
+DBeaver 默认不内置 Arrow Flight SQL 驱动，需要先通过驱动管理器添加自定义 JDBC 驱动。
 
-1. 启动 DBeaver，在菜单中点击数据库，选择驱动管理器进行添加驱动，如下图
+1. 启动 DBeaver，在顶部菜单中选择 **数据库 > 驱动管理器**。
 
    ![DBeaver](../assets/dbeaver/new.png)
 
-2. 进入驱动管理器界面，选择新建驱动
-3. 在创建新驱动界面配置以下信息：
-   - 驱动器名称：例如 `Datalayers`
-   - 驱动器类型：选择 `Generic`
+2. 在驱动管理器中点击 **新建**，创建自定义驱动。
+3. 在驱动配置页面填写以下信息：
+   - 驱动名称：例如 `Datalayers`
+   - 驱动类型：选择 `Generic`
    - 类名：`org.apache.arrow.driver.jdbc.ArrowFlightJdbcDriver`
    - URL 模板：`jdbc:arrow-flight-sql://{host}:{port}?useEncryption=false`
-   - 默认端口：`8360`，这是 Datalayers 默认的 Arrow Flight SQL 端口
+   - 默认端口：`8360`，即 Datalayers 默认的 Arrow Flight SQL 协议端口
 
    ![DBeaver](../assets/dbeaver/config.png)
 
-4. 切换至 **库** 标签页，添加此前下载的 [Arrow Flight SQL JDBC Driver](https://mvnrepository.com/artifact/org.apache.arrow/flight-sql-jdbc-driver)，添加完成后点击“查找类”，再点击 **OK** 保存配置
+   以上 URL 模板适用于未启用 TLS 的连接；如果实例启用了加密连接，请根据实际 TLS 配置调整 JDBC 连接参数。
+
+4. 切换至 **库** 标签页，添加已下载的 [Arrow Flight SQL JDBC Driver](https://mvnrepository.com/artifact/org.apache.arrow/flight-sql-jdbc-driver)。添加完成后点击 **查找类**，确认类名识别成功后点击 **OK** 保存驱动配置。
 
    ![DBeaver](../assets/dbeaver/lib.png)
 
-5. 点击顶部菜单“窗口 > 首选项”，在左侧选择“编辑器 > 数据编辑器 > 数据格式”，勾选 **禁用日期/时间格式**，如下图
+5. 在顶部菜单中选择 **窗口 > 首选项**，在左侧导航中进入 **编辑器 > 数据编辑器 > 数据格式**，勾选 **禁用日期/时间格式**。
 
    ![DBeaver](../assets/dbeaver/date-format.png)
 
-6. 点击 **应用并关闭**，完成 DBeaver 驱动配置
+   该设置可避免 DBeaver 对时间类型结果进行额外格式化，便于查看 Datalayers 返回的原始时间值。
+
+6. 点击 **应用并关闭**，完成 DBeaver 驱动配置。
 
-## 连接 Datalayers
+### 连接 Datalayers
 
-1. 从顶部菜单中选择数据库、新建数据库连接
-2. 搜索此前添加的驱动名称（如此前添加的 Datalayers），找到后双击该图标，进入配置界面
-3. 配置地址、用户名与密码，点击 **Finish** 完成连接配置
-4. 连接成功后，即可在左侧导航中浏览对象并执行 SQL 操作
+1. 在顶部菜单中选择 **数据库 > 新建数据库连接**。
+2. 搜索前面添加的驱动名称，例如 `Datalayers`，双击该驱动进入连接配置页面。
+3. 填写 Datalayers 实例地址、端口、用户名和密码。
+4. 点击 **Finish** 保存连接配置并建立连接。
+5. 连接成功后，即可在左侧导航中浏览数据库对象，并在 SQL 编辑器中执行查询、建表、写入等操作。
 
 ![DBeaver](../assets/dbeaver/datalayers-with-dbeaver.png)
 
 ## 相关文档
 
-- 想了解命令行方式的连接与操作，请参考 [Datalayers 命令行工具 dlsql 使用指南](../getting-started/command-line-tool.md)
-- 想了解 REST API 接入方式，请参考 [Datalayers HTTP REST API 接入指南](../development-guide/rest-api/overview.md)
+- 如需通过命令行连接和操作 Datalayers，请参考 [Datalayers 命令行工具 dlsql 使用指南](../getting-started/command-line-tool.md)
+- 如需通过 REST API 接入 Datalayers，请参考 [Datalayers HTTP REST API 接入指南](../development-guide/rest-api/overview.md)