Ir para o conteúdo

Atividade de Consulta do Amazon Redshift

Introdução

Uma atividade Query do Amazon Redshift, usando sua conexão do Amazon Redshift, recupera registros de uma tabela no Amazon Redshift e deve ser usado como fonte para fornecer dados em uma operação.

Crie uma Atividade de Consulta do Amazon Redshift

Uma instância de uma atividade Query do Amazon Redshift é criada a partir de uma conexão do Amazon Redshift usando seu tipo de atividade Query.

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 Query existente do Amazon Redshift pode ser editada nestes locais:

Configurar uma Atividade de Consulta do Amazon Redshift

Siga estas etapas para configurar uma atividade Query do Amazon Redshift:

Etapa 1: Insira um Nome e Selecione um Esquema

Nesta etapa, forneça um nome para a atividade e selecione um esquema. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade de consulta do Amazon Redshift

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade Query do Amazon Redshift e não deve conter barras (/) ou dois pontos (:).

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

    • Nome do esquema selecionado: Depois que um esquema é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer parte do nome do esquema na caixa de pesquisa para filtrar a lista de esquemas. A busca não diferencia maiúsculas de minúsculas. Se os esquemas já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar esquemas 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 Atualizar para recarregar esquemas do endpoint do Amazon Redshift. Isso pode ser útil se esquemas tiverem sido adicionados ao Amazon Redshift. Esta ação atualiza todos os metadados usados para construir a tabela de esquemas exibidos na configuração.

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

    Dica

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

  • 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 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 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: Selecione um Objeto

Nesta etapa, selecione um objeto. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade de consulta do Amazon Redshift

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

    • Nome do esquema selecionado: O nome do esquema selecionado na etapa anterior está listado aqui.

    • Selecione um nome de objeto: Depois que um objeto é selecionado, ele é listado aqui.

    • Pesquisar: Insira qualquer parte do nome do objeto 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 Atualizar para recarregar objetos do endpoint do Amazon Redshift. Isso pode ser útil se objetos tiverem sido adicionados ao Amazon Redshift. 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 buscadas no endpoint do Amazon Redshift:

      • Nome do objeto: O nome do objeto do Amazon Redshift.

      • Tipo: O tipo de objeto do Amazon Redshift.

      • Catálogo: O catálogo de objetos do Amazon Redshift.

    Dica

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

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 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 3: Crie Sua Consulta

Nesta etapa, defina condições em uma consultar usando os campos de objeto e aplique paginação a uma consultar. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 3 da configuração da atividade de consulta do Amazon Redshift

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.

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

  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Atualizar para recarregar campos do objeto do endpoint do Amazon Redshift.

  • Selecionar tudo: 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: Marque as caixas de seleção dos campos que você deseja incluir na consultar para que sejam adicionados automaticamente à instrução SELECT na String de consulta. Você também pode Selecionar todos os campos de uma vez usando a caixa de seleção.

  • Paging: 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 menu suspenso para definir o limite de paginação e o campo para inserir um deslocamento. Se um deslocamento não for especificado, o padrão será 0. Uma única cláusula de paginação é suportada. Se a cláusula de paginação não for incluída, todos os registros serão retornados.

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

    • 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 aparecem na caixa de texto Query String.

    • Objeto: Campo: Use o menu suspenso para selecionar um campo do objeto selecionado.

    • Operador: Use o menu suspenso para selecionar um operador apropriado para o tipo de dados do campo:

      Operador Etiqueta Descrição
      = Igual a
      != Não é igual
      COMO 'string' Curtir Como string
      COMO 'string%' Começa com Começa com string
      LIKE '%string' Termina com Termina com string
      COMO '%string%' Contém Contém string
      < Menos que
      <= Menor ou igual
      > Maior que
      >= Maior ou igual
    • Valor: Insira o valor desejado para usar com as seleções suspensas.

      Dica

      Ao usar variáveis globais nas condições de uma cláusula WHERE, é recomendado especificar um valor padrão para que o teste do script seja possível. Caso contrário, como as variáveis globais obtêm seu valor em tempo de execução, a sintaxe poderá ser invalidada durante o teste ou nenhum dado poderá ser retornado se nenhum valor padrão for especificado.

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

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

  • String de consulta: À medida que você seleciona campos, especifica condições e define a paginação, a instrução de consultar nesta caixa de texto é preenchida automaticamente com os campos, condições e limites de paginação selecionados.

  • Consulta de Teste: Clique para validar a consultar. Se a consultar for válida, uma amostra de até 10 registros recuperados da consultar será exibida em uma tabela. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. A consultar deve ser válida e validada através deste botão para habilitar o botão Próximo.

Consulta de teste de configuração da atividade de consulta do Amazon Redshift

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

  • Próximo: Clique para armazenar temporariamente a configuração desta 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 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 4: 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 4 da configuração da atividade de consulta do Amazon Redshift

  • 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 Amazon Redshift usa o Driver JDBC do Amazon Redshift versão 2.1.0.17 e Comandos SQL do Amazon Redshift. Consulte a documentação do Amazon Redshift e a Visão geral do sistema Amazon Redshift documentação para obter informações adicionais.

    O esquema de dados de resposta depende da consultar que foi especificada. Neste exemplo, ele consiste nestes nós e campos:

    • Resposta

      Campo/nó do esquema de resposta Notas
      accounts Nó de contas sendo consultadas
      balance Valor da conta consultada
      id ID da conta consultada
      name Nome da conta consultada
  • Atualizar: Clique no ícone de atualização Ícone de atualização ou a palavra Atualizar para regenerar esquemas do endpoint do Amazon Redshift. 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 Query do Amazon Redshift, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da 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 Query do Amazon Redshift podem ser usadas como origem 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.