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 obter 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-se por meio 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.

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

      O Snowflake anunciou a descontinuação futura da autenticação de fator único, que afeta integrações que se conectam ao Snowflake usando uma senha. Todos os usuários do conector do Snowflake que usam o tipo de autenticação 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.

• Conta: Digite o nome da conta do Snowflake.

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

• Nome do esquema: Digite o nome do esquema 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 que o conector gera. 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 suporta suspender o 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, você coloca 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 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 vários esquemas do 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 dados de 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.