Query Service Guia da interface do usuário

A Adobe Experience Platform Query Service O fornece uma interface de usuário que pode ser usada para gravar e executar consultas, exibir consultas executadas anteriormente e acessar consultas salvas pelos usuários em sua Organização IMS. Para acessar a interface do usuário no Adobe Experience Platform, selecione Queries no painel de navegação esquerdo.

Query Editor

O Query Editor permite gravar e executar consultas sem usar um cliente externo. Selecionar Criar Consulta para abrir o Query Editor e criar uma nova query. Você também pode acessar a variável Query Editor selecionando um query no Log ou Modelos guias. A seleção de uma consulta executada ou salva anteriormente abrirá o Query Editor e exibir o SQL para a query selecionada.

O painel Consultas com a opção Criar consulta foi realçado.

Query Editor O fornece espaço de edição, onde você pode começar a digitar uma consulta. À medida que você digita, o editor conclui automaticamente palavras, tabelas e nomes de campos reservados do SQL nas tabelas. Quando terminar de gravar seu query, selecione a variável Reproduzir para executar o query. O Console guia abaixo do editor mostra o que Query Service O está fazendo no momento, indicando quando um query foi retornado. O Resultado , ao lado do Console, exibe os resultados da consulta. Consulte a Guia do Editor de consultas para obter mais informações sobre como usar o Query Editor.

Um zoom na exibição da variável Query Editor.

Consultas agendadas

Consultas que já foram salvas como um modelo podem ser agendadas para execução em uma cadência regular. Ao agendar um query, você pode escolher a frequência de execuções, a data de início e de término, o dia da semana em que o query agendada é executado, bem como o conjunto de dados para o qual exportar o query. As programações de query são definidas por meio do Editor de consultas.

Para saber como agendar um query por meio da interface do usuário, consulte o guia de consultas agendadas. Para saber como adicionar agendamentos usando a API, leia o guia do endpoint de consultas agendadas.

Depois que um query é agendado, ele aparece na lista de consultas agendadas na Consultas agendadas guia . Detalhes completos sobre a consulta, as execuções, o criador e os tempos podem ser encontrados ao selecionar uma consulta agendada na lista.

O espaço de trabalho Queries com a guia Consultas agendadas foi realçado e exibiu linhas de agendamentos de consulta.

Coluna	Descrição
Nome	O campo de nome é o nome do modelo ou os primeiros caracteres da consulta SQL. Qualquer query 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 um nome de modelo, a linha será marcada com um hífen e não será possível redirecionar para o Editor de consultas para exibir a consulta.
SQL	Um trecho da consulta SQL.
Executar frequência	Essa é a cadência na qual seu query está definido para ser executado. Os valores disponíveis são `Run once` e `Scheduled`. As consultas podem ser filtradas de acordo com sua frequência de execução.
Criado por	O nome do usuário que criou o query.
Criado	O carimbo de data e hora quando a consulta foi criada, no formato UTC.
Carimbo de data e hora da última execução	O carimbo de data e hora mais recente quando a consulta foi executada. Essa coluna destaca se uma consulta foi executada de acordo com seu agendamento atual.
Status da última execução	O status da execução mais recente da consulta. Os três valores de status são: `successful` `failed` ou `in progress`.

Consulte a documentação para obter mais informações sobre como monitorar consultas por meio da interface do usuário do serviço de query.

Modelos

O Modelos mostra queries salvas pelos usuários em sua organização. É útil considerar esses projetos como projetos de query, já que as consultas salvas aqui podem ainda estar em construção. Queries exibidos no Modelos A guia também é exibida como consultas de execução no Log se tiverem sido executados anteriormente por Query Service.

Uma visualização ampliada da guia Modelos do painel de Consultas exibindo várias consultas salvas.

Coluna	Descrição
Nome	O campo name é o nome da consulta criado pelo usuário ou os primeiros caracteres da consulta SQL. Qualquer query 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 abri-la no Query Editor. Também é possível usar a barra de pesquisa para pesquisar a variável Nome de um query. 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 query. Qualquer usuário da organização com acesso a Query Service O pode modificar queries.
Última modificação	A data e a hora da última modificação do query, no fuso horário do navegador.

Log

O Log A guia fornece uma lista de consultas que foram executadas anteriormente. Por padrão, o log lista os queries na cronologia inversa.

Uma visualização ampliada da guia Log do painel de Consultas exibindo uma lista de consultas em ordem cronológica inversa.

Coluna	Descrição
Nome	O nome da consulta, que consiste nos primeiros caracteres da consulta SQL. Selecionar o nome abre a janela Query Editor, permitindo editar o query. Você pode usar a barra de pesquisa para pesquisar o Nome de um query. As pesquisas diferenciam maiúsculas de minúsculas.
Criado por	O nome da pessoa que criou o query.
Cliente	O cliente usado para o query.
Conjunto de dados	O conjunto de dados de entrada usado pelo query. Selecione o conjunto de dados a ser acessado na tela de detalhes do conjunto de dados de entrada.
Status	O status atual da query.
Última execução	Quando a consulta foi executada por último. Você pode classificar a lista em ordem crescente ou decrescente selecionando a seta sobre essa coluna.
Tempo de execução	O tempo necessário para executar o query.

Credenciais

O Credenciais exibe suas credenciais que expiram e não expiram. Para obter mais informações sobre como usar essas credenciais para se conectar a clientes externos, leia o guia de credenciais.

O painel Queries com a guia Credenciais foi realçado.

Próximas etapas

Agora que você está familiarizado com Query Service interface do usuário em Platform, você pode acessar Query Editor para começar a criar seus próprios projetos de query para compartilhar com outros usuários em sua organização. Para obter mais informações sobre criação e execução de consultas em Query Editor, consulte o Query Editor guia do usuário.