Conector Snowflake

Consulta de informações do Snowflake para uso com aplicativos Tulip

O conector Snowflake simplifica a forma de consultar informações de um Snowflake Data Cloud. A documentação da API REST do Snowflake SQL pode ser encontrada aqui.

Contato de suporte

Este conector foi criado em colaboração com a Spaulding Ridge. Para obter mais informações ou fazer perguntas, entre em contato com a Spaulding Ridge pelo e-mail info@spauldingridge.com

Observações sobre o conector

O conector Snowflake pode manipular registros únicos com relativa facilidade. Podem ser necessários widgets personalizados para consultar várias linhas de dados ou manipular saídas no Tulip (tabela interativa etc.).

O Snowflake OAuth usa o serviço OAuth incorporado do Snowflake e suporta o Tulip como um cliente personalizado. A documentação do Snowflake OAuth pode ser encontrada aqui. Os detalhes da configuração do cliente personalizado podem ser encontrados aqui.

Configuração

Esta seção fornece o procedimento para configurar um token OAuth do servidor OAuth da Snowflake para estabelecer conectividade com a Tulip como cliente, bem como as etapas para configurar o conector Snowflake na Tulip.

Registre o Tulip como um aplicativo cliente no Snowflake

1. Faça login na sua instância do Snowflake com um usuário que tenha a função/privilégio de criar e gerenciar integrações de segurança (ACCOUNTADMIN).
2. Crie uma nova planilha SQL no warehouse COMPUTE_WH.
3. Execute o script a seguir para criar uma integração de segurança do tipo OAuth. Não se esqueça de atualizar os valores de INTEGRATION_NAME, TULIP_INSTANCE_NAME e TIME_IN_SECONDS.

CREATE OR REPLACE SECURITY INTEGRATION <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>;

Observação: a validade do token de atualização pode ser de até 1 dia (86400 segundos).

Reunir detalhes para a configuração do OAuth no Tulip

1. Execute os seguintes comandos para descrever a integração de segurança que você acabou de criar eDESCRIBE SECURITY INTEGRATION ;
2. Anote os detalhes abaixo:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Execute:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>');

**deve ser totalmente capitalizado,**por exemplo, não tulip_intergation, mas TULIP_INTEGRATION

1. Anote: OAUTH_CLIENT_SECRET

Configure seu conector Snowflake

1. Faça login no Tulip e adicione o conector Snowflake da biblioteca Tulip aqui (Web ou Embedded).
2. Clique no ambiente de produção
3. Defina as seguintes configurações:

Executando em: endereço do HostServer do Cloud Connector: O URL do servidor de sua conta do Snowflake no formato .snowflakecomputing.comCaminho da base: api/v2AuthenticationSelecione o serviço ou o usuário OAuth URL do código de autorização - OAUTH_AUTHORIZATION_ENDPOINT da etapa 2 URL do token de acesso - OAUTH_TOKEN_ENDPOINT da etapa 2 ID do cliente - OAUTH_CLIENT_ID da etapa 2 Segredo do cliente - OAUTH_CLIENT_SECRET da etapa 2 Marque as caixas de seleção paraEnviar cabeçalho de autenticaçãoCodificar ID do cliente durante a autenticação

1. Clique em Test (Testar). Você será levado à janela de login da sua conta Snowflake.

Um usuário deve fazer login. Observe que sua função padrão não deve ser ACCOUNTADMIN, SECURITYADMIN ou ORGADMIN. Você pode alterar a função padrão dos usuários para o OAuth, conforme detalhado neste recurso do Snowflake: Gerenciando o consentimento do usuário para o OAuth.

1. Após a autenticação bem-sucedida, será exibida uma mensagem para consentimento. Leia-a com atenção para entender a operação que está sendo executada e clique em Allow (Permitir).

Agora você pode se conectar com segurança ao Snowflake a partir do Tulip!

Uso

Você tem duas opções para começar a usar o conector:

Comece personalizando as funções do modelo do conector para atender às suas necessidades específicas.

Siga as instruções do teste de unidade do Snowflake para obter uma demonstração prática de como usar o conector para tarefas que incluem: recuperar todos os registros de tabela de uma tabela do Snowflake no Tulip, criar um novo registro, atualizar um registro existente e excluir um registro.

Funções de modelo

O conector Library inclui as seguintes funções de modelo:Template: Consultar banco de dadosDescrição: Permite que você envie uma ou mais instruções SQL para execução.Method: POSTEndpoint: /api/v2/statementsReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Check Query StatusDescrição: Permite que você verifique o status da execução de uma instrução.Method: GETEndpoint: /api/v2/statements/{statementHandle}Reference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancel QueryDescription (Cancelar consulta): Permite que você cancele a execução de uma instrução.Method: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Referências adicionais

Este guia da Comunidade Snowflake fornece contexto adicional para a integração do Snowflake