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 programadas são adicionadas à lista no Consultas programadas guia. Nesse espaço de trabalho, é possível monitorar o status de todos os trabalhos de consulta agendados por meio da interface do usuário. No Consultas programadas guia, você pode encontrar informações importantes sobre as execuções de consulta 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 a Monitorar documento de consultas programadas 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 agendas usando a API, leia o guia de endpoint de consultas programadas.
Criar um agendamento de consulta create-schedule
Para agendar uma consulta, selecione um modelo de consulta no Modelos ou na guia Modelo coluna da Consultas programadas guia. 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.
Selecionar Adicionar programação para navegar até o página de detalhes da programação.
Como alternativa, selecione o Agendamentos abaixo do nome do query.
O espaço de trabalho de agendamentos é exibido. Selecionar Adicionar programação para criar um agendamento.
Editar os detalhes da programação schedule-details
A página de detalhes da programação é exibida. Nesta página, você pode escolher a frequência da consulta programada, as datas de início e término, o dia da semana em que a consulta programada será executada, bem como para qual conjunto de dados exportar a consulta.
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 o horário selecionado está em UTC, e não o fuso horário local.
- Semanalmente: A consulta selecionada será executada nos dias da semana, hora e período de data selecionados. Observe que o horário selecionado está em UTC, e não o fuso horário local.
- Mensal: A consulta selecionada será executada mensalmente no dia, hora e período de data selecionados. Observe que o horário selecionado está em UTC, e não o fuso horário local.
- Anual: A consulta selecionada será executada todos os anos no dia, mês, hora e período de data selecionados. Observe que o horário selecionado está em UTC, e não o fuso horário local.
Para o conjunto de dados de saída, você tem a opção de usar a opção de anexar em um conjunto de dados existente ou criar e anexar em um novo conjunto de dados. A segunda opção significa que, se você executar um query pela primeira vez e criar um conjunto de dados, qualquer execução subsequente continuará inserindo dados nesse conjunto de dados.
INSERT INTO ou CREATE TABLE AS SELECT como parte da query, já que os conjuntos de dados já estão definidos. Incluindo INSERT INTO ou CREATE TABLE AS SELECT como parte das consultas programadas resultará em um erro.Se você não tiver acesso a consultas parametrizadas, continue na excluir ou desativar um agendamento seção.
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.
Após confirmar todos esses detalhes, selecione Salvar para criar um agendamento. Você retorna ao espaço de trabalho de agendamentos que 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. Você pode usar a ID de agendamento para pesquisar mais informações sobre as execuções da própria consulta agendada. Para saber mais, leia o guia de endpoints de execução de consulta agendada.
Exibir execuções de consulta programada scheduled-query-runs
Para exibir uma lista de execuções programadas de um modelo de consulta, navegue até a Consultas programadas e selecione um nome de template na lista disponível.
A lista de execuções de consulta para a consulta programada é exibida.
Consulte a 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.
Excluir ou desabilitar um agendamento delete-schedule
Você pode excluir ou desativar um agendamento no espaço de trabalho de agendamentos de uma consulta específica ou no Consultas programadas espaço de trabalho que lista todas as consultas programadas.
Para acessar o Agendamentos da consulta escolhida, você deve selecionar o nome de um modelo de consulta no campo Modelos ou na guia Consultas programadas guia. 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. Você pode usar o botão para desativar ou ativar a consulta programada.
Selecionar Excluir um agendamento para excluir a programação desativada.
Em alternativa, a Consultas programadas A guia oferece uma coleção de ações integradas para cada consulta programada. As ações em linha disponíveis incluem Desativar programação ou Ativar programação, Excluir programação, e Assinar para alertas para a consulta agendada. Para obter instruções completas sobre como excluir ou desativar uma consulta agendada por meio da guia Consultas agendadas, consulte a guia consultado agendado do monitor.