Programma l'aggiornamento automatico dei dati nell'Azure Databricks Excel Add-in

Il refresh programmato mantiene aggiornati i dati importati in un workbook Excel eseguendo automaticamente l'importazione su un programma. Puoi creare un programma per un'importazione salvata di query, tabella o tabelle crostatali, scegliere il SQL warehouse che esegue ogni aggiornamento e rivedere le esecuzioni recenti dall'Azure Databricks Excel Add-in.

Prerequisites

Prima di creare un aggiornamento programmato, assicurati che:

• Il workbook viene salvato in Microsoft OneDrive o SharePoint.
• La query, la tabella o la tabella pivot è già importata e compare sotto Importazioni salvate. Vedi Importa e interroga dati usando l'aggiuntivo Azure Databricks Excel.
• Hai il permesso di usare il SQL warehouse che esegue l'aggiornamento.
• Il tuo account Microsoft è collegato all'Azure Databricks Excel Add-in. Vedere Impostare il componente aggiuntivo Azure Databricks Excel.

Gli aggiornamenti programmati vengono eseguiti con l'identità di Azure Databricks e le credenziali Microsoft della persona che crea l'orario. Mantieni queste credenziali attive così Azure Databricks può interrogare i dati e aggiornare il workbook.

Permessi Microsoft

Il file del componente aggiuntivo di Excel deve includere il seguente dominio nella sezione AppDomains. Se hai installato l'add-in Excel prima che venisse rilasciato il refresh programmato, aggiungi il dominio al file add-in o scarica di nuovo il file. Vedere Impostare il componente aggiuntivo Azure Databricks Excel.

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

L'Add-in richiede le seguenti autorizzazioni Microsoft, alle quali è necessario acconsentire affinché l'aggiornamento pianificato possa accedere alla cartella di lavoro e aggiornarla:

• Files.ReadWrite: Leggi e aggiorna il tuo quaderno.
• offline_access: Mantieni in esecuzione gli aggiornamenti pianificati quando non sei connesso attivamente.

Creare una pianificazione

Crea un aggiornamento programmato per qualsiasi query, tabellone o importazione di tabelle pivot salvata dall'Azure Databricks Excel Add-in.

1. Apri il componente aggiuntivo di Excel per Azure Databricks.
2. Vai su Importazioni salvate.
3. Trova automaticamente l'importazione che vuoi aggiornare.
4. Seleziona il pulsante calendario accanto all'importazione.
5. Esamina i dettagli dell'asset per confermare di aver selezionato la query, la tabella o la tabella pivot corretta.
6. Nella scheda Gestione Programma , inserisci un nome descrittivo dell'Schedule.
7. Scegli un tipo di pianificazione. Vedi intervallo e programma:
   • Intervallo: Aggiorna ogni numero specificato di minuti, ore, giorni o settimane.
   • Programma: Scegli una cadenza e un orario basati sul calendario, ad esempio ogni giorno a un momento specifico o ogni settimana in un giorno specifico.
8. Se hai selezionato Programma, conferma il fuso orario. Il fuso orario iniziale si basa sulle impostazioni del browser locale.
9. In SQL Warehouse, seleziona il warehouse che esegue la query.
10. Seleziona Crea programma.

Dopo aver creato la pianificazione, il pulsante calendario per l'importazione salvata diventa un'icona del calendario con un orologio.

Intervallo

Usa Interval quando l'aggiornamento deve ripetersi a intervalli regolari. Inserisci un numero e seleziona minuti, ore, giorni o settimane.

Gli intervalli disponibili sono:

• 1 a 120 minuti
• Da 1 a 72 ore
• Da 1 a 31 giorni
• Da 1 a 8 settimane

Per un refresh che deve evolversi in un giorno e orario specifici, usa Schedule invece di un intervallo settimanale.

Pianificazione

Usa Pianifica quando l'aggiornamento deve essere eseguito a una data e ora specifiche. A seconda della cadenza, puoi selezionare:

• La frequenza, ad esempio minuto, ora, giorno, settimana o mese
• Ora del giorno
• Il giorno della settimana per gli orari settimanali
• Il giorno del mese per gli orari mensili
• Il fuso orario

Gli orari vengono valutati nel fuso orario selezionato. I timestamp della cronologia di run sono visualizzati utilizzando la posizione dello spettatore.

Aggiorna una pianificazione esistente

Cambia nome, cadenza, fuso orario o SQL warehouse di un programma che hai già creato.

1. Da Importazioni salvate, seleziona il pulsante calendario con orologio per l'importazione.
2. Nella scheda Gestisci il programma, cambia il nome del programma, la cadenza, il fuso orario o il magazzino SQL.
3. Seleziona Pianificazione aggiornamenti.

L'aggiornamento dell'importazione salvata sottostante sincronizza anche la sua query, i parametri, i filtri e il limite di righe con l'aggiornamento programmato. L'esecuzione successiva utilizza la definizione di importazione aggiornata.

Revisione della cronologia delle partite

Controlla l'esito delle recenti esecuzioni di aggiornamento per un'importazione pianificata, tra cui lo stato di ciascuna, la durata ed eventuali dettagli sugli errori.

1. Apri la pianificazione dell'importazione salvata.
2. Seleziona la scheda Cronologia esecuzioni.
3. Rivedi le ultime partite. Ogni voce mostra il suo tempo, stato e durata di completamento.
4. Espandi un'esecuzione per visualizzare più dettagli, compresi un messaggio di errore quando un aggiornamento non riesce.

Gli stati delle corse includono:

• OK: L'aggiornamento è stato completato con successo.
• Running: Il refresh è ancora in corso.
• Non riuscito: L'aggiornamento non è stato completato. Espandi la run per visualizzare i dettagli disponibili sui guasti.

Se il programma non è ancora stato eseguito, la scheda mostra nessuna cronologia delle esecuzioni.

Elimina un'importazione programmata

L'aggiornamento programmato non offre un'opzione separata per mettere in pausa una pianificazione o eliminare solo la pianificazione.

Per interrompere la pianificazione dal componente aggiuntivo di Excel, elimina l'importazione salvata:

1. Nelle importazioni salvate, apri il menu azioni per l'importazione.
2. Seleziona Elimina.

L'eliminazione dell'importazione salvata elimina anche l'attività di aggiornamento pianificata associata e rimuove dalla cartella di lavoro la configurazione dell'importazione salvata.

Troubleshooting

Se un aggiornamento pianificato non viene eseguito o la cartella di lavoro non viene aggiornata, utilizza le sezioni seguenti per identificare e risolvere le cause più comuni.

Le tue credenziali Microsoft sono scadute

Il refresh programmato richiede l'accesso al workbook tramite il tuo account account Microsoft. Se l'Add-in mostra il seguente messaggio, le tue credenziali sono scadute:

Le tue credenziali Microsoft sono scadute. Accedi per continuare a eseguire i refresh programmati.

Seleziona accesso Microsoft e completa la procedura di accesso. Un programma può comunque apparire configurato mentre le credenziali sono scadute, ma le esecuzioni di aggiornamento non possono aggiornare il workbook finché l'accesso non viene ripristinato.

Un aggiornamento pianificato non riesce

Se un’esecuzione mostra lo stato Non riuscito, esegui i seguenti controlli per individuarne la causa:

1. Apri il calendario e seleziona Cronologia delle corse.
2. Espandi la run fallita e rivedi il messaggio di errore.
3. Verifica che il tuo account Microsoft sia ancora connesso.
4. Conferma che il workbook esista ancora su OneDrive o SharePoint e che il tuo account possa modificarlo.
5. Conferma che il SQL warehouse selezionato sia disponibile e che tu possa eseguire la query sorgente.
6. Conferma di avere ancora accesso alla tabella sorgente e ad altri dati di riferimento.
7. Se l'importazione utilizza riferimenti a celle Excel per parametri o filtri, verifica che il foglio di lavoro e le celle a cui si fa riferimento esistano ancora.

Il quaderno non viene aggiornato

Se le esecuzioni risultano completate correttamente ma i dati della cartella di lavoro non sono aggiornati, confermi che la cartella di lavoro si trovi ancora nel percorso previsto e sia accessibile:

1. Apri la cartella di lavoro dalla sua posizione su OneDrive o SharePoint.
2. Conferma che la cartella di lavoro non sia stata spostata, rinominata o sostituita dall'ultima volta che la pianificazione è stata aggiornata.
3. Ricollega il tuo account Microsoft se ti viene richiesto.
4. Consulta la cronologia delle run per lo stato più recente e i dettagli sugli errori.