Ir para o conteúdo

Conexão Snowflake

Introdução

Uma conexão Snowflake, criada usando o conector Snowflake, estabelece acesso ao Snowflake. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades Snowflake associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Este conector suporta a política organizacional Habilitar Re-autenticação em Mudanças. Se habilitado, uma alteração no Nome do Host, Nome de Usuário, Conta ou Nome do Banco de Dados nesta conexão requer que os usuários reentrem a Senha para a conexão.

Criar ou editar uma conexão Snowflake

Uma nova conexão Snowflake é criada usando o conector Snowflake a partir de uma destas localizações:

Uma conexão Snowflake existente pode ser editada a partir destas localizações:

Configurar uma conexão Snowflake

Cada elemento da interface do usuário da tela de configuração da conexão Snowflake é descrito abaixo.

Configuração da conexão Snowflake

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Snowflake e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Snowflake, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Autenticação: Selecione o tipo de autenticação, um dos seguintes: Key-Pair, OAuth ou Password (Depreciado):

    • Key-Pair: Selecione esta opção para usar um par de chaves para autenticação:

      • Nome do host: Insira o nome do host Snowflake. Este é o nome da conta Snowflake (como example-account123) e o nome de domínio Snowflake de snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

      • Nome de usuário: Insira o nome de usuário Snowflake.

      • Especificação da chave privada: Selecione Não criptografada ou Chave criptografada para identificar o tipo de chave privada utilizada.

      • Chave privada: Insira a chave privada. Para mais informações, consulte a documentação da Snowflake sobre Autenticação por chave-pair e rotação de chave-pair.

      • Frase-secreta: Se Chave criptografada for selecionada para Especificação da chave privada, insira a frase-secreta associada à chave privada criptografada.

    • OAuth: Selecione esta opção para usar OAuth 2.0 de 3 etapas para autenticação:

      • Nome do host: Insira o nome do host do Snowflake. Este é o nome da conta Snowflake (como example-account123) e o nome de domínio do Snowflake snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

      • Nome de usuário: Insira o nome de usuário do Snowflake.

      • Aplicativo OAuth: Selecione um aplicativo de conector Snowflake configurado na página Registro de Aplicativos do Console de Gerenciamento. Para mais informações sobre como configurar um aplicativo de conector Snowflake na página Registro de Aplicativos, consulte os pré-requisitos de OAuth de 3 etapas do Snowflake.

      • Entrar com Snowflake: Clique para autenticar através do Snowflake em uma nova aba do navegador e forneça consentimento para que o Jitterbit acesse o aplicativo Snowflake.

    • Senha (Depreciada): Selecione esta opção para usar uma senha para autenticação:

      • Nome do host: Insira o nome do host do Snowflake. Este é o nome da conta Snowflake (como example-account123) e o nome de domínio do Snowflake snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

      • Nome de usuário e Senha: Insira o nome de usuário e a senha do Snowflake.

        A propriedade TYPE do usuário 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 (Depreciada) 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 par de chaves. Neste momento, a autenticação baseada em senha não será mais suportada.

  • Conta: Insira o nome da conta do Snowflake.

  • Nome do banco de dados: Insira o nome do banco de dados do Snowflake.

  • Nome do esquema: Insira o nome do esquema do Snowflake.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Função: Insira a função do Snowflake. As funções disponíveis são GERAL, PÚBLICO e SOMENTE LEITURA.

    • Nome do Armazém: Insira o nome do armazém do Snowflake.

    • Escapar caracteres especiais: Quando selecionado, um caractere de aspas simples (') é escapado (\') quando está presente em um payload de solicitação de Inserir ou atividade de Invocar Procedimento Armazenado.

      Quando não selecionado (padrão), e um caractere de aspas simples (') está presente em um payload de solicitação, um erro de sintaxe é retornado em tempo de execução.

  • Usar aspas para identificadores do Snowflake: Selecione esta opção para usar aspas em torno dos identificadores do Snowflake, como nomes de tabelas, para preservar sua capitalização em vez de converter sua capitalização para maiúsculas, o que pode causar um erro. Por padrão, esta opção está selecionada.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão com o Snowflake, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Fundamentos do conector.

Estes tipos de atividade estão disponíveis:

  • Obter: 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.

  • Consulta: 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.

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

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

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

  • Excluir: 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.