Conexão Snowflake no Jitterbit Studio

Introdução

Uma conexão Snowflake, criada usando o conector Snowflake, estabelece acesso ao Snowflake. Após configurar uma conexão, você pode criar instâncias de atividades 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).

Criar ou editar uma conexão Snowflake

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

• A aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).
• A página Global Endpoints (Endpoints Globais) (consulte Create a global endpoint em Global Endpoints).

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

• A aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).
• A aba Components (Componentes) do painel do projeto (consulte Component actions menu em Project pane Components tab).
• A página Global Endpoints (Endpoints Globais) (consulte Edit a global endpoint em Global Endpoints).

Configurar uma conexão Snowflake

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

• Connection name (Nome da conexão): Digite um nome para identificar a conexão. O nome deve ser único 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.

• Authentication (Autenticação): Selecione o tipo de autenticação, um de Key-Pair, OAuth ou Password (Deprecated) (Senha - Descontinuado):

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

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

    • User name (Nome de usuário): Digite o nome de usuário Snowflake.

    • Private key specification (Especificação de chave privada): Selecione Unencrypted (Não criptografada) ou Encrypted key (Chave criptografada) para identificar o tipo de chave privada usada.

    • Private key (Chave privada): Digite a chave privada. Para mais informações, consulte a documentação do Snowflake sobre Key-pair authentication and key-pair rotation.

    • Passphrase (Frase-passe): Se Encrypted key (Chave criptografada) for selecionada para Private key specification (Especificação de chave privada), digite a frase-passe associada à chave privada criptografada.

  • OAuth: Selecione esta opção para usar OAuth 2.0 de três pernas para autenticação. Para notas importantes sobre o comportamento do token de acesso e token de atualização, consulte Important notes.

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

  -   **Nome de usuário:** Digite o nome de usuário do Snowflake.
  
  -   **Aplicativo OAuth:** Selecione um aplicativo conector do Snowflake configurado na página [Registros de Aplicativos](/pt/management-console/customizations/customizations-app-registrations/) do Console de Gerenciamento. Para mais informações sobre como configurar um aplicativo conector do Snowflake na página **Registros de Aplicativos**, consulte os [pré-requisitos do OAuth de 3 etapas](/pt/integration-studio/design/connectors/snowflake/prerequisites/) do Snowflake.
  
  -   **Fazer login com o Snowflake:** Clique para autenticar através do Snowflake em uma guia separada do navegador e forneça consentimento para que o Jitterbit acesse o aplicativo Snowflake.
  

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

    • Nome do host: Digite o nome do host do Snowflake. Este é o nome da conta do 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: Digite o nome de usuário e a senha do Snowflake.

      O Snowflake está descontinuando a autenticação por senha de fator único

      O Snowflake está eliminando gradualmente a autenticação por senha de fator único para todos os usuários, incluindo as contas de serviço do tipo LEGACY_SERVICE necessárias para este tipo de autenticação Senha (Descontinuada). O lançamento é aplicado em fases:

      • Entre maio e julho de 2026, nenhuma nova conta LEGACY_SERVICE pôde ser criada; as existentes ainda não foram afetadas.
      • Entre agosto e outubro de 2026, o Snowflake migra todas as contas LEGACY_SERVICE restantes para TYPE=SERVICE de forma contínua, por conta, notificando cada conta de sua data de aplicação específica dentro desta janela. Após a migração, uma conta TYPE=SERVICE não pode mais autenticar com uma senha.

      Se sua conta do Snowflake for afetada, as conexões usando este tipo de autenticação falharão. Atualize a conexão para usar autenticação OAuth ou Key-Pair em vez disso e configure a conta de usuário do Snowflake para corresponder.

• Conta: Digite o nome da conta do Snowflake.

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

• Nome do schema: Digite o nome do schema do Snowflake.

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

  • Função: Digite a função do Snowflake. As funções disponíveis são GENERAL, PUBLIC e READONLY.

  • Nome do Warehouse: Digite o nome do warehouse do Snowflake.

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

    Quando desmarcado (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.

  • Propriedades Personalizadas de Conexão: Clique no ícone de adição para adicionar uma linha à tabela associada e digite uma Chave e um Valor para uma propriedade personalizada correspondente a um parâmetro de conexão JDBC do Snowflake. Por padrão, uma linha para JDBC_QUERY_RESULT_FORMAT é definida com um valor de JSON.

    Para salvar a linha, clique no ícone de envio na coluna mais à direita.

    Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de edição ou o ícone de exclusão .

Para excluir todas as linhas, clique em Limpar tudo.

• Usar aspas para identificadores do Snowflake: Selecione esta opção para colocar aspas em identificadores do Snowflake, como nomes de tabelas e colunas, no SQL gerado pelo conector. O uso de aspas preserva a capitalização de um identificador em vez de convertê-lo para maiúsculas, o que pode causar um erro, e permite identificadores que contêm caracteres especiais, como um hífen, que o Snowflake rejeita como sintaxe inválida quando sem aspas. 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 oferece suporte à suspensão do download da versão mais recente do conector usando a política organizacional Desabilitar atualização automática do conector.

• Salvar: 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 solicita 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 (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Após criar uma conexão do Snowflake, coloque um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (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 no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

• Get: Recupera um arquivo CSV de dados de tabela ou visualização do Snowflake e é destinado a ser usado como 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 fonte em uma operação.

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

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

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

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

• Delete: Exclui dados de tabela e visualização do Snowflake e é destinado a ser usado como 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 destino em uma operação.