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 Create Query na parte superior direita da tela para começar a gravar queries. Esse link está disponível em qualquer página no espaço de trabalho Query Service.

Imagem

Gravação de queries

Query Editor 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 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ê está visualizando uma consulta em Query Editor, o painel Query Details 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 exibir o código SQL em um formato fácil de copiar na guia SQL Query. 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 Output Dataset. A caixa de diálogo Output Dataset é exibida. Insira um nome e uma descrição, depois selecione Run Query. O novo conjunto de dados é exibido na guia Datasets na interface do usuário Query Service em Platform.

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 Query Details.

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

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now