Agendar a atualização automática de dados no Azure Databricks Excel Add-in

Importante

Este recurso está no Public Preview.

Note

O suplemento Azure Databricks Excel não está disponível nas regiões Azure Government ou Azure China.

A atualização agendada mantém os dados importados para um livro de trabalho Excel atualizados, executando a importação automaticamente num calendário. Pode criar um cronograma para uma consulta guardada, tabela ou importação de tabela dinâmica guardada, escolher o SQL warehouse que executa cada atualização e rever as execuções recentes do Azure Databricks Excel Add-in.

Para saber como a atualização programada se liga ao Microsoft 365 e quais as funcionalidades de segurança de rede que se aplicam, consulte Arquitetura e segurança do Add-in do Azure Databricks para Excel.

Prerequisites

Antes de criar uma atualização agendada, certifique-se de que:

As atualizações agendadas são executadas com a identidade do Azure Databricks e as credenciais Microsoft da pessoa que cria o agendamento. Mantenha essas credenciais ativas para que o Azure Databricks possa consultar os dados e atualizar o livro de exercícios.

Permissões da Microsoft

O seu ficheiro adicional Excel deve incluir o seguinte domínio na AppDomains secção. Se instalou o complemento Excel antes da atualização agendada, adicione o domínio ao seu ficheiro adicional ou descarregue novamente o ficheiro. Veja Configurar o Adicionamento Azure Databricks para Excel.

<AppDomain>https://login.microsoftonline.com</AppDomain>

O complemento solicita as seguintes permissões da Microsoft, às quais deve consentir para uma atualização programada para aceder e atualizar o livro de exercícios:

  • Files.ReadWrite: Leia e atualize o seu caderno de exercícios.
  • offline_access: Mantenha as atualizações agendadas a correr quando não estiver ativamente iniciado em sessão.

Criar uma agenda

Crie uma atualização agendada para qualquer importação de consulta, tabela ou tabela crozeante guardada a partir do Azure Databricks Excel Add-in.

  1. Abre o Azure Databricks Excel Add-in.
  2. Acede a Importações guardadas.
  3. Encontre a importação que pretende atualizar automaticamente.
  4. Selecione o botão de calendário ao lado da importação.
  5. Consulte os Detalhes do Ativo para confirmar que selecionou a consulta, tabela ou tabela dinâmica correta.
  6. No separador Gerenciar Agenda , introduza um nome descritivo do Calendário.
  7. Escolha um tipo de agendamento. Consulte Intervalo e Agendamento:
    • Intervalo: Atualização a cada número especificado de minutos, horas, dias ou semanas.
    • Agendamento: Escolha uma frequência e uma hora com base no calendário, como todos os dias a uma hora específica ou todas as semanas num dia específico.
  8. Se selecionou Agendamento, confirme o fuso horário. O fuso horário inicial baseia-se nas definições locais do browser.
  9. Em SQL Warehouse, selecione o warehouse que executa a consulta.
  10. Selecione Criar Agenda.

Depois de criada a programação, o botão do calendário da importação guardada muda para um ícone de calendário com um relógio.

Uma importação guardada que mostra o ícone de calendário com relógio, que indica uma atualização agendada, incluindo a localização da importação e a hora da última atualização.

Intervalo

Utilize Intervalo quando a atualização se deve repetir em intervalos regulares. Introduza um número e selecione minutos, horas, dias, ou semanas.

Os intervalos disponíveis são:

  • 1 a 120 minutos
  • 1 a 72 horas
  • de 1 a 31 dias
  • de 1 a 8 semanas

Para uma atualização que deve ser executada num dia da semana e hora específicos, use Schedule em vez de um intervalo semanal.

O separador Gerir Horário com o tipo de Horário Intervalado selecionado, mostrando o campo Todos, o seletor SQL Warehouse e o botão Criar Agenda.

Schedule

Use o Agendar quando a atualização tiver de ser executada a uma hora específica do calendário. Dependendo da cadência, pode selecionar:

  • A frequência, como minuto, hora, dia, semana ou mês
  • A hora do dia
  • O dia da semana para horários semanais
  • O dia do mês para os horários mensais
  • O fuso horário

Os horários são avaliados no fuso horário selecionado. Os carimbos temporais do histórico de execução são exibidos usando a localização do espetador.

O separador Gerir agendamento com o tipo de agendamento selecionado, mostrando os seletores de cadência, hora e fuso horário.

Atualizar um calendário existente

Muda o nome, cadência, fuso horário ou SQL warehouse de um horário que já criaste.

  1. Em Importações guardadas, selecione o botão calendário com relógio para a importação.
  2. No separador Gerir agendamentos, altere o nome do agendamento, da cadência, do fuso horário ou do SQL warehouse.
  3. Selecione Agendar atualizações.

A atualização da importação guardada subjacente também sincroniza a respetiva consulta, os parâmetros, os filtros e o limite de linhas com a atualização agendada. A próxima execução utiliza a definição de importação atualizada.

Ver histórico de execuções

Verifique o resultado das recentes corridas de atualização para uma importação agendada, incluindo o estado de cada run, duração e quaisquer detalhes de falha.

  1. Abre o calendário da importação guardada.
  2. Selecione o separador Histórico de Corridas .
  3. Reveja as execuções recentes. Cada entrada mostra o seu tempo de conclusão, estado e duração.
  4. Expanda uma execução para ver mais detalhes, incluindo uma mensagem de erro quando uma atualização falha.

Os estados das execuções incluem:

  • OK: A atualização foi concluída com sucesso.
  • A correr: A atualização ainda está em curso.
  • Falhado: A atualização não foi concluída. Expanda a execução para ver os detalhes de falha disponíveis.

Se o calendário ainda não tiver sido executado, o separador mostra Ainda não existe histórico de corridas.

Eliminar uma importação agendada

A atualização agendada não disponibiliza uma opção separada para pausar um agendamento ou eliminar apenas o agendamento.

Para parar o agendamento do complemento Excel, apague a importação guardada:

  1. Em Importações guardadas, abra o menu de ações da importação.
  2. Selecione Eliminar.

Eliminar a importação guardada também apaga o trabalho de atualização agendado associado e remove a configuração de importação guardada do livro de trabalho.

Troubleshooting

Se uma atualização agendada não for executada ou se o livro de exercícios não for atualizado, utilize as seguintes secções para identificar e resolver as causas mais comuns.

As suas credenciais Microsoft expiraram

A atualização agendada requer acesso ao livro por intermédio da sua conta Microsoft. Se o Add-in mostrar a seguinte mensagem, as suas credenciais expiraram:

As suas credenciais Microsoft expiraram. Inicie sessão para manter as atualizações agendadas a funcionar.

Selecione login Microsoft e complete o fluxo de iniciação de sessão. Um agendamento pode continuar a aparecer como configurado enquanto as credenciais estiverem expiradas, mas as execuções de atualização não conseguem atualizar o livro até o acesso ser restaurado.

Falha numa atualização agendada

Se uma execução mostrar um estado Failed, faça as seguintes verificações para identificar a causa:

  1. Abra o agendamento e selecione Histórico de execuções.
  2. Expanda a execução com falha e reveja a sua mensagem de erro.
  3. Confirma que a tua conta Microsoft ainda está ligada.
  4. Confirme que o livro de exercícios ainda existe no OneDrive ou SharePoint e que a sua conta pode editá-lo.
  5. Confirme que o armazém de dados SQL selecionado está disponível e que pode executar a consulta de origem.
  6. Confirma que ainda tens acesso à tabela de origem e a outros dados referenciados.
  7. Se a importação usar referências a células do Excel para parâmetros ou filtros, confirme que a folha e as células a que se faz referência ainda existem.

O livro de exercícios não está a ser atualizado

Se as execuções reportarem sucesso mas os dados do livro estiverem obsoletos, confirme que o livro ainda está na localização esperada e acessível:

  1. Abra o livro na respetiva localização no OneDrive ou no SharePoint.
  2. Confirme que o livro não foi movido, renomeado ou substituído desde a última atualização do cronograma.
  3. Religue a sua conta Microsoft se lhe for solicitado.
  4. Consulte o histórico de execuções para ver o estado mais recente e os detalhes do erro.
  • Última atualização a