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 query para dados de experiência do cliente na interface do Experience Platform usuário. Query Editor O oferece suporte ao desenvolvimento de query para a exploração de análises e dados e permite que você execute query interativos para fins de desenvolvimento, bem como query não interativos para preencher conjuntos de dados em Experience Platform.

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

Introdução

Query Editor fornece execução flexível de query conectando-se a Query Servicee os query só serão executados enquanto essa conexão estiver ativa.

Conexão com Query Service

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

Imagem

Como os query são executados de Query Editor

Query executados de Query Editor são executados interativamente. Isso significa que, se você fechar o navegador ou sair, o query será cancelado. Isso também é válido para query criados 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 query para dados de experiência do cliente. Todos os query executados em Query Editor, ou salvos, estão disponíveis para todos os usuários em sua organização com acesso a Query Service.

Acesso ao Query Editor

Na interface do usuário Experience Platform, clique em Query no menu de navegação esquerdo para abrir a área de trabalho Query Service. Em seguida, clique em Criar Query na parte superior direita da tela para start gravando query. Esse link está disponível em qualquer página na área de trabalho Query Service.

Imagem

Gravando query

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

Imagem

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

Gravando ferramentas em Query Editor

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

Imagem

  • Palavra-chave SQL completar automaticamente: Start digitando seu query, depois use as teclas de seta para navegar até o termo desejado e pressione Enter.

Imagem

  • Preencher automaticamente a tabela e o campo: Start digitando o nome SELECT da tabela a partir da qual você deseja inserir, use as teclas de seta para navegar até a tabela que você 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 valida automaticamente um query à medida que você o escreve, fornecendo validação SQL genérica e validação de execução específica. Se um sublinhado vermelho aparecer abaixo do query (como mostrado na imagem abaixo), ele representa um erro dentro do query.

Imagem

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

Imagem

Detalhes do query

Enquanto você exibe um query em Query Editor, o painel Detalhes do Query fornece ferramentas para gerenciar o query selecionado.

Imagem

Esse painel permite que você gere um conjunto de dados de saída diretamente da interface do usuário, exclua ou nomeie o query exibido e visualização o código SQL em um formato fácil de copiar na guia Query SQL. Esse painel também mostra metadados úteis, como a última vez que o query foi modificado e quem o modificou, se aplicável. Para gerar um conjunto de dados, clique em Conjunto de Dados de Saída. A caixa de diálogo Conjunto de Dados de Saída é exibida. Digite um nome e uma descrição e clique em Executar Query. O novo conjunto de dados é exibido na guia Datasets na interface do usuário Query Service em Platform.

Salvando query

Query Editor fornece uma função de gravação que permite salvar um query e trabalhar nele posteriormente. Para salvar um query, clique em 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 painel Detalhes do Query.

Como encontrar query anteriores

Todos os query executados de Query Editor são capturados na tabela Log. Você pode usar a funcionalidade de pesquisa na guia Log para localizar execuções de query. Os query salvos estão listados na guia Procurar.

Consulte a visão geral da interface do Query Service para obter mais informações.

OBSERVAÇÃO

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

Execução de query usando o Editor de Query

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

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 query que estão sendo executadas e quaisquer mensagens de erro que resultem desses query.

Imagem

OBSERVAÇÃO

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

Resultados do query

Depois que um query é concluído, os resultados são exibidos na guia Resultados, ao lado da guia Console. Esta visualização mostra a saída tabular do 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 seu query, remova os limites das linhas retornadas e execute o query com CREATE TABLE tablename AS SELECT para gerar um conjunto de dados com a saída. Consulte o tutorial gerando conjuntos de dados para obter instruções sobre como gerar um conjunto de dados a partir dos resultados do query em Query Editor.

Imagem

Executar query com o vídeo tutorial Query Service

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

Próximas etapas

Agora que você sabe quais recursos estão disponíveis em Query Editor e como navegar no aplicativo, é possível criar seus próprios query diretamente em Platform no start. Para obter mais informações sobre como executar query SQL em relação a conjuntos de dados em Data Lake, consulte o guia em executar query.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free