Workiva支持中心

使用 Snowflake® JDBC 连接器，您可以 在链中使用命令 在 Snowflake 数据库中执行结构化查询语言 (SQL) 操作。例如，使用此连接器，您可以：

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

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

先决条件

要启用与 Snowflake 的连接，组织安全管理员必须首先从 配置启用它。

连接器本身使用 Java 数据库连接 (JDBC)，并采用基本身份验证或密钥对身份验证进行保护。要设置连接器，您需要：

• 在 Snowflake 中为连接器创建的指定集成用户，以及该集成用户的用户名和密码。
  

  注意：自 2025 年 11 月起，将不再支持基本身份验证。我们建议改用密钥对认证。了解更多。

• （可选）用于启用 密钥对身份验证的私钥文件。
• JDBC 连接的 URL，例如 jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• 要连接到本地 Snowflake 数据库， 连接 GroundRunner。（要连接到 Snowflake 云实例，请使用默认的 CloudRunner。）

设置 Snowflake 连接器

1. 从 链构建器中，单击 连接比较箭头，然后单击右上角的 创建 。
2. 在 连接器连接下，选择 Snowflake JDBC和要与连接一起使用的运行器。
   
3. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。
4. （可选）在 资源下，上传您的私钥文件。下一步，您需要将此确切的文件名输入到“私钥文件”字段中。
5. 在 属性下，输入连接器的详细信息：
   
   

   摘要信息	详细信息
   用户名	请输入用于身份验证的用户名。如果在下方提供私钥文件，则会自动对此用户名进行身份验证。
   密码	输入 Username 属性的密码。如果下方提供了私钥文件，请在此处输入密码。 注： 留空表示密钥文件未加密。
   连接 URL	输入 JDBC 连接的 URL，例如 jdbc:snowflake://[accountName].snowflakecomputing.com/。 要为连接包含 可选属性，请将其作为查询字符串附加。例如，如果登录在一分钟内连接失败，则自动超时登录，附加 ?loginTimeout=60。
   私钥文件	（可选）用于使用服务器公钥进行身份验证。请在上方字段中输入用户名和密码。 了解更多： 密钥对认证和密钥对轮换 注意：文件名必须与作为连接资源上传的文件匹配。

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

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

疑难解答

• 如果与 Snowflake 的连接失败：
  • 验证身份验证凭据。
  • 如果使用密钥对认证，请确保通过 Resources 上传的文件名与 Private Key File 字段中输入的文件名匹配。
  • 检查 JDBC 连接的 URL，包括其帐户名称。
  • 如果连接到本地数据库，请检查为连接器选择的 GroundRunner。
• 如果连接执行命令失败，请验证其输入（例如 SQL 语法或表）是否有效。
• 如果 Snowflake 命令失败并出现错误消息 不允许 IP/Token XX.XX.XX.XX 的传入请求访问 Snowflake，请参阅此 Snowflake 文章 以获取有关将所需的 IP 地址（ CloudRunner 或 GroundRunner）添加到 Snowflake 实例中的允许 IP 列表的指导。