Query Editor Guia da interface do usuário

Query Editor é uma ferramenta interativa fornecida pela Adobe Experience Platform Query Service, que permite gravar, validar e executar consultas para dados de experiência do cliente na Experience Platform interface do usuário. Query Editor O suporta o desenvolvimento de consultas para análise e exploração de dados e permite executar consultas interativas para fins de desenvolvimento, bem como consultas não interativas para preencher conjuntos de dados no Experience Platform.

Para obter mais informações sobre os conceitos e os recursos de Query Service, consulte o Visão geral do Serviço de query. Para saber mais sobre como navegar na interface do usuário do Serviço de query em Platform, consulte o Visão geral da interface do usuário do serviço de query.

Introdução

Query Editor fornece execução flexível de consultas ao conectar-se a Query Servicee as consultas só serão executadas enquanto esta conexão estiver ativa.

Conexão com Query Service

Query Editor leva alguns segundos para inicializar e se conectar Query Service quando for aberto. O console informa quando está conectado, como mostrado abaixo. Se você tentar executar uma query antes que o editor esteja conectado, a execução será adiada até que a conexão seja concluída.

Imagem

Como as consultas são executadas a partir de Query Editor

Consultas executadas de Query Editor executar interativamente. Isso significa que se você fechar o navegador ou sair, a consulta será cancelada. Isso também é verdadeiro para queries feitos para gerar conjuntos de dados de saídas de query.

Criação de query usando Query Editor

Usando Query Editor, você pode gravar, executar e salvar consultas para dados de experiência do cliente. Todas as consultas executadas ou salvas em Query Editor estão disponíveis para todos os usuários em sua organização com acesso a Query Service.

Acesso ao Query Editor

No Experience Platform UI, selecione Queries no menu de navegação esquerdo para abrir o Query Service espaço de trabalho. Em seguida, selecione Criar Consulta na parte superior direita da tela para começar a gravar queries. Esse link está disponível em qualquer uma das páginas no Query Service espaço de trabalho.

Imagem

Gravação de queries

Editor de consultas O é organizado para facilitar ao máximo a gravação de consultas. A captura de tela abaixo mostra como o editor aparece na interface do usuário, com o Reproduzir botão e campo de entrada SQL realçado.

Imagem

Para minimizar o tempo de desenvolvimento, é recomendável desenvolver as consultas com limites nas linhas retornadas. Por exemplo, SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Depois de verificar se a consulta produz a saída esperada, remova os limites e execute a consulta com CREATE TABLE tablename AS SELECT para gerar um conjunto de dados com a saída.

Ferramentas de escrita em Query Editor

  • Realce automático da sintaxe: Facilita a leitura e a organização do SQL.

Imagem

  • Preenchimento automático de palavra-chave SQL: Comece a digitar sua consulta, use as teclas de seta para navegar até o termo desejado e pressione Enter.

Imagem

  • Preenchimento automático de tabela e campo: Comece a digitar o nome da tabela que deseja SELECT em seguida, use as teclas de seta para navegar até a tabela que está procurando e pressione Enter. Depois que uma tabela é selecionada, o preenchimento automático reconhecerá os campos nessa tabela.

Imagem

Detecção de erros

Query Editor O valida automaticamente uma query à medida que você a escreve, fornecendo validação genérica de SQL e validação de execução específica. Se um sublinhado vermelho aparecer abaixo da query (como mostrado na imagem abaixo), ele representará um erro no query.

Imagem

Quando os erros são detectados, é possível exibir as mensagens de erro específicas passando o mouse sobre o código SQL.

Imagem

Detalhes da consulta

Enquanto você exibe um query em Query Editor, o Detalhes da consulta O painel fornece ferramentas para gerenciar a consulta selecionada.

Imagem

Esse painel permite gerar um conjunto de dados de saída diretamente da interface do usuário, excluir ou nomear a consulta exibida e adicionar um agendamento à consulta.

Esse painel também mostra metadados úteis, como a última vez que a query foi modificada e quem a modificou, se aplicável. Para gerar um conjunto de dados, selecione Conjunto de dados de saída. O Conjunto de dados de saída será exibida. Insira um nome e uma descrição, em seguida, selecione Executar Consulta. O novo conjunto de dados é exibido na variável Conjuntos de dados na guia Query Service interface do usuário em Platform.

Consultas agendadas

IMPORTANTE

Esta é uma lista de limitações para consultas agendadas ao usar o Editor de consultas. Não se aplicam à Query Service API:
Você só pode adicionar um agendamento a um query que já tenha sido criado, salvo e executado.
Você cannot adicione um agendamento a um query parametrizado.
Consultas agendadas cannot contém um bloco anônimo.

Para adicionar um agendamento a um query, selecione Adicionar programação.

Imagem

O Detalhes da programação será exibida. Nesta página, você pode escolher a frequência do query agendado, as datas em que o query agendado será executado, bem como o conjunto de dados para o qual exportar o query.

Imagem

Você pode escolher as seguintes opções para Frequência:

  • Por hora: A consulta agendada será executada a cada hora para o período de datas selecionado.
  • Diariamente: A consulta agendada será executada a cada X dias no momento e no período de datas selecionado. Observe que o tempo selecionado está em UTC, e não seu fuso horário local.
  • Semanalmente: A consulta selecionada será executada nos dias da semana, da hora e do período de datas selecionado. Observe que o tempo selecionado está em UTC, e não seu fuso horário local.
  • Mensalmente: A consulta selecionada será executada todos os meses no dia, hora e período de datas selecionado. Observe que o tempo selecionado está em UTC, e não seu fuso horário local.
  • Anualmente: A consulta selecionada será executada todos os anos no dia, mês, hora e período de datas selecionado. Observe que o tempo selecionado está em UTC, e não seu fuso horário local.

Para o conjunto de dados, você tem a opção de usar um conjunto de dados existente ou criar um novo conjunto de dados.

IMPORTANTE

Como você está usando um conjunto de dados existente ou está criando um novo, not precisa incluir INSERT INTO ou CREATE TABLE AS SELECT como parte do query, já que os conjuntos de dados já estão definidos. Incluindo INSERT INTO ou CREATE TABLE AS SELECT como parte das consultas agendadas, resultará em um erro.

Depois de confirmar todos esses detalhes, selecione Salvar para criar um agendamento.

A página de detalhes da consulta é exibida novamente e agora mostra os detalhes do agendamento recém-criado, incluindo a ID do agendamento, o próprio agendamento e o conjunto de dados de saída do agendamento. Você pode usar a ID de agendamento para pesquisar mais informações sobre as execuções do próprio query agendado. Para saber mais, leia o guia de endpoints de execução de query agendada.

OBSERVAÇÃO

Você só pode agendar one modelo de consulta usando a interface do usuário do . Se quiser adicionar agendamentos adicionais a um template de query, será necessário usar a API . Se um agendamento já tiver sido adicionado usando a API, você not possa adicionar agendamentos adicionais usando a interface do usuário do . Se vários agendamentos já estiverem anexados a um template de query, somente o agendamento mais antigo será exibido. Para saber como adicionar agendamentos usando a API, leia o guia do endpoint de consultas agendadas.

Além disso, você deve atualizar a página se quiser garantir que tenha o estado mais recente do agendamento que está visualizando.

Excluir um agendamento

Você pode excluir uma programação selecionando Excluir um agendamento.

Imagem

IMPORTANTE

Se quiser excluir um agendamento para um query, desative o agendamento primeiro.

Salvar consultas

Query Editor O fornece uma função save que permite salvar um query e trabalhar nele posteriormente. Para salvar um query, selecione Salvar no canto superior direito de Query Editor. Antes que um query possa ser salvo, um nome deve ser fornecido para o query usando o Detalhes da consulta painel.

OBSERVAÇÃO

Consultas nomeadas e salvas no usando o Editor de consultas estão disponíveis como modelos no painel Consulta Procurar guia . Consulte a documentação dos modelos para obter mais informações.

Como encontrar consultas anteriores

Todas as consultas executadas de Query Editor são capturados na tabela Log. Você pode usar a funcionalidade de pesquisa no Log para localizar execuções de query. As consultas salvas são listadas na variável Procurar guia .

Consulte a Visão geral da interface do usuário do serviço de query para obter mais informações.

OBSERVAÇÃO

As consultas que não são executadas não são salvas pelo Log. Para que o query esteja disponível em Query Service, ele deve ser executado ou salvo em Query Editor.

Execução de consultas usando o Editor de consultas

Para executar um query em Query Editor, você pode inserir SQL no editor ou carregar uma query anterior do Log ou Procurar e selecione Reproduzir. O status da execução da consulta é exibido na variável Console guia abaixo, e os dados de saída são mostrados na guia Resultados guia .

Console

O console fornece informações sobre o status e a operação do Query Service. O console exibe o status da conexão com Query Service, as operações de query sendo executadas e qualquer mensagem de erro que resulte dessas consultas.

Imagem

OBSERVAÇÃO

O console mostra apenas erros que resultaram da execução de um query. Ele não mostra erros de validação de consulta antes da execução de um query.

Resultados da consulta

Depois que um query é concluído, os resultados são exibidos na variável Resultados , ao lado do Console guia . Esta exibição mostra a saída em tabela de seu query, exibindo até 100 linhas. Essa visualização permite verificar se o query produz a saída esperada. Para gerar um conjunto de dados com sua consulta, remova os limites das linhas retornadas e execute a consulta com CREATE TABLE tablename AS SELECT para gerar um conjunto de dados com a saída. Consulte a tutorial de geração de conjuntos de dados para obter instruções sobre como gerar um conjunto de dados a partir dos resultados do query, Query Editor.

Imagem

Execute consultas com Query Service vídeo tutorial

O vídeo a seguir mostra como executar consultas na interface do Adobe Experience Platform e em um cliente PSQL. Além disso, é demonstrado o uso de propriedades individuais em um objeto XDM, usando funções definidas pelo Adobe e usando CREATE TABLE AS SELECT (CTAS).

Próximas etapas

Agora que você sabe quais recursos estão disponíveis no Query Editor e como navegar no aplicativo, você pode começar a criar suas próprias consultas diretamente em Platform. Para obter mais informações sobre a execução de queries SQL em relação a conjuntos de dados em Data Lake, consulte o guia em execução de consultas.

Nesta página