Snowflake 凭据
您可以使用这些凭据对以下节点进行身份验证:
先决条件
创建一个 Snowflake 账号。
支持的认证方式
相关资源
有关更多信息,请参阅 Snowflake API 文档 和 SQL 命令参考。
常用配置字段
密码和密钥对认证都需要以下字段;OAuth2 认证除 Role 角色外也使用这些字段:
- Account 账户名称:账户名称是 Snowflake URL 中
https://与snowflakecomputing.com之间的字符串。例如,Snowflake 账号 URL 为https://abc.eu-central-1.snowflakecomputing.com,则账户名称为abc.eu-central-1。 - Database 数据库:输入凭据应连接的数据库名称。
- Warehouse 仓库:输入连接后会话使用的默认虚拟仓库名称。n8n 使用该仓库执行查询、加载数据等操作。
- Schema 模式:输入连接后要使用的模式。
- Role 角色:输入连接后要使用的安全角色。
- Client Session Keep Alive 客户端会话保持:默认情况下,客户端连接通常在最近一次查询执行后的三到四小时超时。开启此设置会将
clientSessionKeepAlive参数设为 true:服务器将无限期保持客户端连接,即使连接未执行任何查询。
有关这些设置的更多信息,请参阅 Session Commands。
使用密码验证
除通用配置字段外,密码认证还需要:
- Username 用户名
- Password 密码
使用密钥对认证
密钥对认证提供了相对于密码认证的增强安全性。该方法使用公私钥对进行认证。
除通用配置字段外,密钥对认证还需要:
- Username 用户名:已分配公钥的 Snowflake 用户。
- Private Key 私钥:PEM 格式(PKCS#8)的私钥。应包含私钥文件的完整内容,包括
-----BEGIN ENCRYPTED PRIVATE KEY-----和-----END ENCRYPTED PRIVATE KEY-----分隔符(或未加密密钥的-----BEGIN PRIVATE KEY-----与-----END PRIVATE KEY-----)。 - Passphrase 口令(可选):如果私钥已加密,请输入用于加密的口令。若使用未加密私钥,请留空。
有关生成和配置密钥对的更多信息,请参阅 Snowflake 密钥对认证文档。
使用 OAuth2 认证
OAuth2 认证使用单独的 Snowflake OAuth2 API 凭据,并且需要先在 Snowflake 中设置 OAuth 安全集成。
使用 ACCOUNTADMIN 角色或具有 CREATE INTEGRATION 权限的角色,在 Snowflake 中运行以下语句:
CREATE SECURITY INTEGRATION n8n_oauth_integration
TYPE = OAUTH
ENABLED = TRUE
OAUTH_CLIENT = CUSTOM
OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
OAUTH_REDIRECT_URI = '<your-redirect-url>'
OAUTH_ALLOW_NON_TLS_REDIRECT_URI = TRUE
OAUTH_ISSUE_REFRESH_TOKENS = TRUE
OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
OAUTH_USE_SECONDARY_ROLES = IMPLICIT
OAUTH_ENFORCE_PKCE = TRUE;
将 <your-redirect-url> 替换为 n8n 凭据中显示的 OAuth Redirect URL OAuth 重定向 URL。如果通过 HTTPS 连接,可以移除 OAUTH_ALLOW_NON_TLS_REDIRECT_URI 行。
然后获取客户端 ID 和客户端密钥:
SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('N8N_OAUTH_INTEGRATION');
有关更多信息,请参阅 Snowflake 的自定义客户端 OAuth 文档。
除通用配置字段(Role 角色除外)之外,OAuth2 认证还需要:
- Client ID 客户端 ID 和 Client Secret 客户端密钥:来自上面创建的安全集成。
若要快速找到 Account、Warehouse 和 Schema 值,请在 Snowflake 中选择您的用户名,转到 Account,然后为要使用的账户选择 View Account Details。选择 Config File,并选择您的 Warehouse 和 Schema,即可查看所需的连接详细信息。
在 n8n 中选择 Connect my account 连接我的账户,启动 OAuth2 流程。n8n 会将您重定向到 Snowflake 以登录并授权应用,然后携带 token 重定向回来。
OAuth2 凭据没有单独的 Role 角色字段。n8n 会改为在 OAuth scope 中请求角色。默认 scope 为 refresh_token session:role:SYSADMIN,因此 Snowflake 用户必须已获授 SYSADMIN 角色。如果用户使用其他角色或您需要额外的 scope,请在连接前开启 Custom Scopes 自定义 scope,然后编辑 Enabled Scopes 已启用 scope,将 session:role:SYSADMIN 替换为 session:role:<your-role>,其中角色必须已授予该用户。请注意,移除默认 scope 可能导致节点无法正常工作。