雪花连接器

从 Snowflake 中查询信息，以便与 Tulip 应用程序配合使用

用户

请注意，Snowflake 集成是技术性的，可能需要您的 IT 支持来创建适当的对象、角色和权限。

支持联系人

本连接器是与Spaulding Ridge 合作创建的。如需更多信息或问题，请联系 Spaulding Ridge，电子邮件：info@spauldingridge.com

目的

Snowflake 连接器简化了从 Snowflake 数据云查询信息的方式。可在此处找到 Snowflake SQL REST API 文档。

连接器注意事项

Snowflake 连接器可相对轻松地处理单条记录。要查询多行数据或操作 Tulip 中的输出（交互表等），可能需要自定义部件。

Snowflake OAuth 使用 Snowflake 内置的 OAuth 服务，并支持 Tulip 作为自定义客户端。雪花 OAuth 文档可在此处找到。自定义客户端配置详情请参阅此处。

设置

本节介绍从 Snowflake 的 OAuth 服务器配置 OAuth 令牌以建立与作为客户端的 Tulip 的连接的步骤，以及在 Tulip 中设置 Snowflake 连接器的步骤。

步骤 1：在 Snowflake 中将 Tulip 注册为客户端应用程序

使用具有创建和管理安全集成（ACCOUNTADMIN）角色/权限的用户登录您的 Snowflake 实例。

在 COMPUTE_WH 仓库中创建一个新的 SQL 工作表。

运行以下脚本创建 OAuth 类型的安全集成。不要忘记更新 INTEGRATION_NAME、TULIP_INSTANCE_NAME 和 TIME_IN_SECONDS 的值。

创建或替换安全集成 <integration_name> 类型 = oauth enabled = true oauth_client = custom oauth_client_type = 'confidential' oauth_redirect_uri = 'https://<tulip_instance_name>.tulip.co/oauth-redirect-handler' OAUTH_ISSUE_REFRESH_TOKENS = TRUE OAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>；

注意：刷新令牌有效期可长达 90 天（7776000 秒）。

第 2 步：收集 Tulip 中 OAuth 配置的详细信息

运行以下命令描述刚刚创建的安全集成，并记下以下详细信息： OAUTH_CLIENT_ID OAUTH_REDIRECT_URI OAUTH_AUTHORIZATION_ENDPOINT OAUTH_TOKEN_ENDPOINT OAUTH_CLIENT_SECRET

describe security integration; select system$show_oauth_client_secrets('')；

第 3 步：配置 Snowflake 连接器

登录 Tulip 并从 Tulip 库（Web 或嵌入式）添加 Snowflake 连接器。

单击 "生产、测试和开发 "按钮，编辑连接详情，如下所示。您可以在步骤 2 的 OAUTH_AUTHORIZATION_ENDPOINT 或 OAUTH_TOKEN_ENDPOINT 中找到您的 SNOWFLAKE_ACCOUNT_NAME。

点击 "测试 "和 "保存"。连接器将上线。

第 4 步：编辑 Snowflake 连接器的验证详细信息

点击 "Production & Testing & Development（生产、测试和开发）"按钮和 "Edit Headers（编辑标题）"按钮。

根据您的要求将验证类型选择为 "OAuth 2（管理员）"或 "OAuth 2（操作员）"。有关这方面的更多信息，请参阅 "如何配置连接器 "文章的 "身份验证 "部分。

使用步骤 2 中的详细信息编辑身份验证字段：授权码 URL = OAUTH_AUTHORIZATION_ENDPOINT 访问令牌 URL = OAUTH_TOKEN_ENDPOINT 客户端 ID = OAUTH_CLIENT_ID 客户端密文 = OAUTH_CLIENT_SECRET

点击 "测试"。您将进入 Snowflake 帐户的登录窗口。

用户必须登录。请注意，其默认角色不得为 ACCOUNTADMIN、SECURITYADMIN 或 ORGADMIN。您可以更改用户的 OAuth 默认角色，详见 Snowflake 资源：管理 OAuth 的用户同意。

身份验证成功后，会出现一条征求同意的消息。请仔细阅读以了解正在执行的操作，然后单击 "允许"。 现在您可以从 Tulip 安全连接到 Snowflake！

使用方法

开始使用连接器时，您有两种选择：

首先自定义连接器模板功能，以满足您的特定要求。

按照 Snowflake 单元测试说明实际演示如何使用连接器执行任务，包括：从 Tulip 中的 Snowflake 表检索所有表记录、创建新记录、更新现有记录和删除记录。

模板功能

库连接器包括以下模板功能： 模板：查询数据库允许您提交一条或多条 SQL 语句以供执行。 方法：POSTPOST 端点：/api/v2/statements 参考：https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements Template：检查查询状态允许你检查语句的执行状态。 方法：GET Endpoint：/api/v2/statements/{statementHandle} 参考：https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandle Template：取消查询允许您取消语句的执行。 方法：POST 端点：/api/v2/statements/{statementHandle}/cancel 参考：https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

其他参考资料

本 Snowflake 社区指南还提供了有关 Snowflake 集成的其他背景信息