Monitorar consultas programadas

O Adobe Experience Platform oferece maior visibilidade do status de todos os trabalhos de consulta por meio da interface. No Consultas programadas Agora é possível encontrar informações importantes sobre as execuções de consulta, que incluem status, detalhes da programação e mensagens/códigos de erro caso falhem. Também é possível assinar alertas para consultas com base em seu status por meio da interface do para qualquer uma dessas consultas por meio do Consultas programadas guia.

Consultas programadas

A variável Consultas programadas A guia fornece uma visão geral de todas as consultas de CTAS e ITAS programadas. Os detalhes da execução podem ser encontrados para todas as consultas programadas, bem como códigos de erro e mensagens para quaisquer consultas com falha.

Para navegar até o Consultas programadas selecione Consultas na barra de navegação esquerda, seguida por Consultas programadas

A guia Consultas agendadas no espaço de trabalho Consultas com Consultas agendadas e Consultas destacadas.

A tabela abaixo descreve cada coluna disponível.

NOTE
O ícone de assinaturas de alerta está contido em cada linha de uma coluna sem título. Consulte a assinaturas de alerta para obter mais informações.
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, seu nome se torna um trecho do SQL inicial usado para criar a consulta. Para ver uma lista de todas as execuções associadas à consulta, selecione um item na lista Nome coluna. Para obter mais informações, consulte detalhes da programação de execuções de consulta seção.
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
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 valores de status são: Success, Failed, In progress, e No runs.
Status do Calendário

O status atual da consulta agendada. Há cinco valores em potencial, Registrando, Ativo, Inativo, Excluídoe um hífen.

  • O hífen indica que a consulta agendada é uma consulta única e não recorrente.
  • A variável Registrando status indica que o sistema ainda está processando a criação do novo agendamento para a consulta. Observe que você não pode desativar ou excluir uma consulta programada enquanto ela estiver se registrando.
  • A variável Ativo status indica que a consulta programada foi ainda não passado data e hora de conclusão.
  • A variável Inativo status indica que a consulta programada foi aprovado data e hora de conclusão.
  • A variável Excluído status indica que a programação de consulta foi excluída.
TIP
Se você navegar até o Editor de consultas, poderá selecionar Consultas para retornar ao Modelos guia.

Personalizar configurações de tabela para consultas programadas customize-table

É possível ajustar as colunas nas Consultas programadas para atender às suas necessidades. Para abrir o Personalizar tabela caixa de diálogo de configurações e editar colunas disponíveis, selecione o ícone de configurações ( Um ícone de configurações. ) na parte superior direita da tela.

NOTE
A variável Criado em A coluna que se refere à data em que o agendamento foi criado fica oculta por padrão.

A guia Consultas agendadas com o ícone Personalizar configurações de tabela está realçada.

Alterne as caixas de seleção relevantes para remover ou adicionar uma coluna da tabela. Em seguida, selecione Aplicar para confirmar suas escolhas.

NOTE
Qualquer consulta criada por meio da interface do usuário se torna um modelo nomeado como parte do processo de criação. O nome do template é visto na coluna template. Se a query foi criada por meio da API, a coluna de modelo está em branco.

O diálogo Personalizar configurações da tabela.

Gerenciar consultas programadas com ações integradas inline-actions

A variável Consultas programadas view oferece várias ações em linha para gerenciar todas as consultas programadas de um único local. As ações em linha são indicadas em cada linha com reticências. Selecione as reticências de uma consulta agendada que você deseja gerenciar para ver as opções disponíveis em um menu pop-up. As opções disponíveis incluem Desativar programação ou Ativar programação, Excluir programação, e Assinar para consultar alertas.

A guia Consultas agendadas com as reticências da ação em linha e o menu pop-up realçado.

Desativar ou ativar uma consulta programada disable

Para desativar uma consulta programada, selecione as reticências de uma consulta programada que deseja gerenciar e selecione Desativar programação nas opções do menu pop-up. Uma caixa de diálogo é exibida para confirmar a ação. Selecionar Desativar para confirmar suas configurações.

Quando uma consulta programada é desativada, você pode ativar a programação por meio do mesmo processo. Selecione as reticências e selecione Ativar programação nas opções disponíveis.

Excluir uma consulta agendada delete

Para excluir uma consulta agendada, selecione as reticências de uma consulta agendada que deseja gerenciar e selecione Excluir programação nas opções do menu pop-up. Uma caixa de diálogo é exibida para confirmar a ação. Selecionar Excluir para confirmar suas configurações.

Depois que uma consulta programada é excluída, ela é não removida da lista de consultas agendadas. As ações em linha fornecidas pelas reticências são removidas e substituídas pelo ícone de adição de alerta esmaecido. Não é possível assinar alertas para o agendamento excluído. A linha permanece na interface do usuário para fornecer informações sobre execuções realizadas como parte da consulta programada.

A guia Consultas agendadas com uma consulta agendada excluída e o ícone de alerta esmaecido está realçado.

Se quiser programar execuções para esse modelo de consulta, selecione o nome do modelo na linha apropriada para navegar até o Editor de consultas e, em seguida, siga as instruções para adicionar um agendamento a uma consulta conforme descrito na documentação.

Assinatura de alertas alert-subscription

Para assinar alertas para execuções de consultas agendadas, selecione as reticências de uma consulta agendada que deseja gerenciar e selecione Assinar nas opções do menu pop-up.

A variável Alertas será aberta. A variável Alertas A caixa de diálogo inscreve você em notificações da interface do usuário e alertas de email. Os alertas são baseados no status da consulta. Há três opções disponíveis: start, success, e failure. Marque as caixas apropriadas e selecione Salvar para se inscrever. Você pode assinar alertas, desde que eles não tenham uma Carimbo de data/hora da última execução valor.

A caixa de diálogo de assinaturas do alerta.

Consulte a documentação da API de assinaturas de alerta para obter mais informações.

Exibir os detalhes da consulta query-details

Selecione o ícone de informações ( Um ícone de informações. ) para ver o painel de detalhes da consulta. O painel de detalhes contém todas as informações relevantes sobre a consulta além dos fatos incluídos na tabela de consultas programadas. As informações adicionais incluem a ID da consulta, a data da última modificação, o SQL da consulta, a ID da programação e a programação definida atual.

A guia Consultas agendadas com o ícone de informações e o painel de detalhes destacados.

Filtrar consultas filter

Você pode filtrar consultas com base na frequência de execução. No Consultas programadas , selecione o ícone de filtro ( Um ícone de filtro ) para abrir a barra lateral do filtro.

A guia Scheduled queries com o ícone de filtro realçado.

Para filtrar a lista de consultas com base em sua frequência de execução, selecione Agendado ou Executar uma vez filtrar caixas de seleção.

NOTE
Qualquer consulta executada, mas não agendada, é qualificada como Executar uma vez.

A guia Scheduled queries com a barra lateral de filtro realçada.

Após ativar os critérios de filtro, selecione Ocultar filtros para fechar o painel de filtro.

Detalhes do agendamento de execuções de consulta query-runs

Para abrir a página de detalhes da programação, selecione um nome de consulta na Consultas programadas guia. Essa visualização fornece uma lista de todas as execuções executadas como parte dessa consulta programada. As informações fornecidas incluem a hora de início e término, o status e o conjunto de dados usado.

A página de detalhes da programação.

Essas informações são fornecidas em uma tabela de cinco colunas. Cada linha denota uma execução de consulta.

Nome da coluna
Descrição
ID de execução da consulta
A ID de execução da consulta para a execução diária. Selecione o ID de execução da consulta para navegar até o Visão geral da execução da consulta.
Início da execução da consulta
O carimbo de data e hora quando a consulta foi executada. O carimbo de data/hora está no formato UTC.
Execução de consulta concluída
O carimbo de data e hora quando a consulta foi concluída. O carimbo de data/hora está no formato UTC.
Status
O status da execução de consulta mais recente. Os três valores de status são: successful failed ou in progress.
Conjunto de dados
O conjunto de dados envolvido na execução.

Detalhes da consulta que está sendo agendada podem ser vistos na Propriedades painel. Esse painel inclui a ID de consulta inicial, o tipo de cliente, o nome do modelo, o SQL de consulta e a cadência do agendamento.

A página de detalhes da programação com o painel de propriedades realçado.

Selecione uma ID de execução de consulta para navegar até a página de detalhes da execução e exibir informações da consulta.

A tela de detalhes da programação com uma ID de execução realçada.

Visão geral da execução da consulta query-run-overview

A variável Visão geral da execução da consulta fornece informações sobre execuções individuais para esta consulta programada e um detalhamento mais detalhado do status de execução. Esta página também inclui as informações do cliente e detalhes de quaisquer erros que possam ter causado a falha da consulta.

A tela de detalhes da execução com a seção de visão geral destacada.

A seção status da consulta fornece o código de erro e a mensagem de erro caso a consulta tenha falhado.

A tela de detalhes da execução com a seção de erros realçada.

Você pode copiar o SQL da consulta para a área de transferência nessa visualização. Para copiar a query, selecione o ícone copiar na parte superior direita do trecho SQL. Uma mensagem pop-up confirma que o código foi copiado.

A tela de detalhes da execução com o ícone de cópia SQL realçado.

Executar detalhes de consultas com bloqueio anônimo anonymous-block-queries

As consultas que usam blocos anônimos para compreender suas instruções SQL são separadas em suas subconsultas individuais. A separação em subconsultas permite inspecionar os detalhes da execução de cada bloco de consulta individualmente.

NOTE
Os detalhes de execução de um bloco anônimo que usa o comando DROP não ser relatada como uma subconsulta separada. Detalhes de execução separados estão disponíveis para consultas CTAS, consultas ITAS e instruções COPY usadas como subconsultas de bloco anônimas. Os detalhes de execução do comando DROP não são suportados no momento.

Blocos anônimos são indicados pelo uso de um $$ prefixo antes da consulta. Para saber mais sobre blocos anônimos no serviço de query, consulte documento de bloqueio anônimo.

As subconsultas de blocos anônimos têm guias à esquerda do status de execução. Selecione uma guia para exibir os detalhes da execução.

A visão geral da execução da consulta que exibe uma consulta de bloco anônimo. As várias guias de query são realçadas.

Se um query de bloco anônimo falhar, você poderá encontrar o código de erro para esse bloco específico por meio dessa interface.

A visão geral da execução da consulta exibindo uma consulta de bloco anônimo com o código de erro de um único bloco realçado.

Selecionar Query para retornar à tela de detalhes da programação ou Consultas programadas para retornar ao Consultas programadas guia.

A tela de detalhes da execução com Consulta realçada.

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