Aggiorna l'attività degli endpoint di analisi SQL

L'attività di aggiornamento degli endpoint di analisi SQL nelle pipeline Microsoft Fabric ti permette di aggiornare programmaticamente un endpoint di analisi SQL di Lakehouse come parte di un flusso di lavoro orchestrato. È parte integrante della Lakehouse Utility Suite per le pipeline e di solito viene usato dopo l'attività di manutenzione Lakehouse, ad esempio dopo le operazioni OPTIMIZE o VACUUM. I consumatori downstream—come ad esempio i report, i quaderni o i client SQL esterni—vedono i dati più recenti una volta completata la procedura di preparazione o manutenzione dei dati.

Usa questa attività per far sì che gli endpoint di analisi SQL riflettano immediatamente gli aggiornamenti recenti senza dover fare affidamento su aggiornamenti manuali o processi ad hoc. Utilizza questa attività quando la pipeline:

  • Aggiorna o mantiene i dati di Lakehouse, ad esempio dopo l'esecuzione di processi di copia, esecuzione di notebook o manutenzione di Lakehouse.
  • Richiede che l'endpoint di analisi SQL di Lakehouse rifletta gli ultimi cambiamenti ai metadati e ai dati.
  • Richiede tempi di aggiornamento deterministici prima dei passaggi downstream, ad esempio la creazione di report, l'analisi o le esportazioni.

Prerequisiti

Prima di usare questa attività, assicurarsi che:

Aggiungi un'attività di aggiornamento dell'endpoint SQL Analytics alla tua pipeline nell'interfaccia utente

  1. Creare una nuova pipeline nell'area di lavoro.

  2. Cerca Refresh SQL analytics endpoint nel pannello Attività della pipeline e selezionalo per aggiungerlo all'area di disegno della pipeline.

    Schermata dell'attività di aggiornamento dell'endpoint di analisi SQL nel riquadro Attività.

  3. Seleziona la nuova attività Aggiorna endpoint di analisi SQL sulla tela, se non è già selezionata.

    Screenshot dell'attività di aggiornamento dell'endpoint SQL Analytics nell'area di disegno della pipeline.

    Suggerimento

    È possibile orchestrare questa attività insieme ad altre attività di Lakehouse Utility Suite, ad esempio l'attività Di manutenzione Lakehouse, nella stessa pipeline, in modo che la manutenzione e l'aggiornamento vengano eseguite in sequenza.

  4. Fare riferimento alle indicazioni generali sulle impostazioni per configurare la scheda Impostazioni generali .

Aggiorna le impostazioni di attività dell'endpoint di analisi SQL

  1. Selezionare la scheda Impostazioni per configurare l'attività.  

  2. Configurare la connessione selezionando una connessione esistente dall'elenco a discesa Connessione o creando una nuova connessione e specificandone i dettagli di configurazione.

  3. Specificare l'area di lavoro che contiene il Lakehouse.

  4. Specifica l'endpoint di analisi SQL come ID dell'endpoint di analisi SQL per il Lakehouse che si desidera aggiornare. Il refresh aggiorna i metadati dell'endpoint di analisi SQL di Lakehouse in modo che riflettano i cambiamenti recenti di dati e schema.

    Schermata delle impostazioni dell'attività di aggiornamento dell'endpoint di analisi SQL, in cui si specifica l'endpoint di analisi SQL.

Comportamento dell'attività

Al termine dell'esecuzione dell'attività:

  • Se il popup Output mostra lo stato Operazione riuscita, la richiesta sincronizza correttamente i dati non sincronizzati.

    Screenshot di uno stato di successo nel popup di Output dell'attività.

  • Uno stato NotRun nel pop-up Output significa che l'aggiornamento dell'endpoint SQL Analytics non è stato eseguito. Questa condizione significa in genere che non sono stati aggiunti nuovi dati dall'ultima sincronizzazione, quindi non è necessario eseguirlo.

    Screenshot di uno stato NotRun nel popup output dell'attività.

  • Se il popup Output mostra lo stato Errore , si è verificato un problema.

Annotazioni

L'esecuzione dell'attività imposta questi stati nel popup Output. Non confondere questi stati con lo stato dell'attività stessa.

Scenari comuni

  • Aggiornare l'endpoint di analisi SQL dopo che un Notebook scrive dati trasformati su un Lakehouse.
  • Attiva un aggiornamento dell'endpoint SQL analytics dopo il completamento dell'attività di Manutenzione Lakehouse (OPTIMIZE o VACUUM).
  • Garantire che report e dashboard interogno lo stato più recente di Lakehouse in punti ben definiti di una pipeline.

Perché l'aggiornamento dell'endpoint SQL Analytics fallisce quando i dati sottostanti sono bloccati?

L'attività di aggiornamento dell'endpoint SQL analytics può fallire intermittentemente quando altri processi aggiornano attivamente i dati sottostanti di Lakehouse. Questi processi includono pipeline di inserimento, notebook o operazioni di scrittura simultanee.

Questo fallimento avviene perché l'endpoint SQL Analytics deve acquisire lock interni per completare l'aggiornamento. Se un'altra operazione blocca i dati, la richiesta raggiunge il timeout o restituisce un errore.

Questo comportamento è prevedibile in base a come gli endpoint di analisi SQL gestiscono le operazioni di aggiornamento dei metadati.

Symptoms

  • L'attività non riesce in modo intermittente, non coerente.
  • I messaggi di errore indicano conflitti di aggiornamento o conflitti di blocco.
  • Le pipeline con attività di aggiornamento sequenziale multiplo degli endpoint per analisi SQL mostrano tassi di guasto più elevati.

Causa principale

Gli endpoint di analisi SQL richiedono accesso esclusivo a determinate strutture di metadati durante l'aggiornamento. Se un altro processo di calcolo scrive contemporaneamente nel Lakehouse, si verifica una contesa di blocco.

Questo comportamento non è un difetto nell'attività di aggiornamento degli endpoint SQL analytics. È il risultato naturale delle operazioni di lettura e scrittura simultanee sui dati sottostanti.

Soluzioni alternative

Due approcci pratici possono attenuare questo problema:

Usa una sola attività dell'endpoint Refresh SQL Analytics al termine dell'elaborazione

Per ridurre la probabilità di conflitti di blocco, consolidare la pipeline in modo che:

  • Tutte le attività di inserimento, trasformazione e aggiornamento vengono eseguite per prime,
  • Quindi, al termine viene eseguita una sola attività di aggiornamento dell'endpoint SQL analytics.
  • Questo approccio non elimina completamente gli errori, ma riduce notevolmente la frequenza con cui si verificano.

Implementa un programma di aggiornamento ricorrente

Se lo scenario non richiede una coerenza transazionale rigorosa in un momento specifico, adottare un modello di aggiornamento ricorrente:

  • Pianificare un aggiornamento ogni 15 minuti, in modo continuo. Alcuni tentativi di refresh potrebbero fallire a causa del blocco, ma abbastanza riusciranno da mantenere il tuo endpoint SQL Analytics relativamente aggiornato.

Schermata della configurazione della pianificazione di aggiornamento ricorrente di un endpoint di analisi SQL.

Questo approccio è pratico e affidabile per molti carichi di lavoro di analisi.

Salvare e eseguire la pipeline oppure pianificarla

Passare alla scheda Home nella parte superiore dell'editor della pipeline e selezionare il pulsante Salva per salvare la pipeline. Selezionare Esegui per eseguirla direttamente o Pianifica per pianificare le esecuzioni a intervalli o ore specifici. Per altre informazioni sulle esecuzioni della pipeline, vedere Pianificare le esecuzioni della pipeline.

Screenshot che mostra la scheda Home nell'editor della pipeline con il nome della scheda e i pulsanti Salva, Esegui e Pianifica evidenziati.

Dopo l'esecuzione, è possibile monitorare l'esecuzione della pipeline e visualizzare la cronologia di esecuzione dalla scheda Output sotto l'area di disegno.

Problemi noti

Contenuti correlati

  • Last updated on