Pianificare gli aggiornamenti dei dati nei fogli Google

Questa pagina descrive come pianificare gli aggiornamenti automatici dei dati nel connettore Databricks per Fogli Google per mantenere aggiornati i dati importati. Gli aggiornamenti pianificati eseguono le query salvate su base ricorrente e aggiornano i fogli corrispondenti.

Requisiti

• Hai configurato il Databricks Connector per Fogli Google e importato i dati da Azure Databricks.

Creare una connessione al catalogo Unity

Gli aggiornamenti pianificati richiedono quanto segue:

• Una connessione Unity Catalog chiamata databricks_google_connection, creata da un amministratore di metastore in Fogli Google.
• Privilegio USE CONNECTION per la connessione, concesso agli utenti che devono creare o gestire gli aggiornamenti pianificati.

1. Come amministratore del metastore di Azure Databricks, in Fogli Google apri la barra laterale del connettore Databricks per Fogli Google.
2. Fare clic sulla scheda Importazioni salvate .
3. Fare clic sul calendario in alto a destra.
4. Fare clic su Configura connessione.

Condivide una connessione in Azure Databricks

Dopo aver creato la connessione, concedere il USE CONNECTION privilegio agli utenti che devono creare o gestire gli aggiornamenti pianificati. Un amministratore del metastore o qualsiasi utente con il privilegio MANAGE sulla connessione può concedere questo privilegio. Per ulteriori informazioni sulla gestione delle connessioni, consultare Gestire le connessioni per Federazione Lakehouse.

Creare una pianificazione

Ogni importazione può essere assegnata a una sola pianificazione. Per creare una nuova pianificazione per un'importazione esistente:

1. Nella barra laterale del connettore Azure Databricks in Fogli Google fare clic sulla scheda Importazioni salvate.

2. Fare clic sull'icona del calendario e fare clic su Nuova pianificazione.

3. Selezionare l'importazione per cui creare una pianificazione.

4. Immettere un nome per la pianificazione.

5. Selezionare la frequenza della pianificazione:

   • Per Hourly selezionare il minuto dell'ora per eseguire l'aggiornamento.
   • Per Giornaliero selezionare l'ora del giorno per eseguire l'aggiornamento.
   • Per Settimanale selezionare il giorno della settimana e l'ora di esecuzione dell'aggiornamento.

   La pianificazione usa il fuso orario locale.

6. Selezionare il SQL Warehouse da usare per le query programmate.

7. Fare clic su Crea pianificazione.

Visualizzare la cronologia di esecuzione e i dettagli della pianificazione

Per visualizzare la cronologia di esecuzione di tutti gli aggiornamenti pianificati, eseguire le operazioni seguenti:

1. Nella barra laterale del connettore Azure Databricks in Fogli Google fare clic sulla scheda Importazioni salvate.
2. Fare clic sull'icona del calendario e fare clic su Visualizza cronologia di esecuzione.
3. Fare clic su un'esecuzione specifica per visualizzare i dettagli della pianificazione.

Per visualizzare la cronologia di esecuzione e i dettagli di configurazione di un aggiornamento pianificato, eseguire le operazioni seguenti:

1. Nel riquadro Visualizza cronologia di esecuzione selezionare il nome della pianificazione da visualizzare. In Esecuzioni recenti viene visualizzato lo stato di ogni esecuzione.

2. Passare il puntatore del mouse su un'icona di stato per visualizzare l'ID di esecuzione, l'ora di inizio e lo stato esecuzione di un'esecuzione.

   

3. Fare clic su Visualizza configurazione per visualizzare i dettagli della pianificazione, che includono la configurazione di importazione e pianificazione selezionata.

   • Se si visualizza una pianificazione creata da un altro utente, l'ora visualizzata è l'ora nel fuso orario locale dell'autore.

Eliminare un aggiornamento pianificato

Per eliminare gli aggiornamenti pianificati, eseguire le operazioni seguenti:

1. Nella barra laterale del connettore Azure Databricks in Fogli Google fare clic sulla scheda Importazioni salvate.
2. Fare clic sull'icona del calendario e fare clic su Gestisci pianificazioni.
3. Selezionare la pianificazione da eliminare.
4. Fare clic su Visualizza configurazione, quindi su Elimina.

Troubleshooting

Se si verificano problemi con gli aggiornamenti pianificati, eliminate la pianificazione in Fogli Google e le connessioni Unity Catalog corrispondenti in Azure Databricks, quindi ricreate la pianificazione. Per ulteriori informazioni sulle connessioni di Unity Catalog, consulta Gestire le connessioni per Lakehouse Federation.

Limitazioni

• Non è possibile modificare un aggiornamento pianificato. È possibile visualizzare o eliminare solo pianificazioni esistenti. Per modificare una pianificazione, eliminarla e crearne una nuova.
• Se si modifica una query usata da una pianificazione, la pianificazione non preleva automaticamente le modifiche. Per applicare il testo aggiornato della query, eliminare la pianificazione e ricrearla.
• Non è possibile pianificare un aggiornamento delle tabelle pivot. L'API Google aggiorna solo i dati di query non elaborati e non può modificare la configurazione pivot se lo schema dei risultati della query cambia.
• Una singola pianificazione può includere un massimo di 20 importazioni.
• Il testo della query per le importazioni usate in un aggiornamento pianificato ha un limite di 4.096 caratteri.