Agendamentos de consulta
Você pode automatizar as execuções de consulta criando programações de consulta. As consultas programadas são executadas em uma cadência personalizada para gerenciar seus dados com base na frequência, data e hora. Você também pode escolher um conjunto de dados de saída para seus resultados, se necessário. As consultas que foram salvas como um modelo podem ser agendadas no Editor de consultas.
Quaisquer consultas agendadas são adicionadas à lista na guia Consultas agendadas. Nesse espaço de trabalho, é possível monitorar o status de todos os trabalhos de consulta agendados por meio da interface do usuário. Na guia Consultas agendadas, você pode encontrar informações importantes sobre a execução de consultas e assinar alertas. As informações disponíveis incluem o status, os detalhes da programação e as mensagens/códigos de erro em caso de falha na execução. Consulte o Documento de monitoramento de consultas agendadas para obter mais informações.
Esse fluxo de trabalho abrange o processo de agendamento na interface do usuário do serviço de consulta. Para saber como adicionar agendamentos usando a API, leia o manual de endpoint de consultas agendadas.
Criar um agendamento de consulta create-schedule
Para agendar uma consulta, selecione um modelo de consulta na guia Modelos ou na coluna Modelo da guia Consultas Agendadas. A seleção do nome do modelo leva você ao Editor de consultas.
Se você acessar uma consulta salva no Editor de consultas, poderá criar uma programação para a consulta ou exibir a programação da consulta no painel de detalhes.
Selecione Adicionar programação para navegar até a página de detalhes da programação.
Como alternativa, selecione a guia Agendamentos abaixo do nome da consulta.
O espaço de trabalho de agendamentos é exibido. A interface do usuário exibe uma lista de todas as execuções agendadas às quais o modelo está associado. Selecione Adicionar Agendamento para criar um agendamento.
Adicionar detalhes da programação schedule-details
A página de detalhes da programação é exibida. Nesta página, você pode editar diversos detalhes da consulta programada. Os detalhes incluem a frequência e o dia da semana da execução da consulta agendada, as datas de início e término, o conjunto de dados para o qual exportar os resultados e alertas de status da consulta.
Frequência de consulta agendada scheduled-query-frequency
Você pode escolher as seguintes opções para Frequência:
- Por hora: a consulta agendada será executada a cada hora para o período de data selecionado.
- Diariamente: a consulta agendada será executada a cada X dias na hora e no período de data selecionados. Observe que a hora selecionada está em UTC, e não em seu fuso horário local.
- Semanalmente: a consulta selecionada será executada nos dias da semana, hora e período de data selecionados. Observe que a hora selecionada está em UTC, e não em seu fuso horário local.
- Mensal: a consulta selecionada será executada mensalmente no dia, hora e período de data selecionados. Observe que a hora selecionada está em UTC, e não em seu fuso horário local.
- Anualmente: a consulta selecionada será executada todos os anos no dia, mês, hora e período de data selecionados. Observe que a hora selecionada está em UTC, e não em seu fuso horário local.
Fornecer detalhes do conjunto de dados dataset-details
Gerencie os resultados da consulta anexando os dados a um conjunto de dados existente ou criando um novo conjunto de dados e anexando os dados a ele.
Selecione Criar e anexar ao novo conjunto de dados para criar um conjunto de dados ao executar uma consulta pela primeira vez. As execuções subsequentes continuam a inserir dados nesse conjunto de dados. Por fim, forneça um nome e uma descrição para o conjunto de dados.
INSERT INTO ou CREATE TABLE AS SELECT como parte da consulta, já que os conjuntos de dados já estão definidos. Incluir INSERT INTO ou CREATE TABLE AS SELECT como parte de suas consultas agendadas resultará em um erro.
Como alternativa, selecione Anexar ao conjunto de dados existente seguido pelo ícone do conjunto de dados (
A caixa de diálogo Selecionar conjunto de dados de saída é exibida.
Em seguida, navegue pelos conjuntos de dados existentes ou use o campo de pesquisa para filtrar as opções. Selecione a linha do conjunto de dados que deseja usar. Os detalhes do conjunto de dados são exibidos no painel à direita. Selecione Concluído para confirmar sua escolha.
Colocar consultas em quarentena se elas falharem continuamente quarantine
Ao criar um agendamento, você pode inscrever seu query no recurso de quarentena para proteger recursos do sistema e evitar possíveis interrupções. O recurso de quarentena identifica e isola automaticamente as consultas que falham repetidamente, colocando-as em um estado Em quarentena. Colocando consultas em quarentena após dez falhas consecutivas, é possível intervir, revisar e corrigir problemas antes de permitir mais execuções. Isso ajuda a manter a eficiência operacional e a integridade dos dados.
Depois que uma consulta é inscrita no recurso de quarentena, você pode assinar alertas para essa alteração de status de consulta. Se uma consulta agendada não estiver inscrita na quarentena, ela não aparecerá como uma opção na caixa de diálogo Alertas.
Você também pode inscrever uma consulta agendada no recurso de quarentena a partir das ações embutidas da guia Consultas agendadas. Consulte a documentação de consultas do monitor para obter mais detalhes.
Definir alertas para um status de consulta agendada alerts-for-query-status
Você também pode assinar alertas de consulta como parte das configurações de consulta programada. Você pode definir suas configurações para receber notificações para uma variedade de situações. Os alertas podem ser definidos para um estado em quarentena, atrasos no processamento da consulta ou uma alteração no status da consulta. As opções de alerta de estado de consulta disponíveis incluem início, sucesso e falha. Os alertas podem ser recebidos como notificações pop-up ou emails. Marque a caixa de seleção para assinar alertas para esse status de consulta agendada.
A tabela abaixo explica os tipos de alerta de consulta aceitos:
startsuccessfailedquarantinedelayPara obter uma visão geral dos alertas no Adobe Experience Platform, incluindo a estrutura de como as regras de alerta são definidas, consulte a visão geral dos alertas. Para obter orientação sobre como gerenciar alertas e regras de alerta na interface do usuário do Adobe Experience Platform, consulte o Guia da interface de alertas.
Definir parâmetros para uma consulta parametrizada programada set-parameters
Se você estiver criando uma consulta programada para uma consulta parametrizada, deverá definir os valores de parâmetro para essas execuções de consulta.
Depois de confirmar os detalhes da agenda, selecione Salvar para criar uma agenda. Você retornará à guia Agendamentos do modelo. Este espaço de trabalho exibe detalhes do agendamento recém-criado, incluindo a ID do agendamento, o próprio agendamento e o conjunto de dados de saída do agendamento.
Exibir execuções de consulta programada scheduled-query-runs
Na guia Agendamentos do modelo, selecione a ID de agendamento para navegar até a lista de execuções de consulta para sua consulta recém-agendada.
Como alternativa, para exibir uma lista de execuções agendadas de um modelo de consulta, navegue até a guia Consultas agendadas e selecione um nome de modelo na lista disponível.
A lista de execuções de consulta para a consulta programada é exibida.
Consulte o guia consultado agendado do monitor para obter informações completas sobre como monitorar o status de todos os trabalhos de consulta por meio da interface.
Selecione uma ID de execução da consulta na lista para navegar até a visão geral de execução da consulta. Para obter um detalhamento completo das informações disponíveis na visão geral da execução da consulta, consulte a documentação do monitoramento de consultas agendadas.
Para monitorar consultas agendadas usando a API de Serviço de Consulta, consulte o guia de pontos de extremidade de execução de consulta agendada.
Ativar, desativar ou excluir um agendamento delete-schedule
Você pode habilitar, desabilitar ou excluir um agendamento do espaço de trabalho de agendamentos de uma determinada consulta ou do espaço de trabalho Consultas Agendadas que lista todas as consultas agendadas.
Para acessar a guia Agendamentos da consulta escolhida, selecione o nome de um modelo de consulta na guia Modelos ou na guia Consultas Agendadas. Isso navega até o Editor de consultas para essa consulta. No Editor de consultas, selecione Agendamentos para acessar o espaço de trabalho de agendamentos.
Selecione um agendamento nas linhas de agendamentos disponíveis para preencher o painel de detalhes. Use o botão para desativar (ou ativar) a consulta programada.
Excluir consultas desabilitadas
Uma caixa de diálogo de confirmação é exibida. Selecione Desabilitar para confirmar a ação.
Selecione Excluir um agendamento para excluir o agendamento desabilitado.
Como alternativa, a guia Consultas agendadas oferece uma coleção de ações em linha para cada consulta agendada. As ações embutidas disponíveis incluem Desabilitar agendamento ou Habilitar agendamento, Excluir agendamento e Assinar para alertas da consulta agendada. Para obter instruções completas sobre como excluir ou desabilitar uma consulta agendada por meio da guia Consultas agendadas, consulte o guia de consulta agendada do monitor.