Condividi tramite


Esercitazione: Usare un notebook con Apache Spark per eseguire query su un database KQL

I notebook sono sia documenti leggibili contenenti descrizioni e risultati dell'analisi dei dati che documenti eseguibili per effettuare l'analisi dei dati. Questo articolo illustra come usare un notebook di Microsoft Fabric per leggere e scrivere dati in un database KQL usando Apache Spark. In questa esercitazione vengono usati set di dati e notebook creati in precedenza sia nell’Intelligence in tempo reale che negli ambienti di ingegneria dei dati in Microsoft Fabric. Per altre informazioni sui notebook, vedere Come usare i notebook di Microsoft Fabric.

In particolare, si apprenderà come:

  • Creare un database KQL
  • Importare un notebook
  • Scrivere dati in un database KQL usando Apache Spark
  • Eseguire query sui dati da un database KQL

Prerequisiti

1- Creare un database KQL

  1. Aprire il commutatore esperienza nella parte inferiore del riquadro di spostamento e selezionare Intelligence in tempo reale.

  2. Selezionare il riquadro Database KQL.

    Screenshot del nuovo riquadro del database KQL in Intelligence in tempo reale.

  3. Nel campo Nome database KQL, immettere nycGreenTaxi e quindi selezionare Crea.

    Il database KQL viene creato nel contesto dell'area di lavoro selezionata.

  4. Copiare l'URI della query dalla scheda dei dettagli del database nel dashboard del database e incollarlo in un punto qualsiasi, ad esempio un Blocco note di Windows, da usare in un passaggio successivo.

     Screenshot della scheda dei dettagli del database che mostra i dettagli del database. L'opzione URI della query denominata Copia URI è evidenziata.

2- Scaricare il notebook di NYC GreenTaxi

È stato creato un notebook di esempio che illustra tutti i passaggi necessari per caricare i dati nel database usando il connettore Spark.

  1. Aprire il repository degli esempi di Fabric in GitHub per scaricare il notebook KQL di NYC GreenTaxi.

    Screenshot del repository GitHub che mostra il notebook di NYC GreenTaxi. L'opzione Raw è evidenziata.

  2. Salvare il notebook in locale nel dispositivo.

    Nota

    Il notebook deve essere salvato nel formato di file .ipynb.

3- Importare il Notebook

Il resto di questo workflow si verifica nella sezione Ingegneria dei dati del prodotto e usa un notebook Spark per caricare ed eseguire query sui dati nel database KQL.

  1. Aprire il commutatore esperienza nella parte inferiore del riquadro di spostamento e selezionare Sviluppa e quindi l'area di lavoro.

  2. Selezionare Import Notebook From this computer Upload (Importa>notebook>da questo computer>) e quindi scegliere il notebook nyc GreenTaxi scaricato in un passaggio precedente.

    Screenshot della finestra Stato importazione. Il pulsante Carica è evidenziato.

  3. Al termine dell'importazione, aprire il notebook dall'area di lavoro.

4- Ottenere i dati

Per eseguire query sul database usando il connettore Spark, è necessario concedere l'accesso in lettura e scrittura al contenitore BLOB NYC GreenTaxi.

Selezionare il pulsante esegui per eseguire le celle seguenti oppure selezionare la cella e premere Maiusc + Invio. Ripetere questo passaggio per ogni cella di codice.

Nota

Attendere che venga visualizzato il segno di spunta di completamento prima di eseguire la cella successiva.

  1. Eseguire la cella seguente per abilitare l'accesso al contenitore BLOB NYC GreenTaxi.

    Screenshot della prima cella di codice che mostra le informazioni di accesso alle risorse di archiviazione.

  2. In KustoURI incollare l'URI di query copiato in precedenza anziché il testo segnaposto.

  3. Modificare il nome del database segnaposto in nycGreenTaxi.

  4. Modificare il nome della tabella segnaposto in GreenTaxiData.

    Screenshot della seconda cella di codice che mostra le informazioni sul database di destinazione. L'URI di query, il nome del database e il nome della tabella sono evidenziati.

  5. Eseguire la cella.

  6. Eseguire la cella successiva per scrivere dati nel database. Il completamento di questo passaggio può richiedere alcuni minuti.

    Screenshot della terza cella di codice che mostra il mapping della tabella e il comando di inserimento.

Il database include ora i dati caricati in una tabella denominata GreenTaxiData.

5- Aprire il notebook

Eseguire le due celle rimanenti in sequenza per eseguire query sui dati dalla tabella. I risultati mostrano le 20 tariffe e distanze dei taxi più alte e più basse registrate per anno.

Screenshot della quarta e quinta cella di codice che mostra i risultati della query.

6- Eseguire la pulizia delle risorse

Eseguire la pulizia degli elementi creati passando all'area di lavoro in cui sono stati creati.

  1. Nell'area di lavoro passare il puntatore del mouse sul notebook che si vuole eliminare, selezionare il menu Altro [...] >Elimina.

    Screenshot dell'area di lavoro che mostra il menu a discesa del notebook di NYC GreenTaxi. L'opzione Elimina è evidenziata.

  2. Selezionare Elimina. Non è possibile recuperare il notebook dopo averlo eliminato.