Workiva支持中心

借助 JDBC 连接器，您可以 使用链式命令 在支持 Java® 数据库连接 (JDBC) 的本地解决方案中执行结构化查询语言 (SQL) 操作。例如，使用此连接器，您可以：

• 执行 SQL 命令，包括 CREATE 或 UPDATE 语句或 SELECT 查询
• 检索数据库表的详细信息
• 通过 JDBC 将记录插入数据库

注意：要连接到 Amazon® Redshift®、 IBM® Db2®、 Microsoft® SQL Server®、 MySQL® 、NetSuite® JDBC、 Oracle®关系数据库管理系统 (RDBMS) 或自治数据仓库

先决条件

为了确保 JDBC 连接的安全，连接器使用基本的用户名和密码身份验证。要设置连接器，您需要：

• 在您连接的解决方案中设置的指定集成用户。
• 集成用户的身份验证凭据。
• JDBC 连接的 URL，例如 jdbc:solution://host:port/database
• 专用于连接器的 GroundRunner ，因为不支持 CloudRunner。
• 用于连接的 JDBC 驱动程序，包括其类名和 GroundRunner 文件系统上的路径。
• 使用此连接器时，要提供自定义 Java 选项，请为 GroundRunner 设置 JDK_JAVA_OPTIONS 环境变量。例如，如果您使用的是 Databricks，则可以使用以下代码：
  JDK_JAVA_OPTIONS="--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED"。这类似于 安装和管理 GroundRunners中设置的配置变量。
  重要提示： 设置此变量后，必须重新启动 GroundRunner 运行所在的计算机。

注意：驱动程序必须位于 GroundRunner 上，因为 .jar 文件无法作为资源上传。

设置 JDBC 连接器

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

1. 从 链构建器中，单击 连接比较箭头，然后单击右上角的 创建 。
2. 在 连接器连接下，选择 JDBC 和要与连接一起使用的 GroundRunner。
   
3. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。

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

   摘要信息	详细信息
   用户名	输入连接器集成用户的用户名。
   密码	输入 Username 属性的密码。
   连接 URL	输入 JDBC 连接的 URL，例如 jdbc:solution://host:port/database。
   JDBC驱动类	输入 JDBC 驱动程序 .jar 文件的类名。例如，对于 Sybase®，输入 com.sybase.jdbc.sybdriver。
   JDBC驱动程序的路径	输入 GroundRunner 文件系统中 JDBC 驱动程序的安装路径。

   注意：所有敏感凭证均会自动加密，并以高级加密标准 (AES ) -256 加密方式存储

   。
5. 选择要与连接一起使用的环境，然后单击 保存。
6. 关闭并重新启动运行 GroundRunner 的计算机，以重新初始化 JVM。
7. 要测试连接， 创建并运行一个链 ，使用 连接器的 获取表定义命令，并验证它是否返回有效输出。

疑难解答

如果 JDBC 连接失败：

• 验证集成用户的身份验证凭据。
• 检查 JDBC 连接的 URL，包括其服务器、端口和数据库。
• 请核实连接器中输入的 JDBC 驱动程序类名或路径。

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