Ir para o conteúdo

Conector Snowflake no Jitterbit Studio

Resumo

O conector Snowflake estabelece acesso ao Snowflake.

O conector Snowflake fornece uma interface para criar uma conexão Snowflake, a base usada para gerar instâncias de atividades Snowflake. Essas atividades, uma vez configuradas, interagem com o Snowflake através da conexão.

Acessa-se o conector Snowflake a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Snowflake. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão Snowflake específica e suas atividades são chamadas de endpoint Snowflake:

Tipos de atividade 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.

  • Query v2: Recupera um arquivo CSV de dados de tabela ou visualização em múltiplos esquemas 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 destino em uma operação.

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

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

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

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

Nota

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

Os endpoints criados com este conector estão incluídos em relatório de uso de endpoints e contam para sua licença.

Pré-requisitos

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

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

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

O Snowflake anunciou a próxima 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 usam o tipo de autenticação Password (Deprecated) (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 autenticação baseada em senha (consulte Tipos de usuários). Sem ação do usuário, espera-se que as integrações existentes que usam 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 de par de chaves. Neste momento, a autenticação baseada em senha não será mais suportada.

Solução de problemas

Se você enfrentar problemas com o conector Snowflake, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política organizacional Disable Auto Connector Update).

    Nota

    As instâncias do Snowflake Developer são conhecidas por "adormecer" se você não tiver feito login recentemente na interface do Snowflake ou usado a instância. Se uma tabela não for preenchida com objetos disponíveis, primeiro certifique-se de que a instância do Snowflake está ativa e, em seguida, certifique-se de que 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 escrita durante a execução da operação.

  3. Ative o log de depuração de operação (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 obter mais informações.

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

  6. Para problemas e resoluções específicas do conector Snowflake, consulte o guia Solução de problemas do conector: