Monitorar consultas programadas
O Adobe Experience Platform oferece maior visibilidade do status de todos os trabalhos de consulta por meio da interface. Na guia Consultas agendadas, você pode encontrar informações importantes sobre as execuções de consulta, que incluem status, detalhes do agendamento e mensagens/códigos de erro caso haja falha. Também é possível assinar alertas para consultas com base em seu status na interface de qualquer uma dessas consultas por meio da guia Consultas agendadas.
Consultas agendadas
A guia Consultas agendadas fornece uma visão geral de todas as suas consultas CTAS e ITAS agendadas. 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é a guia Consultas agendadas, selecione Consultas na barra de navegação esquerda, seguido de Consultas agendadas
A tabela abaixo descreve cada coluna disponível.
Run once e Scheduled.Success, Failed, In progress e No runs.O status atual da consulta agendada. Há seis valores possíveis, Registrando, Ativo, Inativo, Excluído, um hífen e Em quarentena.
- O status Registrando 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.
- O status Ativo indica que a consulta agendada ainda não passou de sua data e hora de conclusão.
- O status Inativo indica que a consulta agendada ultrapassou sua data e hora de conclusão ou foi marcada por um usuário para estar em um estado inativo.
- O status Excluído indica que o agendamento da consulta foi excluído.
- O hífen indica que a consulta agendada é uma consulta única e não recorrente.
- O status Em quarentena indica que a consulta falhou em dez execuções consecutivas e requer sua intervenção antes que outras execuções possam ocorrer.
Personalizar configurações de tabela para consultas programadas customize-table
Você pode ajustar as colunas na guia Consultas agendadas de acordo com suas necessidades. Para abrir a caixa de diálogo de configurações Personalizar tabela e editar as colunas disponíveis, selecione o ícone de configurações (
Alterne as caixas de seleção relevantes para remover ou adicionar uma coluna da tabela. Em seguida, selecione Aplicar para confirmar suas escolhas.
Gerenciar consultas programadas com ações integradas inline-actions
A exibição Consultas agendadas oferece várias ações embutidas para gerenciar todas as consultas agendadas 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 Desabilitar agendamento ou Habilitar agendamento, Excluir agendamento, Assinar para consultar alertas e Habilitar ou Desabilitar quarentena.
Desativar ou ativar uma consulta programada disable
Para desabilitar uma consulta agendada, selecione as reticências da consulta agendada que deseja gerenciar e selecione Desabilitar agendamento nas opções do menu pop-up. Uma caixa de diálogo é exibida para confirmar a ação. Selecione Desabilitar para confirmar sua configuração.
Quando uma consulta programada é desativada, você pode ativar a programação por meio do mesmo processo. Selecione as reticências e Habilitar agendamento nas opções disponíveis.
Excluir uma consulta agendada delete
Para excluir uma consulta agendada, selecione as reticências da consulta agendada que deseja gerenciar e selecione Excluir agendamento nas opções do menu pop-up. Uma caixa de diálogo é exibida para confirmar a ação. Selecione Excluir para confirmar sua configuração.
Depois que uma consulta agendada é 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 assinatura 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.
Se você deseja agendar execuções para esse modelo de consulta, selecione o nome do modelo na linha apropriada para navegar até o Editor de Consultas, 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 o ícone de assinatura de alerta ... (reticências) ou (
A caixa de diálogo Alertas é aberta. A caixa de diálogo Alertas inscreve você nas notificações da interface do usuário e nos alertas de email. Há várias opções de assinatura de alerta disponíveis: start, success, failure, quarantine e delay. Marque as caixas apropriadas e selecione Salvar para assinar.
A tabela abaixo explica os tipos de alerta de consulta aceitos:
startsuccessfailedquarantinedelayConsulte 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 (
Consultas em quarentena quarantined-queries
Quando inscrita no recurso de quarentena, qualquer consulta agendada que falhar dez execuções consecutivas é automaticamente colocada em um status Em quarentena. Uma consulta com esse status fica inativa e não é executada na sua cadência programada. Em seguida, ele requer sua intervenção antes que qualquer outra execução possa ocorrer. Isso protege os recursos do sistema, pois você deve revisar e corrigir os problemas com seu SQL antes que ocorram mais execuções.
Para habilitar uma consulta agendada para o recurso de quarentena, selecione as reticências (...) seguidas por Habilitar quarentena no menu suspenso exibido.
As consultas também podem ser inscritas no recurso de quarentena durante o processo de criação do agendamento. Consulte a documentação de agendamentos de consulta para obter mais informações.
Atraso na execução da consulta query-run-delay
Mantenha o controle das horas computacionais definindo alertas para atrasos de consulta. Você poderá monitorar o desempenho da consulta e receber notificações se o status de uma consulta permanecer inalterado após um período específico. Use o alerta 'Atraso na Execução da Consulta' para ser notificado se uma consulta continuar a ser processada após um período específico sem conclusão.
Quando você assina alertas para execuções de consultas agendadas, um dos alertas disponíveis é o Atraso na Execução da Consulta. Esse alerta exige que você defina um limite para o tempo gasto na execução, momento em que você será notificado sobre o atraso no processamento.
Para escolher uma duração de limite que aciona a notificação, insira um número no campo de entrada de texto ou use as setas para cima e para baixo para aumentar em incrementos de um minuto. Como o limite é definido em minutos, a duração máxima para observar um atraso de execução de consulta é de 1440 minutos (24 horas). O período padrão para um atraso de execução é de 150 minutos.
Consulte a seção assinar alertas para saber como assinar alertas de Atraso na Execução da Consulta.
Filtrar consultas filter
Você pode filtrar consultas com base na frequência de execução. Na guia Consultas agendadas, selecione o ícone de filtro (
Para filtrar a lista de consultas com base em sua frequência de execução, marque as caixas de seleção de filtro Agendado ou Executar uma vez.
Depois de habilitar 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 do agendamento, selecione um nome de consulta na guia Consultas agendadas. 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.
Essas informações são fornecidas em uma tabela de cinco colunas. Cada linha denota uma execução de consulta.
Success, Failed, In progress ou Quarantined.Detalhes da consulta que está sendo agendada podem ser vistos no painel Propriedades. 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.
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.
Visão geral da execução da consulta query-run-overview
A Visão geral da execução da consulta fornece informações sobre execuções individuais para esta consulta agendada 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 seção status da consulta fornece o código de erro e a mensagem de erro caso a consulta tenha falhado.
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.
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.
Blocos anônimos são indicados por meio do uso de um prefixo $$ antes da consulta. Para saber mais sobre blocos anônimos no serviço de consulta, consulte o documento de blocos anônimos.
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.
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.
Selecione Consulta para retornar à tela de detalhes da programação, ou Consultas Agendadas para retornar à guia Consultas Agendadas.
