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.
Requisitos de conta para consultas agendadas technical-account-user-requirements
Para ajudar na execução confiável das consultas agendadas, a Adobe recomenda que os administradores provisionem uma conta técnica (usando as credenciais de servidor para servidor do OAuth) para criar consultas agendadas. As consultas programadas também podem ser criadas com uma conta de usuário pessoal, mas as consultas criadas dessa maneira deixarão de ser executadas se o acesso desse usuário for removido ou desativado.
Para obter detalhes sobre como configurar contas técnicas e atribuir as permissões necessárias, consulte os pré-requisitos do guia de credenciais e a autenticação de API.
Para obter orientação adicional sobre como criar e configurar uma conta técnica, consulte:
- Configuração do Developer Console: instruções passo a passo para configurar o Adobe Developer Console e obter credenciais do OAuth.
- Configuração completa de conta técnica: uma apresentação detalhada para criar e configurar uma conta técnica no Adobe Experience Platform.
Se você usar apenas a interface do Serviço de consulta, verifique se tem as permissões necessárias ou coordene com um administrador que gerencia contas técnicas. Quaisquer consultas agendadas são adicionadas à lista na guia Consultas agendadas, onde você pode monitorar o status, os detalhes do agendamento e as mensagens de erro de todos os trabalhos de consultas agendadas, bem como assinar alertas. Para obter mais informações sobre o monitoramento e o gerenciamento de consultas, consulte o documento de consultas agendadas do monitor.
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, consulte 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. Use esta página para definir as configurações de agendamento para a consulta agendada. 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.
31.12.9999.
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 agendada para uma consulta parametrizada, defina agora 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.
Computar horas no nível do trabalho compute-hours
Rastreie as horas de cálculo consumidas no nível de execução da consulta para as consultas em lote CTAS/ITAS. Esse recurso oferece informações sobre o uso do computador, ajudando você a otimizar a alocação de recursos e a melhorar o desempenho da consulta.
A tabela a seguir fornece descrições de cada coluna disponível na seção de detalhes que lista execuções de consulta programadas.
Completed, Running, ou Failed, para avaliar o resultado rapidamente.Consulte o guia de monitoramento de consultas agendadas 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.
Editar um agendamento edit-schedule
Você pode acessar o editor de agendamento no espaço de trabalho Consultas Agendadas, na página de detalhes do agendamento ou no Editor de Consultas. Você pode modificar as definições de configuração compatíveis com uma consulta agendada existente sem recriar o agendamento. A edição de um agendamento atualiza apenas a configuração do agendamento. Ele não modifica a definição de consulta SQL subjacente.
Acessar o workflow de edição access-edit-workflow
Use um dos seguintes caminhos da guia Consultas agendadas para acessar o fluxo de trabalho de edição de uma consulta agendada qualificada.
Selecione as reticências (…) para o agendamento que você deseja modificar, em seguida Editar agendamento no menu de ações embutidas. Isso abre o editor de agendamento diretamente. Consulte Gerenciar consultas agendadas com ações embutidas para obter mais informações.
Ou selecione um nome de agendamento na tabela para abrir a página de detalhes do agendamento. Na página de detalhes do agendamento, selecione Editar agendamento no canto superior direito da página para abrir o editor de agendamento.
Você também pode editar uma programação qualificada existente no Editor de consultas.
- Abra um modelo de consulta no Editor de Consultas e selecione Exibir agendamento.
- Selecione a ID de agendamento na lista para abrir a página de detalhes do agendamento.
- Selecione Editar agendamento.
Editar configurações de programação edit-schedule-settings
Use o editor de agendamento para revisar a configuração de agendamento atual e atualizar as configurações compatíveis.
As seguintes configurações podem ser modificadas:
Salvar alterações na programação save-schedule-changes
Depois de atualizar as configurações de agendamento, selecione Salvar para aplicar as alterações. Uma mensagem de confirmação é exibida quando o agendamento é atualizado com êxito.
Verificar informações atualizadas da programação verify-schedule-updates
Depois de salvar, verifique se a configuração de programação atualizada aparece nos seguintes locais:
- A guia Consultas agendadas.
- O painel Propriedades na página de detalhes da programação.
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.