连接到 Oracle 关系数据库管理系统 (RDBMS) | 自治数据仓库 (ADW) – 支持中心

借助 Oracle® RDBMS | ADW 连接器，您可以使用链式命令在 Oracle 关系数据库管理系统 (RDBMS) 或自治数据仓库® (ADW) 中执行结构化查询语言 (SQL) 操作。例如，使用此连接器，您可以：

执行 SQL 命令，包括 CREATE 或 UPDATE 语句或 SELECT 查询
检索有关 Oracle RDBMS 或 ADW 中表的详细信息
将记录插入 Oracle RDBMS 或 ADW

注: 此连接器由 Workiva 构建，并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器，但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。

要求

为了实现与 Oracle 数据库的连接，连接器使用 Java 数据库连接 (JDBC)，并通过基本的用户名和密码身份验证进行保护。要设置连接器，您需要：

在 Oracle RDBMS 或 ADW 中为连接器创建的指定集成用户
集成用户的用户名和密码
JDBC 连接的 URL，例如 jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./
要连接到 Oracle ADW，需要数据库客户端凭据或钱包文件。
要连接到本地数据库，需要用于连接的 GroundRunner

支持的版本

Oracle® RDBMS | ADW 连接器与以下数据库版本兼容：

21.x
19.x
18.3
12.2
12.1
11.2.0.4

ADW钱包文件

要启用与 Oracle ADW 的连接，首先下载数据库的客户端凭据或钱包文件。设置连接器时，您需要将这些钱包文件上传到 Resources目录下：

cwallet.sso.lck\n* ewallet.p12.lck
cwallet.sso
电子钱包.p12
keystore.jks
sqlnet.ora
tnsnames.ora
信任库.jks
ojdbc.properties

要在连接器的 Connection URL 属性中指示这些资源的位置，请根据 GroundRunner 的操作系统输入 TNS_ADMIN 路径：

对于 UNIX 系统， TNS_ADMIN=./
对于 Microsoft® Windows®， TNS_ADMIN=.

注意：如果连接器使用 CloudRunner，请使用路径 `TNS_ADMIN=./`.

设置 Oracle RDBMS | ADW 连接器

注：要使连接器可在您组织的链中使用，组织安全管理员首先需要在配置中启用它。

从 链构建器中，单击连接比较箭头，然后单击右上角的创建。
在 连接器连接下，选择 Oracle RDBMS | ADW以及要与连接器一起使用的运行程序。
在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。
要连接到 Oracle ADW，请在资源下上传数据库钱包文件。

在属性下，输入连接器的详细信息：

摘要信息详细信息

用户名输入连接器集成用户的用户名。

密码输入 Username 属性的密码。

连接 URL

输入 JDBC 连接的 URL，例如 jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./。

对于 Oracle RDBMS，附加任何可选属性以用于连接。
对于 Oracle ADW，根据所选运行器及其操作系统，附加数据库钱包文件的 TNS_ADMIN 路径。

注意：Oracle RDBMS 的默认端口为 `1521`；但是，您的环境中的端口可能有所不同

。

注意：所有敏感凭证均自动加密并以高级加密标准 (AES)-256 加密方式存储。出于安全考虑，请避免将用户凭据作为可选属性包含在 “连接 URL ”属性中

。

选择要与连接一起使用的环境，然后单击保存。
要测试连接，创建并运行一个链，使用连接器的 获取表定义命令，并验证它是否返回有效输出。

疑难解答

如果与 Oracle RDBMS 或 ADW 的连接失败：

验证集成用户的身份验证凭据。
检查 JDBC 连接的 URL。
如果连接到本地数据库，请检查为连接器选择的 GroundRunner。
如果连接到 Oracle ADW，请验证数据库钱包文件是否已上传到 Resources下，并验证其在 Connection URL 属性中的 TNS_ADMIN 路径。如有必要，请从 Oracle ADW 下载钱包文件，并再次将其上传到 Resources 下。

如果连接执行命令失败，请验证其输入（例如 SQL 语法或表）是否有效。

支持

社区

Workiva Support Center