Ir para o conteúdo

Conector Snowflake para Jitterbit Integration Studio

Resumo

O conector Snowflake estabelece acesso ao Snowflake.

O conector Snowflake fornece uma interface para criar uma conexão com o Snowflake, que é a base utilizada para gerar instâncias de atividades do Snowflake. Essas atividades, uma vez configuradas, interagem com o Snowflake por meio da conexão.

O conector Snowflake é acessado na aba Endpoints e conectores do projeto do painel de componentes de design (veja Painel de componentes de design).

Visão geral do conector

Esse conector é usado para primeiro configurar uma conexão com o Snowflake. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão específica com o Snowflake e suas atividades são referidos como um endpoint Snowflake:

Tipos de atividades do Snowflake

  • Get: Recupera um arquivo CSV de dados de tabela ou visualização do Snowflake e é destinado a ser usado como uma fonte em uma operação.

  • Query: Recupera um arquivo CSV de dados de tabela ou visualização do Snowflake e é destinado a ser usado como uma fonte em uma operação.

  • Merge: Insere ou atualiza um arquivo CSV de dados de tabela no Snowflake e é destinado a ser usado como um alvo em uma operação.

  • Invoke Stored Procedure: Invoca um procedimento armazenado criado no Snowflake e é destinado a ser usado como um alvo em uma operação.

  • Update: Atualiza dados de tabela no Snowflake e é destinado a ser usado como um alvo em uma operação.

  • Delete: Exclui dados de tabela e dados de visualização do Snowflake e é destinado a ser usado como um alvo em uma operação.

  • Inserir: Insere dados de tabela (seja como um arquivo CSV ou mapeados diretamente para colunas de uma tabela) no Snowflake e é destinado a ser usado como um alvo em uma operação.

Nota

Este conector é um conector baseado no Connector SDK, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

Os endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector Snowflake requer o uso de uma versão do agente 10.1 ou posterior. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector Snowflake utiliza a versão 3.19.0 do Driver JDBC do Snowflake e os comandos SQL do Snowflake. Consulte a documentação da API para informações sobre os nós e campos do esquema.

Para usar a autenticação OAuth 2.0 de 3 pernas (3LO) com o conector Snowflake, pré-requisitos adicionais são necessários. É necessário ter a versão do agente 10.83 / 11.21 ou posterior para usar 3LO.

A propriedade TYPE do usuário do Snowflake deve ser definida como LEGACY_SERVICE e a futura descontinuação da autenticação de fator único

O Snowflake anunciou a futura descontinuação da autenticação de fator único, que afeta integrações que se conectam ao Snowflake usando uma senha. Todos os usuários do conector Snowflake que utilizam o tipo de autenticação Senha (Descontinuada) são afetados.

Ação recomendada do usuário

A ação do usuário é necessária em duas fases:

  1. Até 31 de março de 2025, a propriedade TYPE da conta de usuário que você usa para se conectar ao Snowflake deve ser definida como LEGACY_SERVICE para continuar usando a autenticação baseada em senha (veja Tipos de usuários). Sem a ação do usuário, espera-se que as integrações existentes que utilizam a autenticação de senha de fator único do Snowflake comecem a falhar em abril de 2025.

  2. Até novembro de 2025, você deve atualizar o tipo de autenticação usado para se conectar ao Snowflake para OAuth 2.0 ou autenticação por chave. Neste momento, a autenticação baseada em senha não será mais suportada.

Solução de problemas

Se você encontrar problemas com o conector do Snowflake, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política da organização Desativar Atualização Automática do Conector).

    Nota

    As Instâncias de Desenvolvedor do Snowflake são conhecidas por "dormir" se você não tiver feito login recentemente na interface do usuário do Snowflake ou usado a instância. Se uma tabela não for preenchida com objetos disponíveis, primeiro verifique se a instância do Snowflake está ativa e, em seguida, verifique se você está conectado a ela reabrindo a conexão do Snowflake e testando novamente as credenciais.

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o registro de depuração de operações (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  5. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.