Condividi tramite


Sviluppare ed eseguire il debug di pipeline di tabelle live Delta nei notebook

Importante

L'esperienza notebook per lo sviluppo di tabelle live Delta è disponibile in anteprima pubblica.

Questo articolo descrive le funzionalità nei notebook di Azure Databricks che supportano lo sviluppo e il debug del codice delta live tables.

Panoramica delle funzionalità

Quando si lavora in un notebook Python o SQL che rappresenta il codice sorgente per una pipeline di tabelle live Delta esistenti, è possibile connettere il notebook direttamente alla pipeline. Quando il notebook è connesso alla pipeline, sono disponibili le funzionalità seguenti:

  • Avviare e convalidare la pipeline dal notebook.
  • Visualizzare il grafico del flusso di dati e il registro eventi della pipeline per l'aggiornamento più recente nel notebook.
  • Visualizzare la diagnostica della pipeline nell'editor di notebook.
  • Visualizzare lo stato del cluster della pipeline nel notebook.
  • Accedere all'interfaccia utente di Tabelle live Delta dal notebook.

Prerequisiti

  • È necessario disporre di una pipeline delta live tables esistente con un notebook Python o SQL come codice sorgente.
  • È necessario essere il proprietario della pipeline o avere il CAN_MANAGE privilegio .

Limiti

  • Le funzionalità descritte in questo articolo sono disponibili solo nei notebook di Azure Databricks. I file dell'area di lavoro non sono supportati.
  • Il terminale Web non è disponibile quando è collegato a una pipeline. Di conseguenza, non è visibile come scheda nel pannello inferiore.

Connettere un notebook a una pipeline di tabelle live Delta

All'interno del notebook fare clic sul menu a discesa usato per selezionare calcolo. Il menu a discesa mostra tutte le pipeline di tabelle live Delta con questo notebook come codice sorgente. Per connettere il notebook a una pipeline, selezionarlo dall'elenco.

Visualizzare lo stato del cluster della pipeline

Per comprendere facilmente lo stato del cluster della pipeline, il relativo stato viene visualizzato nel menu a discesa di calcolo con un colore verde per indicare che il cluster è in esecuzione.

Convalidare il codice della pipeline

È possibile convalidare la pipeline per verificare la presenza di errori di sintassi nel codice sorgente senza elaborare dati.

Per convalidare una pipeline, eseguire una delle operazioni seguenti:

  • Nell'angolo superiore destro del notebook fare clic su Convalida.
  • Premere Shift+Enter in qualsiasi cella del notebook.
  • Nel menu a discesa di una cella fare clic su Convalida pipeline.

Nota

Se si tenta di convalidare la pipeline mentre è già in esecuzione un aggiornamento esistente, viene visualizzata una finestra di dialogo che chiede se si vuole terminare l'aggiornamento esistente. Se si fa clic su , l'aggiornamento esistente viene arrestato e viene avviato automaticamente un aggiornamento convalidato .

Avviare la pipeline

Un aggiornamento della pipeline esegue le operazioni seguenti: avvia un cluster, individua e convalida tutte le tabelle e le viste definite e crea o aggiorna tabelle e viste con i dati più recenti disponibili.

Per avviare un aggiornamento della pipeline, fare clic sul pulsante Start nell'angolo in alto a destra del notebook.

Visualizzare lo stato di un aggiornamento

Il pannello superiore del notebook visualizza se un aggiornamento della pipeline è:

  • Avvio
  • Convalida in corso.
  • Arresto in corso

Visualizzare errori e diagnostica

Dopo l'avvio o la convalida di una pipeline, eventuali errori vengono visualizzati inline con una sottolineatura rossa. Passare il puntatore del mouse su un errore per visualizzare altre informazioni.

Visualizzare gli eventi della pipeline

Quando è collegata a una pipeline, nella parte inferiore del notebook è presente una scheda del registro eventi di Tabelle live Delta.

Log eventi

Visualizzare il grafico del flusso di dati della pipeline

Per visualizzare il grafico del flusso di dati di una pipeline, usare la scheda grafo Tabelle live Delta nella parte inferiore del notebook. Se si seleziona un nodo nel grafico, lo schema viene visualizzato nel pannello destro.

Grafico del flusso di dati

Come accedere all'interfaccia utente di Tabelle live Delta dal notebook

Per passare facilmente all'interfaccia utente delle tabelle live Delta, usare il menu nell'angolo in alto a destra del notebook.

Aprire nell'interfaccia utente DLT dal notebook

Accedere ai log dei driver e all'interfaccia utente di Spark dal notebook

È possibile accedere facilmente ai log dei driver e all'interfaccia utente spark associata alla pipeline in fase di sviluppo dal menu Visualizza del notebook.

Accedere ai log dei driver e all'interfaccia utente di Spark