Guia da interface do Editor de consultas

NOTE
O editor herdado foi descontinuado em 24 de maio de 2024. Ele não está mais acessível para uso. Agora você pode usar o Editor de consultas aprimorado para gravar, validar e executar suas consultas

O Editor de consultas é uma ferramenta interativa fornecida pelo Serviço de consultas Adobe Experience Platform, que permite gravar, validar e executar consultas para dados de experiência do cliente no Experience Platform interface do usuário. O Editor de consultas é compatível com 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 recursos do Serviço de consulta, consulte Visão geral do Serviço de consulta. Para saber mais sobre como navegar na interface do usuário do Serviço de consulta em Platform, consulte o Visão geral da interface do usuário do serviço de consulta.

Introdução getting-started

O Editor de consultas fornece execução flexível de consultas conectando-se ao Serviço de consulta, e as consultas somente são executadas enquanto essa conexão está ativa.

Acesso ao Editor de consultas accessing-query-editor

No Experience Platform Interface, selecione Consultas no menu de navegação esquerdo, para abrir o espaço de trabalho do Serviço de consulta. Em seguida, para começar a gravar consultas, selecione Criar consulta na parte superior direita da tela. Esse link está disponível em qualquer uma das páginas no espaço de trabalho do Serviço de consulta.

A guia de visão geral do espaço de trabalho Consultas com Create query realçado.

Conexão com o Serviço de consulta connecting-to-query-service

O Editor de consultas demora alguns segundos para inicializar e se conectar ao Serviço de consulta quando ele é aberto. O console informa quando está conectado, conforme mostrado abaixo. Se você tentar executar uma consulta antes que o editor se conecte, a execução será atrasada até que a conexão seja concluída.

A saída do console do Editor de consultas na conexão inicial.

Como as consultas são executadas no Editor de consultas run-a-query

As consultas executadas no Editor de consultas são executadas interativamente, o que significa que, se você fechar o navegador ou sair, a consulta será cancelada. O mesmo é verdadeiro para consultas feitas para gerar conjuntos de dados a partir de saídas de consulta.

Criação de consultas usando o Editor de consultas aprimorado query-authoring

NOTE
O editor herdado foi descontinuado em 24 de maio de 2024. Ele não está mais acessível para uso. Agora você pode usar o Editor de consultas aprimorado para gravar, validar e executar suas consultas.

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

Configurações settings

Um ícone de configurações acima do campo de entrada do Editor de consultas inclui uma opção para ativar/desativar o tema escuro ou desativar/ativar o preenchimento automático.

TIP
Você pode Desativar preenchimento automático de sintaxe ao criar uma consulta sem perder seu progresso.

Para ativar temas escuros ou claros, selecione o ícone de configurações ( Um ícone de configurações. ) seguido pela opção no menu suspenso que é exibida.

O Editor de consultas com o ícone de configurações e a opção de menu suspenso Ativar tema escuro estão realçados.

Preenchimento automático auto-complete

O Editor de consultas sugere automaticamente possíveis palavras-chave SQL, juntamente com detalhes de tabela ou coluna para a consulta à medida que ela é gravada. O recurso de preenchimento automático é ativado por padrão e pode ser desativado ou ativado a qualquer momento nas configurações do Editor de consultas.

A definição de configuração de preenchimento automático é por usuário e lembrada pelos logons consecutivos desse usuário. A desativação desse recurso impede que vários comandos de metadados sejam processados e fornece recomendações que normalmente beneficiam a velocidade do autor ao editar consultas.

Executar várias consultas sequenciais execute-multiple-sequential-queries

Use o Editor de consultas aprimorado para gravar mais de uma consulta e executar todas as consultas de maneira sequencial. A execução de várias consultas em uma sequência gera uma entrada de log. No entanto, somente os resultados da primeira consulta são exibidos no console do Editor de consultas. Verifique o log de consultas se precisar solucionar problemas ou confirmar as consultas executadas. Consulte a documentação dos logs de consulta para obter mais informações.

NOTE
Se uma consulta CTAS for executada após a primeira consulta no Editor de consultas, uma tabela ainda será criada, no entanto, não há saída no console do Editor de consultas.

Executar consulta selecionada execute-selected-query

Se tiver escrito várias consultas, mas precisar executar apenas uma, destaque a consulta escolhida e selecione a variável
Executar consulta selecionada ícone. Esse ícone é desativado por padrão até que você selecione a sintaxe de consulta no editor.

O Editor de consultas com o Executar consulta selecionada ícone realçado.

Cancelar sessão do Editor de consultas cancel-query

Assuma o controle da execução de consultas e melhore sua produtividade cancelando consultas de longa execução. Essa ação limpa o Editor de consultas durante uma execução de consulta. Esteja ciente de que a consulta continua a ser executada em segundo plano. Se for uma consulta CTAS, ela ainda gerará um conjunto de dados de saída. Para cancelar a execução no editor e continuar compondo uma instrução SQL, selecione Cancelar consulta após executar uma consulta.

O Editor de consultas com Cancelar consulta destacado.

Uma caixa de diálogo de confirmação é exibida. Selecionar Confirmar o para cancelar a execução da consulta.

A caixa de diálogo de confirmação Cancelar consulta com Confirmar foi realçada.

Contagem de resultados result-count

O Editor de consultas tem uma saída máxima de 50.000 linhas. Você pode escolher o número de linhas que são exibidas ao mesmo tempo no console do Editor de consultas. Para alterar o número de linhas exibidas no console, selecione a variável Contagem de resultados e selecione entre as opções 50, 100, 150, 300 e 500.

O Editor de consultas com a lista suspensa de contagem de resultados realçada.

Gravação de consultas writing-queries

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

O Editor de consultas com o campo de entrada SQL e Reproduzir realçados.

Para minimizar o tempo de desenvolvimento, é recomendável desenvolver consultas com limites no número de linhas retornadas. Por exemplo, SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Após verificar que sua 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 no Editor de consultas writing-tools

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

Uma instrução SQL no Editor de consultas demonstrando o realce da cor da sintaxe.

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

Alguns caracteres de SQL com o menu suspenso de preenchimento automático fornecendo opções do Editor de consultas.

  • Preenchimento automático de tabela e campo: Comece a digitar o nome da tabela que deseja SELECT do, em seguida, 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 reconhece os campos nessa tabela.

A entrada do Editor de consultas exibindo sugestões de nome de tabela suspensa.

Formatar texto format-text

A variável Formatar texto Esse recurso torna a consulta mais legível adicionando um estilo de sintaxe padronizado. Selecionar Formatar texto para padronizar todo o texto no Editor de consultas.

NOTE
A variável Formatar texto O recurso não funciona com blocos anônimos. Para saber como encadear uma ou mais instruções SQL sequencialmente, consulte documentação de bloqueio anônimo.

O Editor de consultas com Formatar texto e as instruções SQL destacadas.

Copiar SQL copy-sql

Selecione o ícone de cópia para copiar o SQL do Editor de consultas para a área de transferência. Esse recurso de cópia está disponível para modelos de consulta e consultas recém-criadas no Editor de consultas.

O espaço de trabalho Consultas com um modelo de consulta de exemplo com o ícone de cópia destacado.

Detalhes da consulta query-details

Para exibir uma consulta no Editor de consultas, selecione qualquer modelo salvo na Modelos guia. O painel de detalhes da consulta fornece mais informações e ferramentas para gerenciar a consulta selecionada. Ela também mostra metadados úteis, como a última vez que a consulta foi modificada e quem a modificou, se aplicável.

NOTE
A variável Exibir programação, Adicionar programação e Excluir consulta As opções só estarão disponíveis depois que a consulta for salva como template. A variável Adicionar programação leva você diretamente para o construtor de agendamentos a partir do Editor de consultas. A variável Exibir programação a opção leva você diretamente ao inventário de programação para essa consulta. Consulte a documentação dos cronogramas de consulta para saber como criar agendamentos de consulta na interface.

O Editor de consultas com o painel de detalhes da consulta realçado.

No painel de detalhes, é possível gerar um conjunto de dados de saída diretamente da interface do usuário, excluir ou nomear a consulta exibida, exibir o agendamento de execução da consulta e adicionar a consulta a um agendamento.

Para gerar um conjunto de dados de saída, selecione Executar como CTAS. A variável Inserir detalhes do conjunto de dados de saída será exibida. Insira um nome e uma descrição, depois selecione Executar como CTAS. O novo conjunto de dados é exibido na Conjuntos de dados Guia Procurar. Consulte a documentação exibir conjuntos de dados para saber mais sobre conjuntos de dados disponíveis para sua organização.

NOTE
A variável Executar como CTAS A opção só estará disponível se a consulta tiver não foi programado.

A variável Inserir detalhes do conjunto de dados de saída diálogo.

Depois de executar o Executar como CTAS ação, uma mensagem de confirmação será exibida 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 logs de consulta. Consulte a documentação dos logs de consulta para obter mais informações sobre logs de consulta.

Salvamento de consultas saving-queries

O Editor de consultas fornece uma função salvar que permite salvar uma consulta e trabalhar nela posteriormente. Para salvar uma consulta, selecione Salvar no canto superior direito do Editor de consultas. Para que uma consulta possa ser salva, um nome deve ser fornecido para ela usando o Detalhes da consulta painel.

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

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.

Consultas programadas scheduled-queries

As consultas que foram salvas como um modelo podem ser agendadas no Editor de consultas. O agendamento de consultas permite automatizar as execuções de consultas em uma cadência personalizada. Você pode agendar consultas com base na frequência, data e hora e também escolher um conjunto de dados de saída para seus resultados, se necessário. Os agendamentos de query também podem ser desativados ou excluídos por meio da interface do usuário.

Os cronogramas são definidos no Editor de consultas. Ao usar o Editor de consultas, você só pode adicionar um agendamento a uma consulta que já foi criada e salva. A mesma limitação não se aplica à API do Serviço de consulta.

NOTE
Consultas programadas que falharem em dez execuções consecutivas são colocadas automaticamente em um Em quarentena status. Uma consulta com esse status requer sua intervenção antes que qualquer outra execução possa ocorrer. Consulte a consultas em quarentena para obter mais detalhes.

Consulte a documentação dos cronogramas de consulta para saber como criar agendamentos de consulta na interface. Como alternativa, para saber como adicionar agendas usando a API, leia o guia de endpoint de consultas programadas.

Quaisquer consultas programadas são adicionadas à lista no Consultas programadas guia. Nesse espaço de trabalho, é possível monitorar o status de todos os trabalhos de consulta agendados por meio da interface do usuário. No Consultas programadas você pode encontrar informações importantes sobre as execuções de consulta e assinar alertas. As informações disponíveis incluem status, detalhes da programação e mensagens/códigos de erro se uma execução falhar. Consulte a Monitorar documento de consultas programadas para obter mais informações.

Como encontrar consultas anteriores previous-queries

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

Se um query foi agendado, a variável Consultas programadas fornece visibilidade aprimorada por meio da interface para esses trabalhos de consulta. Consulte a documentação de monitoramento de consultas para obter mais informações.

NOTE
As consultas que não são executadas não são salvas pelo Log. Para que a consulta esteja disponível no Serviço de consulta, ela deve ser executada ou salva no Editor de consultas.

Execução de consultas usando o Editor de consultas executing-queries

Para executar uma consulta no Editor de consultas, você pode inserir SQL no editor ou carregar uma consulta anterior do Log ou Modelos e selecione Reproduzir. O status da execução da consulta é exibido no Console e os dados de saída serão mostrados na guia Resultados guia.

Console console

O console fornece informações sobre o status e a operação do Serviço de consulta. O console exibe o status da conexão com o Serviço de consulta, as operações de consulta que estão sendo executadas e as mensagens de erro resultantes dessas consultas.

A guia Console do console do Editor de consultas.

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

Resultados da consulta query-results

Após a conclusão de um query, os resultados são exibidos no Resultados , ao lado da guia Console guia. Essa exibição mostra a saída tabular do query, exibindo entre 50 e 500 linhas de resultados, dependendo da opção escolhida contagem de resultados. Essa visualização permite verificar se sua consulta 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 a tutorial sobre geração de conjuntos de dados para obter instruções sobre como gerar um conjunto de dados a partir dos resultados da consulta no Editor de consultas.

A guia Resultados do console do Editor de consultas exibindo os resultados de uma execução de consulta.

Casos de uso use-cases

O Serviço de consulta fornece soluções para uma variedade de casos de uso em todos os setores e cenários de negócios. Esses exemplos práticos demonstram a flexibilidade e o impacto do serviço em atender a diversas necessidades. Para descubra como o Serviço de consulta pode agregar valor às suas necessidades de negócios específicas, explore a coleção abrangente de documentos de casos de uso. Saiba como usar o Serviço de consulta para fornecer insights e soluções para melhorar a eficiência operacional e o sucesso dos negócios.

Vídeo tutorial Executar consultas com o Serviço de consulta query-tutorial-video

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

NOTE
A interface do usuário descrita no vídeo está desatualizada, mas a lógica usada no fluxo de trabalho permanece a mesma.

Próximas etapas

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

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