mirror of
https://github.com/t8y2/dbx.git
synced 2026-10-21 04:10:49 +00:00
docs: fix locale parity gaps and JRE package naming
This commit is contained in:
@@ -7,6 +7,8 @@ description: 使用原生 DBX CLI 在终端、脚本、CI 和 Codex 中读取连
|
||||
|
||||
## 安装
|
||||
|
||||
### npm
|
||||
|
||||
```bash
|
||||
npm install -g @dbx-app/cli
|
||||
```
|
||||
|
||||
@@ -85,7 +85,7 @@ RabbitMQ 等消息队列 Agent 还可能同时使用业务协议和管理 API。
|
||||
|
||||
所有 Agent 都提供单驱动 ZIP,可直接使用**导入离线包**安装。Java Agent 的单驱动包跨平台,但不重复携带 JRE;KingbaseES、Oracle、Xugu 等原生 Agent 的单驱动包按操作系统和 CPU 架构区分。
|
||||
|
||||
如果目标机器尚未安装 Java Agent 所需的托管 JRE,可在**导入离线包**中选择对应平台的 `dbx-jre-21-<platform>.tar.zst`,或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时,不包含数据库驱动,也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。
|
||||
如果目标机器尚未安装 Java Agent 所需的托管 JRE,可在**导入离线包**中选择对应平台的 `dbx-jre-<jre-key>-<platform>.tar.zst`(例如 `dbx-jre-21-macos-aarch64.tar.zst`),或者直接使用包含全部驱动和 JRE 的完整离线 ZIP 包。独立 JRE 包仅包含 Java 运行时,不包含数据库驱动,也不需要 `agent-registry.json`。DBX 会验证 Java 的操作系统和 CPU 架构后安装到托管 JRE 目录。
|
||||
|
||||
### Windows 导入 KingbaseES
|
||||
|
||||
@@ -93,6 +93,12 @@ Windows x64 下载 `dbx-agent-kingbase-<version>-windows-x64.zip`,Windows ARM6
|
||||
|
||||
ZIP 内包含版本信息和对应平台的原生 Agent。DBX 会将其安装为 `%USERPROFILE%\.dbx\agents\drivers\kingbase\agent.exe`,不需要手动解除浏览器下载文件的阻止状态或复制文件。
|
||||
|
||||
### 离线导入 JDBC 插件
|
||||
|
||||
通用 JDBC 连接(自定义 JDBC URL + 导入的驱动 JAR)通过独立的 **DBX JDBC 插件** 运行,发布为单独的 `dbx-jdbc-plugin-*.zip` 资源,**不会**打进各数据库的 Agent ZIP。请在 **JDBC 驱动** 页签使用 **本地安装** 安装它(不要用内置驱动里的**导入离线包**,那是给 Agent ZIP 用的)。
|
||||
|
||||
导入真正的驱动 JAR(例如 Oracle 的 `ojdbc*.jar`)始终是本地操作,不需要这个插件包,也不需要网络——在同一页签使用 **导入 JAR**,无论 JDBC 插件本身是否已安装。
|
||||
|
||||
## 插件更新
|
||||
|
||||
对于由 [JDBC 插件](/cn/docs/plugins)支持的数据库,当有新插件版本可用时,DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。
|
||||
|
||||
@@ -85,7 +85,7 @@ This is useful for air-gapped networks, strict firewall environments, or pre-app
|
||||
|
||||
Every agent provides a single-driver ZIP that can be installed with **Import offline package**. Java agent packages are platform-independent and do not duplicate the JRE, while native agents such as KingbaseES, Oracle, and Xugu provide separate packages for each OS and CPU architecture.
|
||||
|
||||
If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre-<version>-<platform>.tar.zst`, or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation.
|
||||
If the target machine does not already have the managed JRE required by a Java agent, use **Import offline package** to select the matching platform's `dbx-jre-<jre-key>-<platform>.tar.zst` (for example `dbx-jre-21-macos-aarch64.tar.zst`), or use the full offline bundle containing every driver and the JRE. Standalone JRE packages do not require `agent-registry.json`; DBX validates the Java executable's operating system and CPU architecture before installation.
|
||||
|
||||
### Importing KingbaseES on Windows
|
||||
|
||||
|
||||
@@ -59,6 +59,12 @@ This guide gets you through three things:
|
||||
flatpak update com.dbxio.dbx
|
||||
```
|
||||
|
||||
On Kylin V10, UnionTech UOS, and similar Chinese desktop distributions, install from the [Spark App Store](https://spk-resolv.spark-app.store/?spk=spk://store/development/dbx) and choose the **APM build**. AmberPM provides a compatible runtime that reduces install/startup failures caused by distro dependency drift; updates are also available from the Spark App Store client.
|
||||
|
||||
<Callout type="warn">
|
||||
The APM build runs DBX inside that compatibility runtime. If you select the host Java for Agent/JDBC drivers, prefix the path with `/host` — enter `/host/usr/bin/java` instead of `/usr/bin/java`.
|
||||
</Callout>
|
||||
|
||||
You can also download a package from [GitHub Releases](https://github.com/t8y2/dbx/releases):
|
||||
|
||||
| Format | Use Case |
|
||||
|
||||
Reference in New Issue
Block a user