Atividade de Consulta Snowflake v2

Introdução

Uma atividade de Consulta v2 do Snowflake, utilizando sua conexão Snowflake, recupera um arquivo CSV de dados de tabela ou visualização em vários esquemas do Snowflake e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

Criar uma atividade de Consulta Snowflake

Uma instância de uma atividade de Consulta v2 do Snowflake é criada a partir de uma conexão Snowflake usando seu tipo de atividade Consulta v2.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente de Consulta v2 do Snowflake pode ser editada a partir destes locais:

• A tela de design (veja Menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma atividade de Consulta Snowflake

Siga estas etapas para configurar uma atividade de Consulta v2 do Snowflake:

• Etapa 1: Insira um nome e selecione um objeto
  Forneça um nome para a atividade e selecione um objeto.

• Passo 2: Construa sua consulta
  Defina condições em uma consulta usando os campos do objeto e aplique paginação a uma consulta.

• Passo 3: Revise os esquemas de dados
  Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Passo 1: Insira um nome e selecione um objeto

Neste passo, forneça um nome para a atividade e selecione uma tabela ou visualização (veja a Visão Geral das Visualizações da Snowflake). Cada elemento da interface do usuário deste passo é descrito abaixo.

• Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Mudar o endpoint atribuído em Telasc de configuração.

  • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

• Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Query v2 da Snowflake e não deve conter barras / ou dois pontos :.

• Selecionar Tabela(s)/Visualização(ões): Esta seção exibe tabelas e visualizações disponíveis no endpoint da Snowflake. Ao reabrir uma configuração de atividade existente, apenas a tabela ou visualização selecionada é exibida em vez de recarregar toda a lista.

  • Filtro: Insira um filtro para o nome da tabela ou visualização a ser carregada, usando % como um caractere curinga SQL para corresponder a qualquer string. Por exemplo, insira INFORMATION_SCHEMA.% para listar todas as tabelas e visualizações no INFORMATION_SCHEMA. Clique em Atualizar após inserir um filtro para carregar os resultados correspondentes.

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para carregar ou recarregar tabelas e visualizações do endpoint da Snowflake usando o filtro atual. Um filtro deve ser inserido antes de atualizar. Isso também pode ser útil se tabelas ou visualizações foram recentemente adicionadas ao Snowflake.

• Selecionando tabelas ou visualizações: Após a atualização, as tabelas e visualizações correspondentes são exibidas em uma lista à esquerda. Clique em uma tabela ou visualização para adicioná-la à tabela de seleção à direita. Os itens selecionados são destacados. Qualquer número de tabelas e visualizações pode ser selecionado para construir uma consulta de múltiplas tabelas com junções.

  !!! tip "Dica"
      Se a lista não for preenchida com tabelas ou visualizações disponíveis após inserir um filtro e atualizar, a [conexão com o Snowflake](/pt/integration-studio/design/connectors/snowflake/connection/) pode não ter sido bem-sucedida. Certifique-se de que você está conectado reabrindo a conexão e retestando as credenciais.
  

• Tabela de tabelas e visualizações selecionadas: As tabelas e visualizações selecionadas são exibidas em uma tabela à direita. Cada coluna é descrita abaixo:

  -   **Tabela:** O nome da tabela ou visualização selecionada.
  
  -   **Pai:** Para cada tabela ou visualização filha que está sendo unida, use o dropdown para selecionar seu pai. A primeira tabela selecionada não tem pai e serve como a raiz da hierarquia de junção. Uma vez que um pai é selecionado, um link **Atribuir** aparece na coluna **Chaves de Link**.
  
  -   **Tipo de Junção:** Após as chaves de link terem sido atribuídas para uma tabela ou visualização filha, use o dropdown para selecionar o tipo de relacionamento entre a filha e seu pai:
  
      -   **Um ou Mais:** Cada registro pai deve ter pelo menos um registro filho.
  
      -   **Apenas Um:** Cada registro pai deve ter exatamente um registro filho.
  
      -   **Zero ou Mais:** Cada registro pai pode ter zero ou mais registros filhos.
  
      -   **Zero ou Um:** Cada registro pai pode ter zero ou um registro filho.
  
  -   **Chaves de Link:** Para cada tabela ou visualização filha com um **Pai** selecionado, clique em **Atribuir** para abrir uma janela separada onde você define os relacionamentos de chave entre o pai e o filho:
  
      -   **Objeto pai:** Exibe a tabela ou visualização pai e seus campos à esquerda. Use a caixa de pesquisa para filtrar campos.
  
      -   **Objeto filho:** Exibe a tabela ou visualização filha e seus campos à direita. Use a caixa de pesquisa para filtrar campos.
  
      -   **Atribuir chave(s) de link:** Arraste um campo do pai para o campo correspondente no filho (ou vice-versa) para criar um link. Repita para atribuir múltiplos pares de chaves.
  
      -   **Desatribuir chave(s) de link:** Clique em um campo que já foi vinculado para remover sua atribuição de link.
  
      -   **Recomeçar:** Clique para limpar todas as chaves de link atribuídas.
  
      -   **Finalizar:** Clique para salvar as atribuições de chaves de link e fechar a janela. O número de chaves de link atribuídas aparece na coluna **Chaves de Link** e o dropdown **Tipo de Junção** se torna disponível.
  

  Nota

  O botão Próximo permanece desativado até que todas as tabelas e visualizações com um pai selecionado tenham suas chaves de link atribuídas. Um aviso é exibido na parte inferior da tela se houver atribuições de chaves de link pendentes.

• Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Finalizado na última etapa.

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

Etapa 2: Construa sua consulta

Nesta etapa, construa uma declaração de consulta definindo condições para campos de objeto e aplicando paginação, seja através do construtor de consultas ou inserindo manualmente uma declaração de consulta. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Pesquisar: Insira qualquer parte do nome de um campo na caixa de pesquisa para filtrar a lista de campos do objeto selecionado. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada tecla pressionada.

• Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para recarregar os campos do objeto a partir do endpoint do Snowflake.

• Selecionar Todos: Ao usar a caixa de pesquisa para filtrar, você pode usar esta caixa de seleção para selecionar todos os campos visíveis de uma vez.

• Selecionar campos: Selecione as caixas de seleção dos campos que você deseja incluir na consulta para que sejam adicionados automaticamente à declaração da consulta na String da consulta. Você também pode Selecionar Todos os campos de uma vez usando a caixa de seleção.

• Paginação: Para adicionar uma cláusula de paginação (um limite no número de registros com um deslocamento de registro opcional), você pode usar o dropdown para definir o limite de paginação e o campo para inserir um deslocamento. Se um deslocamento não for especificado, o padrão é 0. Uma única cláusula de paginação é suportada. Se a cláusula de paginação não for incluída, todos os registros são retornados.

  • Aplicar: Clique para construir automaticamente a cláusula com base nas seleções do dropdown e no valor inserido. A cláusula de paginação construída automaticamente aparece na caixa de texto da String da consulta.

  • Remover: Clique para remover uma cláusula de paginação que foi aplicada.

• Condições: Para adicionar cláusulas condicionais, use os campos abaixo como entrada para ajudar a construir as cláusulas, que então aparecem na caixa de texto da String da consulta.

  • Campo: Use o dropdown para selecionar um campo do objeto selecionado.

  • Operador: Use o dropdown para selecionar um operador que seja apropriado para o tipo de dado do campo:

    Operador	Rótulo	Descrição
    =	Igual
    !=	Diferente
    IN (valor1, valor2)	Em	Na lista de valores.
    LIKE 'string'	Como	Como string.
    LIKE 'string%'	Começa com	Começa com string.
    LIKE '%string'	Termina com	Termina com string.
    LIKE '%string%'	Contém	Contém string.
    <	Menor que
    <=	Menor ou igual
    >	Maior que
    >=	Maior ou igual

  • Valor: Insira o valor desejado a ser usado com as seleções do dropdown.

  • Adicionar: Clique para construir automaticamente a cláusula com base nas seleções do dropdown e no valor inserido. A cláusula condicional é adicionada à caixa de texto String de consulta.

  • Remover Todos: Clique para remover todas as cláusulas condicionais inseridas.

• String de consulta: À medida que você seleciona campos, especifica condições e define paginação, a declaração de consulta nesta caixa de texto é preenchida automaticamente com os campos selecionados, condições e limites de paginação. Este campo é editável, o que significa que você pode inserir manualmente uma declaração de consulta ou editar a declaração preenchida automaticamente.

  Nota

  Os valores de quaisquer variáveis globais usadas na String de consulta não são preenchidos ao usar o botão Testar Consulta, mesmo que um valor padrão seja especificado. Os valores das variáveis globais serão obtidos em tempo de execução quando a consulta for executada. Para testar a consulta com um valor de variável padrão, use uma variável de projeto em vez disso.

  Importante

  Para usar uma declaração de consulta que contenha elementos além daqueles selecionados por meio desta interface, você também deve selecionar a caixa de seleção Usar Esquema Estático.

• Usar Esquema Estático: Selecione para definir o esquema de resposta como um esquema estático que é independente da declaração de consulta. Isso permite que declarações de consulta personalizadas inseridas na caixa de texto String de consulta sejam usadas.

• Testar Consulta: Clique para validar a consulta. Se a consulta for válida, um máximo de 50 registros recuperados da consulta é exibido em uma tabela. Se a consulta não for válida, mensagens de erro relevantes são exibidas.

  Nota

  Durante a execução, o limite de 50 registros não é aplicado, a menos que seja especificado no campo Paginação (descrito anteriormente). Se você editar a String de consulta manualmente, a consulta deve ser válida e validada por meio deste botão para habilitar o botão Próximo.

• Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

• Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

  Nota

  Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

  Os esquemas de dados de solicitação e resposta padrão consistem nos seguintes nós e campos:

  • Solicitação

    Campo/Nó do Esquema de Solicitação	Notas
    queryRequest	Nó da solicitação de consulta.
    whereClause	Nó da solicitação da cláusula WHERE.
    columnName	Nome da coluna da cláusula WHERE.
    condition	Condição da cláusula WHERE.
    value	Valor da cláusula WHERE.

  • Resposta

    Campo/Nó do Esquema de Resposta	Notas
    table	Nó mostrando o nome da tabela NAME.
    Entity	Nó da entidade.
    column_A	Valor da primeira coluna, COLOR.
    column_B	Valor da segunda coluna, FLOWER.
    . . .	Valores para as colunas da tabela subsequente.

Quando Usar Esquemas Estáticos é selecionado, o esquema de dados da resposta consiste nos seguintes nós e campos:

• Resposta

  | Campo/Nó do Esquema de Resposta | Notas                              |
  | ------------------------------- | ---------------------------------- |
  | **`queryResponse`**            | Nó da resposta da consulta.        |
  |                                 |                                    |
  | **`row`**                      | Nó da linha da resposta.           |
  |                                 |                                    |
  | **`item`**                     | Nó do item da resposta.            |
  | `columnName`                   | Nome da coluna do item da resposta. |
  | `columnValue`                  | Valor da coluna do item da resposta. |
  

Consulte os comandos SQL do Snowflake e a referência da API do Snowflake para informações adicionais.

• Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint do Snowflake. Esta ação também regenera um esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

• Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

• Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

• Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pergunta se você deseja confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Consulta v2 do Snowflake, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações de menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Conceitos básicos de conectores.

Atividades Query v2 do Snowflake podem ser usadas como uma fonte com esses padrões de operação:

• Padrão de transformação
• Padrão de arquivo com dois alvos (apenas como a primeira fonte)
• Padrão de arquivo HTTP com dois alvos (apenas como a primeira fonte)
• Padrão de duas transformações (como a primeira ou segunda fonte)

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.