O Adobe Experience Platform Query Service fornece uma interface que pode ser usada para gravar e executar consultas, exibir consultas executadas anteriormente e acessar consultas salvas por usuários em sua organização. Para acessar a interface de usuário no Adobe Experience Platform, selecione Consultas na navegação à esquerda.
Query Editor
O Query Editor permite gravar e executar consultas sem usar um cliente externo. Selecione Criar Consulta para abrir a Query Editor e criar uma nova consulta. Você também pode acessar Query Editor selecionando uma consulta nas guias Log ou Modelos. Selecionar uma consulta executada ou salva anteriormente abrirá o Query Editor e exibirá o SQL para a consulta selecionada.
Query Editor fornece um espaço de edição onde você pode começar a digitar uma consulta. À medida que você digita, o editor preenche automaticamente as palavras reservadas SQL, as tabelas e os nomes de campo dentro das tabelas. Quando terminar de gravar sua consulta, selecione o botão Reproduzir para executar a consulta. A guia Console abaixo do editor mostra o que Query Service está fazendo no momento, indicando quando uma consulta foi retornada. A guia Resultado, ao lado do Console, exibe os resultados da consulta. Consulte o Guia do Editor de Consultas para obter mais informações sobre como usar o Query Editor.
Consultas programadas scheduled-queries
As consultas que já foram salvas como um modelo podem ser agendadas para execução em uma cadência regular. Ao agendar uma consulta, você pode escolher a frequência de execuções, as datas de início e término, o dia da semana em que a consulta agendada é executada, bem como o conjunto de dados para o qual exportar a consulta. Os agendamentos de consulta são definidos com o Editor de consultas.
Depois que uma consulta é agendada, ela aparece na lista de consultas agendadas na guia Consultas agendadas. Detalhes completos sobre a consulta, execuções, criador e horários podem ser encontrados selecionando uma consulta agendada na lista.
Coluna
Descrição
Nome
O campo name é o nome do template ou os primeiros caracteres da query SQL. Qualquer consulta criada por meio da interface do usuário com o Editor de consultas é nomeada no início. Se a consulta foi criada por meio da API, o nome da consulta é um trecho do SQL inicial usado para criar a consulta.
Modelo
O nome do modelo da consulta. Selecione um nome de modelo para navegar até o Editor de consultas. O modelo de consulta é exibido no Editor de consultas para conveniência. Se não houver nome do modelo, a linha será marcada com um hífen e não haverá capacidade de redirecionar para o Editor de consultas para exibir a consulta.
SQL
Um trecho da consulta SQL.
Frequência de execução
Esta é a cadência na qual sua consulta está definida para execução. Os valores disponíveis são Run once e Scheduled. As consultas podem ser filtradas de acordo com a frequência de execução.
Criado por
O nome do usuário que criou a consulta.
Criado
O carimbo de data e hora quando a consulta foi criada, em formato UTC.
Carimbo de data/hora da última execução
O carimbo de data e hora mais recente quando a consulta foi executada. Esta coluna destaca se uma consulta foi executada de acordo com seu agendamento atual.
Status da última execução
O status da execução de consulta mais recente. Os três valores de status são: successfulfailed ou in progress.
A guia Modelos mostra consultas salvas por usuários em sua organização. É útil imaginá-los como projetos de consulta, já que as consultas salvas aqui ainda podem estar em construção. As consultas exibidas na guia Modelos também serão exibidas como consultas de execução na guia Log se tiverem sido executadas anteriormente por Query Service.
Coluna
Descrição
Nome
O campo name é o nome da consulta criada pelo usuário ou os primeiros caracteres da consulta SQL. Qualquer consulta criada por meio da interface do usuário com o Editor de consultas é nomeada no início. Se a consulta foi criada por meio da API, o nome da consulta é um trecho do SQL inicial usado para criar a consulta. Você pode selecionar o nome da consulta para abrir a consulta no Query Editor. Você também pode usar a barra de pesquisa para procurar o Nome de uma consulta. As pesquisas diferenciam maiúsculas de minúsculas.
SQL
Os primeiros caracteres da consulta SQL. Passar o mouse sobre o código exibe a consulta completa.
Modificado por
O último usuário que modificou a consulta. Qualquer usuário em sua organização com acesso ao Query Service pode modificar consultas.
Última modificação
A data e a hora da última modificação no query, no fuso horário do navegador.
Consulte a documentação dos modelos de consulta para obter mais informações sobre modelos na interface do usuário da Platform.
Log log
A guia Log fornece uma lista de consultas que foram executadas anteriormente. Por padrão, o log lista as consultas na cronologia reversa.
Coluna
Descrição
Nome
O nome da consulta, que consiste nos primeiros caracteres da consulta SQL. Selecione o nome do modelo para abrir a exibição Detalhes do log de consulta para essa execução. Você pode usar a barra de pesquisa para pesquisar pelo nome de uma consulta. As pesquisas diferenciam maiúsculas de minúsculas.
Hora de início
A hora em que a consulta foi executada.
Hora de conclusão
A hora em que a execução da consulta foi concluída.
Status
O status atual da consulta.
Conjunto de dados
O conjunto de dados de entrada usado pela consulta. Selecione o conjunto de dados para acessar a tela de detalhes do conjunto de dados de entrada.
Cliente
O cliente usado para a consulta.
Criado por
O nome da pessoa que criou a consulta.
Selecione o ícone de lápis (
) de qualquer linha do log de consultas para navegar até Query Editor. A consulta é pré-preenchida para edição conveniente.
Consulte a documentação dos logs de consulta para obter mais informações sobre os arquivos de log gerados automaticamente por um evento de consulta.
Credenciais
A guia Credenciais exibe suas credenciais com e sem expiração. Para obter mais informações sobre como usar essas credenciais para conexão com clientes externos, leia o guia de credenciais.
Próximas etapas
Agora que você está familiarizado com a interface de usuário do Query Service em Platform, pode acessar o Query Editor para começar a criar seus próprios projetos de consulta para compartilhar com outros usuários em sua organização. Para obter mais informações sobre a criação e execução de consultas em Query Editor, consulte o Query Editor guia do usuário.
