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 Snowflake, a base usada para gerar instâncias de atividades 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 da paleta de componentes de design (consulte paleta de componentes de design).

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 que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

• Obter: Recupera um arquivo CSV de dados de tabela ou exibição do Snowflake e deve ser usado como fonte em uma operação.

• Consulta: Recupera um arquivo CSV de dados de tabela ou exibição do Snowflake e deve ser usado como fonte em uma operação.

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

• Invocar procedimento armazenado: Invoca um procedimento armazenado criado no Snowflake e se destina a ser usado como um alvo em uma operação.

• Atualizar: Atualiza dados da tabela no Snowflake e deve ser usado como um alvo em uma operação.

• Excluir: Exclui dados de tabela e dados de exibição do Snowflake e deve ser usado como um destino em uma operação.

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

Nota

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

Pré-requisitos e versões de API suportadas

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.

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

O conector Snowflake atualmente requer autenticação baseada em senha.

Snowflake user TIPOproperty must be set toSERVIÇO_LEGADOand future deprecation of single-factor authentication""Cuidado" Usuário Snowflake Type A propriedade deve ser definida como Legacy_Service E futura depreciação da autenticação de fator único

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. Como o conector Snowflake do Integration Studio atualmente requer autenticação baseada em senha, todos os usuários do conector Snowflake são afetados.

Ação de usuário recomendada

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

1. Até 31 de março de 2025, o TYPE propriedade 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 (consulte Tipos de usuários). Sem a ação do usuário, as integrações existentes que usam a autenticação de senha de fator único do Snowflake devem começar 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 ou autenticação de par de chaves. Neste momento, a autenticação baseada em senha não será mais suportada. Em uma próxima versão, o conector Snowflake do Integration Studio será atualizado para adicionar suporte aos novos métodos de autenticação obrigatórios.

Solução de problemas

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

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

   Nota

   As instâncias do desenvolvedor Snowflake são conhecidas por "irem para o modo de suspensão" 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 certifique-se de que a instância do Snowflake esteja ativa e, em seguida, certifique-se de que você esteja conectado a ela reabrindo a conexão do Snowflake e testar novamente as credenciais.

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

3. Habilite o registro de depurar da operação (para agentes de 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 sobre solução de problemas, consulte Solução de problemas de operação.