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 interface do Experience Platform 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 a Visão geral do serviço de consulta. Para saber mais sobre como navegar na interface do usuário do Serviço de query em Platform, consulte a Visão geral da interface do usuário do Serviço de query.

Introdução

Query Editor O fornece execução flexível de consultas ao conectar-se a Query Service, e as consultas só serão executadas enquanto essa conexão estiver ativa.

Conectando a Query Service

Query Editor leva alguns segundos para inicializar e se conectar Query Service quando é aberto. O Console informa quando ele 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 a partir de Query Editor são executadas 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 em Query Editor, ou salvas, estão disponíveis para todos os usuários em sua organização com acesso a Query Service.

Acesso ao Query Editor

Na interface Experience Platform, selecione Queries no menu de navegação esquerdo para abrir o espaço de trabalho Query Service. Em seguida, selecione Criar consulta na parte superior direita da tela para começar a gravar consultas. Esse link está disponível em qualquer página no espaço de trabalho Query Service.

Imagem

Gravação de queries

O Query Editor é 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 botão Play e o 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.

A escrever ferramentas em Query Editor

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

Imagem

  • Preenchimento automático da 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 SELECT da tabela de onde deseja criar, 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 painel Detalhes da consulta fornece ferramentas para gerenciar a query 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. A caixa de diálogo Conjunto de dados de saída é exibida. Insira um nome e uma descrição, depois selecione Executar Consulta. O novo conjunto de dados é exibido na guia Conjuntos de dados na interface do usuário Query Service em Platform.

Consultas agendadas

OBSERVAÇÃO

Você só pode adicionar um agendamento a um query que já tenha sido criado, salvo e executado. Além disso, você not poderá adicionar um agendamento a uma consulta parametrizada.

Para adicionar um agendamento a um query, selecione Adicionar agendamento.

Imagem

A página Schedule details é 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 Frequency:

  • 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 a hora selecionada 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 a hora selecionada 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 a hora selecionada 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 a hora selecionada 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 criando um novo, not precisa incluir INSERT INTO ou CREATE TABLE AS SELECT como parte da consulta, já que os conjuntos de dados já estão definidos. A inclusão de INSERT INTO ou CREATE TABLE AS SELECT como parte das consultas agendadas resultará em um erro.

Depois de confirmar todos esses detalhes, selecione Save 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 consulta agendados.

OBSERVAÇÃO

Você só pode agendar um modelo de consulta usando a interface do usuário. 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 será adicionado a agendamentos adicionais usando a interface do usuário. 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 um agendamento 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 Save no canto superior direito de Query Editor. Antes que uma consulta possa ser salva, um nome deve ser fornecido para a consulta usando o painel Detalhes da consulta.

Como encontrar consultas anteriores

Todas as consultas executadas de Query Editor são capturadas na tabela Log. Você pode usar a funcionalidade de pesquisa na guia Log para localizar execuções de consulta. As consultas salvas são listadas na guia Browse.

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

OBSERVAÇÃO

As consultas que não são executadas não são salvas pelo Log. Para que a consulta esteja disponível em Query Service, ela deve ser executada ou salva em Query Editor.

Execução de consultas usando o Editor de consultas

Para executar uma consulta em Query Editor, você pode inserir SQL no editor ou carregar uma consulta anterior da guia Log ou Browse e selecionar Play. O status da execução da consulta é exibido na guia Console abaixo, e os dados de saída são mostrados na guia Results.

Console

O console fornece informações sobre o status e a operação de Query Service. O console exibe o status da conexão com Query Service, as operações de consulta que estão sendo executadas e quaisquer mensagens de erro que resultem 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

Após a conclusão de um query, os resultados são exibidos na guia Results, ao lado da guia Console. 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 nas linhas retornadas e execute a consulta com CREATE TABLE tablename AS SELECT para gerar um conjunto de dados com a saída. Consulte o tutorial de geração de conjuntos de dados para obter instruções sobre como gerar um conjunto de dados a partir de resultados de query em Query Editor.

Imagem

Executar consultas com vídeo tutorial Query Service

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 em Query Editor e como navegar no aplicativo, é possível começar a criar suas próprias consultas diretamente em Platform. Para obter mais informações sobre como executar consultas SQL em relação a conjuntos de dados em Data Lake, consulte o guia em executar consultas.

Nesta página