Pular para o conteúdo principal
Última atualização em

Programar o refresh automático de dados no suplemento do Databricks para Excel

info

Visualização

Esse recurso está em Prévia Pública.

O refresh agendado mantém os dados importados para uma pasta de trabalho do Excel atualizados executando a importação automaticamente de acordo com programar. Você pode programar uma query salva, tabela ou importação de tabela dinâmica, escolher o SQL Warehouse que executa cada refresh e revisar execuções recentes a partir do suplemento do Databricks para Excel.

Prerequisites​

Antes de criar um refresh agendado, certifique-se de que:

Os refresh programados são execução com a identidade do Databricks e as credenciais da Microsoft da pessoa que cria a programar. Mantenha essas credenciais ativas para que o Databricks possa fazer a query dos dados e atualizar a pasta de trabalho.

permissões da Microsoft​

O arquivo do seu suplemento do Excel deve incluir o seguinte domínio na seção AppDomains. Se você instalou o suplemento do Excel antes do lançamento do refresh programado, adicione o domínio ao arquivo do seu suplemento ou faça o download do arquivo novamente. Consulte Configurar o suplemento do Databricks para Excel.

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

The Add-in requests the following Microsoft permissions, which you must consent to for scheduled refresh to access and update the workbook:

  • Files.ReadWrite: leia e atualize sua pasta de trabalho.
  • offline_access: Keep scheduled refresh running when you are not actively signed in.

Criar um programar​

Crie um refresh agendado para qualquer query salva, tabela ou importação de tabela dinâmica a partir do suplemento do Databricks para Excel.

  1. Abra o suplemento do Databricks para Excel.

  2. Vá para Importações salvas .

  3. Encontre a importação que você deseja refresh automaticamente.

  4. Selecione o botão de calendário ao lado da importação.

  5. Review Ativo Details to confirm that you selected the correct query, table, or pivot table.

  6. No tab gerenciar schedule , insira um Schedule name descritivo.

  7. Escolha um Tipo de agendamento . Consulte Intervalo e programar:

    • Interval : Refresh every specified number of minutes, hours, days, or weeks.
    • programar : escolha uma cadência e um horário baseados no calendário, como todos os dias em um horário específico ou toda semana em um dia específico.

  8. Se você selecionou programar , confirme o Time zone . O fuso horário inicial é baseado nas configurações do seu navegador local.

  9. Em SQL warehouse , selecione o warehouse que faz a execução da query.

  10. Selecione Create programar .

Após a criação do programar, o botão de calendário da importação salva muda para um ícone de calendário com relógio.

Uma importação salva mostrando o ícone de calendário com relógio que indica um refresh agendado, com seu local de importação e horário do último refresh.

Intervalo​

Use Interval quando o refresh deva se repetir após um período regular. Insira um número e selecione minutes , hours , days ou weeks .

Os intervalos disponíveis são:

  • 1 to 120 minutes
  • 1 a 72 horas
  • 1 a 31 dias
  • 1 a 8 semanas

Para um refresh que deve ser executado em um dia da semana e horário específicos, use programar em vez de um intervalo semanal.

A tab gerenciar programar com o tipo de programar Interval selecionado, mostrando o campo Every, o seletor de SQL Warehouse e o botão Create programar.

programar​

Use programar when the refresh must execução at a specific calendar time. Depending on the cadence, you can select:

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

Os horários são avaliados no fuso horário do programar selecionado. Os Timestamp do histórico de execução são exibidos usando a localidade do leitor.

A tab Gerenciar programar com o tipo de programar programar selecionado, mostrando a cadência, a hora e os seletores de fuso horário.

Atualizar um programar existente​

Altere o nome, a cadência, o fuso horário ou o SQL warehouse de um programar que você já criou.

  1. Em Saved imports , selecione o botão de calendário com relógio para a importação.
  2. On the Gerenciar programar tab, change the programar name, cadence, time zone, or SQL Warehouse.
  3. Selecione Update programar .

A atualização da importação salva subjacente também sincroniza sua query, parâmetros, filtros e limite de linhas com o refresh agendado. A próxima execução usa a definição de importação atualizada.

Revisar a história de execução​

Verifique o resultado de execuções de refresh recentes para uma importação agendada, incluindo o status de cada execução, duração e quaisquer detalhes de falha.

  1. Abra a programar da importação salva.
  2. Selecione a tab história de execução .
  3. Review the recent execuções. Each entry shows its completion time, status, and duração.
  4. Expanda uma execução para ver mais detalhes, incluindo uma mensagem de erro quando um refresh falhar.

Execução statuses include:

  • OK : o refresh foi concluído com sucesso.
  • Running : o refresh ainda está em andamento.
  • Failed : o refresh não foi concluído. Expanda a execução para view os detalhes de falha disponíveis.

Se a programação ainda não tiver sido executada, a tab exibirá No execução história yet .

Excluir uma importação agendada​

O refresh agendado não fornece uma opção separada para pausar um agendamento ou excluir apenas o agendamento.

To stop the programar from the Excel Add-in, delete the saved import:

  1. Em Importações salvas , abra o menu de ações para a importação.
  2. Selecione Delete .

A exclusão da importação salva também exclui o job de refresh agendado associado e remove a configuração de importação salva do workbook.

Solução de problemas​

Se um refresh programado não for execução ou a pasta de trabalho não for refresh, use as seções a seguir para identificar e resolver as causas mais comuns.

As suas credenciais da Microsoft expiraram​

Scheduled refresh needs access to the workbook through your Microsoft account. If the Add-in displays the following message, your credentials have expired:

As suas credenciais da Microsoft expiraram. Faça login para manter os refresh agendados em execução.

Selecione Microsoft login e conclua o fluxo de login. Um programar ainda pode parecer configurado enquanto as credenciais estiverem expiradas, mas as execuções de refresh não podem atualizar o workbook até que o acesso seja restaurado.

A scheduled refresh fails​

Se uma execução mostrar o status Failed , realize as seguintes verificações para identificar a causa:

  1. Abra o programa e selecione execução história .
  2. Expanda a execução com falha e analise sua mensagem de erro.
  3. Confirme se sua Microsoft account ainda está conectada.
  4. Confirm that the workbook still exists in OneDrive or SharePoint and that your account can edit it.
  5. Confirme que o SQL warehouse selecionado está disponível e que você pode executar a execução da query de origem.
  6. Confirme se você ainda tem acesso à tabela de origem e a outros dados referenciados.
  7. If the import uses Excel cell references for parameters or filters, confirm that the referenced worksheet and cells still exist.

O workbook não está sendo atualizado​

Se as execuções relatarem sucesso, mas os dados do workbook estiverem desatualizados, confirme se o workbook ainda está no local esperado e acessível:

  1. Abra a pasta de trabalho a partir do seu local no OneDrive ou SharePoint.
  2. Confirme se a pasta de trabalho não foi movida, renomeada ou substituída desde a última atualização do programar.
  3. Reconecte sua account da Microsoft se solicitado.
  4. Revise a história de execução para ver o status mais recente e os detalhes do erro.
Nesta página