Ir para o conteúdo

Snowflake Obtém Atividade

Introdução

Uma atividade Snowflake Get, usando sua conexão Snowflake, recupera um arquivo CSV de dados de tabela ou visualização do Snowflake e deve ser usado como fonte para fornecer dados em uma operação.

Nota

Dependendo das suas permissões do Snowflake, a atividade Get retornará apenas os dados aos quais você tem acesso. Por exemplo, se você tiver permissões apenas para visualizar dados, a atividade Get retornará apenas dados de visualização e não retornará dados de tabela.

Crie uma Atividade de Obtenção de Snowflake

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

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade Snowflake Get existente pode ser editada nestes locais:

Configurar uma Atividade Snowflake Get

Siga estas etapas para configurar uma atividade Snowflake Get:

Etapa 1: Insira um Nome e Selecione um Objeto

Nesta etapa, forneça um nome para a atividade e selecione uma tabela ou visualização (consulte Visão geral das visualizações do Snowflake). Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade do Snowflake Get

Dica

Campos com ícone de variável Ícone de 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 da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade Snowflake Get e não deve conter barras / ou dois pontos :.

  • Selecione um objeto: Esta seção exibe objetos disponíveis no endpoint Snowflake. Ao reabrir uma configuração de atividade existente, apenas o objeto selecionado é exibido em vez de recarregar toda a lista de objetos.

    • Objeto Snowflake selecionado: Depois que um objeto é selecionado, ele é listado aqui.

    • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas. Se os objetos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar objetos do endpoint durante a pesquisa, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para recarregar objetos do endpoint Snowflake. Isso pode ser útil se objetos tiverem sido adicionados ao Snowflake. Esta ação atualiza todos os metadados usados para construir a tabela de objetos exibidos na configuração.

    • Selecionando um objeto: Na tabela, clique em qualquer lugar de uma linha para selecionar um objeto. Apenas um objeto pode ser selecionado. As informações disponíveis para cada objeto são obtidas no endpoint Snowflake:

      • Nome: O nome de um objeto, seja uma tabela ou uma visualização.

      • Tipo: O tipo do objeto, seja uma tabela ou uma visualização.

    Dica

    Se a tabela não for preenchida com objetos disponíveis, a conexão Snowflake pode não ter sucesso. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

  • NullIf: O valor a ser retornado se um resultado for NULL.

  • Campo opcionalmente incluído por: O caractere opcional usado para incluir o campo NullIf.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revise os Esquemas de Dados

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

Etapa 2 da configuração da atividade do Snowflake Get

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

    O conector Snowflake usa o Driver JDBC Snowflake e os comandos SQL do Snowflake. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

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

    • Solicitar

      Campo/nó do esquema de solicitação Notas
      stageName Nome do estágio interno do Snowflake usado ao obter dados da tabela.

      Nota

      O stageName é o nome de uma área de teste interna do Snowflake, que precisa ser pré-existente antes de executar uma operação usando esta atividade. O arquivo é primeiro copiado para a área de teste antes de ficar disponível para o conector.

      fileName Nome do arquivo no estágio interno do Snowflake a ser usado ao obter dados da tabela.
      compressData Sinalizador booleano para compactar os dados antes de enviá-los para o estágio interno do Snowflake.
      fileFormat Nó do formato do arquivo.
      nullIf Valor de exibição para NULLIF.
      FIELD_OPTIONALLY_ENCLOSED_BY Delimitador usado para delimitar o NULLIF entrada.
    • Resposta

      Campo/nó do esquema de resposta Notas
      fileName Nome do arquivo no estágio interno do Snowflake usado ao obter dados da tabela (idênticos à solicitação).
      content Conteúdo da tabela Snowflake em formato CSV.
  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Refresh para regenerar esquemas do endpoint Snowflake. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos

Depois de configurar uma atividade Snowflake Get, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas de operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu Ações da atividade em Noções básicas do conector.

As atividades Snowflake Get podem ser usadas como fonte com estes padrões de operação:

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

Quando estiver pronto, implantar e execute a operação e validar o comportamento verificando os logs de operação.