使用 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 建立 mTLS 连接
如果您需要与 Snowflake 建立 mTLS 连接，我们建议您使用 HTTPs 连接器 而不是 Snowflake JDBC 连接器。我们目前不支持 mTLS 证书的自动轮换，因此证书必须通过连接手动更新，并在更改后保存。
设置 Snowflake 连接器
- 从 链构建器中，单击 连接，然后单击右上角的 创建 。
- 在 连接器连接下，选择 Snowflake JDBC和要与连接一起使用的运行器。
- 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。
- （可选）在 资源下，上传您的私钥文件。下一步，您需要将此确切的文件名输入到“私钥文件”字段中。
-
在 属性下，输入连接器的详细信息：
摘要信息 详细信息 用户名 请输入用于身份验证的用户名。如果在下方提供私钥文件，则会自动对此用户名进行身份验证。 密码 输入 Username 属性的密码。如果下方提供了私钥文件，请在此处输入密码。
注： 留空表示密钥文件未加密。
连接 URL 输入 JDBC 连接的 URL，例如
jdbc:snowflake://[accountName].snowflakecomputing.com/。要为连接包含 可选属性，请将其作为查询字符串附加。例如，如果登录在一分钟内连接失败，则自动超时登录，附加
?loginTimeout=60。私钥文件 （可选）用于使用服务器公钥进行身份验证。请在上方字段中输入用户名和密码。
了解更多： 密钥对认证和密钥对轮换注：文件名必须与作为连接资源上传的文件名称一致。
注意： 所有敏感凭证均自动加密并以高级加密标准 (AES)-256 加密方式存储。出于安全考虑，请避免将用户凭据作为可选属性包含在 “连接 URL ”属性中
。 - 选择要与连接一起使用的环境，然后单击 保存。
- 要测试连接， 创建并运行一个链 ，使用 连接器的 获取表定义命令，并验证它是否返回有效输出。
故障排除
- 如果与 Snowflake 的连接失败：
- 验证身份验证凭据。
- 如果使用密钥对认证，请确保通过 Resources 上传的文件名与 Private Key File 字段中输入的文件名匹配。
- 检查 JDBC 连接的 URL，包括其帐户名称。
- 如果连接到本地数据库，请检查为连接器选择的 GroundRunner。
- 如果连接执行命令失败，请验证其输入（例如 SQL 语法或表）是否有效。
- 如果 Snowflake 命令失败并出现错误消息 不允许 IP/Token XX.XX.XX.XX 的传入请求访问 Snowflake，请参阅此 Snowflake 文章 以获取有关将所需的 IP 地址（ CloudRunner 或 GroundRunner）添加到 Snowflake 实例中的允许 IP 列表的指导。