Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Conexão Snowflake

Introdução

Uma conexão Snowflake, criada usando o conector Snowflake, estabelece acesso a Snowflake. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Snowflake associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector suporta a política da organização Habilitar Reautenticação na Alteração. 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 insiram novamente a Senha para a conexão.

Criar ou editar uma conexão Snowflake

Uma nova conexão Snowflake é criada usando o conector Snowflake de um destes locais:

Uma conexão Snowflake existente pode ser editada nestes locais:

Configurar uma conexão Snowflake

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

Configuração de conexão Snowflake

Dica

Campos com um ícone variável suporte usando variáveis globais, variáveis do 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 usar 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 do Snowflake, que se refere a uma conexão específica e suas atividades.

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

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

    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.

  • Conta: Insira o nome da conta Snowflake.

  • Nome do banco de dados: Insira o nome do banco de dados 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 papel Snowflake. As funções disponíveis são GERAL, PÚBLICO e SOMENTE LEITURA.

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

    • Caracteres especiais de escape: Quando selecionado, um caractere de aspas simples (') é escapado (\') quando está presente em um Inserir ou Invocar atividade de Procedimento Armazenado solicitar payload.

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

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

  • Teste: 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 Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de 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 para você confirmar 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão Snowflake, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

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