雪花连接器

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

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

支持联系人

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

连接器注意事项

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

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

设置

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

在 Snowflake 中将 Tulip 注册为客户端应用程序

1. 使用具有创建和管理安全集成（ACCOUNTADMIN）角色/权限的用户登录您的 Snowflake 实例。
2. 在 COMPUTE_WH 仓库中创建一个新的 SQL 工作表。
3. 运行以下脚本创建 OAuth 类型的安全集成。不要忘记更新 INTEGRATION_NAME、TULIP_INSTANCE_NAME 和 TIME_IN_SECONDS 的值。

创建或替换安全集成 <integration_name>type = oauthenabled = trueoauth_client = customoauth_client_type = 'confidential'oauth_redirect_uri = 'https://<tulip_instance_name>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>；

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

收集 Tulip 中 OAuth 配置的详细信息

1. 运行以下命令来描述您刚刚创建的安全集成，DESCRIBE SECURITY INTEGRATION ；
2. 写下以下详细信息：OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. 运行：SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>')；

必须完全限定，例如不是 tulip_intergation，而是 TULIP_INTEGRATION

1. 写下：OAUTH_CLIENT_SECRET

配置您的 Snowflake 连接器

1. 登录 Tulip 并从 Tulip库中添加 Snowflake 连接器（Web 或 Embedded）。
2. 点击进入生产环境
3. 设置以下设置：

运行于：云连接器主机服务器地址：您的 snowflake 账户服务器 url，格式为.snowflakecomputing.com基础路径：api/v2Authentication选择服务或用户 OAuthAuthorization code URL - OAUTH_AUTHORIZATION_ENDPOINT from step 2Access token URL - OAUTH_TOKEN_ENDPOINT from step 2Client ID - OAUTH_CLIENT_ID from step 2Client Secret - OAUTH_CLIENT_SECRET from step 2Select check boxes forSend authentication headerEncode client ID during authentication（在验证过程中对客户端 ID 进行编码）。

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

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

1. 身份验证成功后，会出现一条征求同意的消息。请仔细阅读以了解正在执行的操作，然后单击 "允许"。

现在您可以从 Tulip 安全连接到 Snowflake！

使用方法

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

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

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

模板功能

库连接器包括以下模板功能：模板：查询数据库描述：允许您提交一条或多条 SQL 语句以供执行：POSTEndpoint：/api/v2/statementsReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate：Check Query StatusDescription：使您能够检查语句的执行状态：GETEndpoint：/api/v2/statements/{statementHandle}Reference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate：Cancel QueryDescription：允许您取消语句的执行：POSTEndpoint：/api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

其他参考资料

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