Modelos de consulta

O Adobe Experience Platform Query Service permite salvar e reutilizar o código SQL na forma de modelos de consulta. Os modelos economizam esforço, evitando a repetição de tarefas executadas com frequência. Você pode compartilhar modelos em sua organização e alterar facilmente os valores de query sem precisar acessar ou entender o SQL subjacente.

Este documento fornece as informações necessárias para criar modelos de consulta no Serviço de consulta.

Pré-requisitos

Você deve ter a permissão Manage queries habilitada para acessar o Editor de consultas e exibir o painel de consultas na interface do Experience Platform. A permissão é habilitada por meio da Adobe Admin Console. Entre em contato com o administrador da organização se você não tiver privilégios de administrador para habilitar essa permissão. Consulte a documentação de controle de acesso para obter instruções completas sobre como adicionar permissões por meio do Admin Console.

Criar um modelo de consulta

Você pode criar modelos de consulta por meio de dois métodos, fazendo uma solicitação POST para o ponto de extremidade da API de Serviço de Consulta query-templates ou gravando, nomeando e salvando uma consulta por meio do Editor de Consultas.

Use o Editor de consultas para criar e salvar uma consulta como modelo

Consulte a documentação para obter instruções sobre como usar o Editor de consultas para gravar e salvar consultas. Depois de nomear e salvar sua consulta, ela estará disponível para ser reutilizada como um modelo de consulta na guia Templates.

Criar um modelo a partir de um acelerador do Data Distiller create-from-accelerator

Os aceleradores do Data Distiller são somente leitura. Para modificar um acelerador, crie um modelo editável no Editor de consultas.

Abra um acelerador e selecione Create custom template para clonar o SQL. Salve o modelo para adicioná-lo à guia Templates. O modelo clonado é totalmente editável e pode ser executado, programado ou modificado conforme necessário.

Consulte o guia Data Distiller Accelerators para obter instruções detalhadas.

TIP
Quando você salva uma consulta no Editor de consultas, uma mensagem de confirmação aparece para notificá-lo sobre a ação bem-sucedida. Esta mensagem pop-up contém um link que fornece uma maneira conveniente de navegar até o espaço de trabalho de agendamento de consultas. Consulte a documentação de consultas de agendamento para saber como executar consultas em uma cadência personalizada.

Procurar modelos de consulta browse

No espaço de trabalho Consultas da interface do Experience Platform, selecione Templates para exibir a lista de consultas salvas disponíveis.

O espaço de trabalho de consultas com a guia Modelos realçada.

Para encontrar informações relevantes sobre o modelo, selecione qualquer modelo de consulta na lista disponível para abrir o painel de detalhes.

O painel de detalhes no espaço de trabalho de consultas com a ID de consulta realçada.

No painel de detalhes, é possível executar as seguintes ações:

  • Selecione Run as CTAS para criar uma nova tabela selecionando dados de uma ou mais tabelas existentes. Essa opção só estará disponível se você tiver uma consulta SELECT.
  • Selecione Add schedule para começar a editar seu agendamento para seu modelo de consulta.
  • Selecione View schedule para navegar até a guia Schedules do Editor de Consulta. Essa exibição contém todas as informações de agendamento associadas à consulta.
  • Selecione Delete query para excluir o modelo.
  • Selecione o nome do modelo para navegar até o Editor de consultas onde o SQL está pré-preenchido para edição.

Usar a API do Serviço de consulta para criar um modelo

Consulte a documentação para obter instruções sobre como criar um modelo de consulta usando a API do Serviço de Consulta. Os detalhes de um template de consulta recém-criado estão contidos no corpo da resposta.

NOTE
Os modelos criados usando a API também estão visíveis na guia Modelos do serviço de consulta da interface do Experience Platform.

Próximas etapas

Ao ler este documento, agora você tem uma melhor compreensão de como criar modelos de consulta no Serviço de consulta. Consulte a visão geral da interface ou o Guia da API do Serviço de Consulta para saber mais sobre os recursos do Serviço de Consulta.

Consulte o manual de endpoint de consultas agendadas para saber como agendar consultas usando a API ou o guia do Editor de Consultas para a interface do usuário.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb