Guida introduttiva: Creare il primo grafico in Microsoft Fabric

In questa guida introduttiva si crea un grafo di base con due nodi e un arco e quindi si esegue una query. Questo processo richiede circa 15 minuti.

Per un'esercitazione completa che illustra il modello di dati Adventure Works completo e scenari più avanzati, vedere l'esercitazione su Graph.

Prerequisiti

Prima di iniziare questa guida introduttiva, verificare che:

1. Graph è disponibile nella tua regione.

2. Graph è abilitato nel tenant di Fabric.

   

3. Si è membri di uno spazio di lavoro Fabric o si ha l'autorizzazione per creare elementi nello spazio di lavoro. Per altre informazioni, vedere Aree di lavoro in Microsoft Fabric.

   Importante

   La gestione degli accessi del grafico è limitata all'area di lavoro che lo ospita. Gli utenti esterni all'area di lavoro non possono accedere al grafico. Gli utenti all'interno dell'area di lavoro che hanno accesso ai dati di base nel lakehouse possono modellare ed eseguire query sul grafico.

Caricare dati di esempio

Per creare il grafico, carica prima i dati di esempio in una lakehouse nell'area di lavoro Fabric.

Scaricare i dati di esempio

1. Vai ai set di dati di esempio GQL di Fabric Graph su GitHub.

2. Selezionare il file adventureworks_docs_sample.zip e scaricarlo nel computer locale.

   Suggerimento

   Per scaricare un file da GitHub, selezionare il file e quindi selezionare l'icona Scarica file non elaborato .

3. Estrarre il file adventureworks_docs_sample.zip scaricato in una cartella nel computer locale.

   Suggerimento

   In Esplora file fare clic con il pulsante destro del mouse sul file ZIP e scegliere Estrai tutto, quindi scegliere una cartella di destinazione.

Crea un lakehouse

1. In Microsoft Fabric selezionare l'area di lavoro.

2. Selezionare + Nuovo elemento.

3. Selezionare Store data>Lakehouse.

4. Immettere un nome, ad esempio "AdventureWorksLakehouse", deselezionare l'opzione Schemi Lakehouse e selezionare Crea.

   Importante

   Graph attualmente non supporta i lakehouse con lo schema lakehouse (anteprima) abilitato.

Carica i dati nelle tabelle

Per questa guida introduttiva sono necessarie solo due tabelle: adventureworks_customers e adventureworks_orders. Caricare la cartella dei dati di esempio completa e quindi caricare solo queste due tabelle.

1. Nel lakehouse, passare il puntatore del mouse su File, selezionare i puntini di sospensione (...), quindi selezionare Carica e poi >carica cartella.
2. Passare alla cartella estratta e caricarla. Questa azione carica tutti i file di dati di esempio nel lakehouse.
3. Espandere File e la cartella caricata per visualizzare le sottocartelle. Per questa guida introduttiva, è sufficiente caricarne due come tabelle.
4. Posiziona il cursore sulla sottocartella adventureworks_customers, seleziona i puntini di sospensione (...) e scegli Carica in tabelle>Nuova tabella.
5. Impostare il tipo di file su Parquet e selezionare Carica.
6. Ripetere i passaggi da 4 a 5 per la sottocartella adventureworks_orders .

Creare un modello a grafo

1. Nell'area di lavoro di Microsoft Fabric selezionare + Nuovo elemento.

2. Selezionare Analizza ed esegui il training>Modello grafico (anteprima).

   

   Suggerimento

   In alternativa, immettere "graph" nella casella di ricerca e premere INVIO per cercare gli elementi del grafo.

3. Immettere un nome, ad esempio "MyFirstGraph" e selezionare Crea.

Dopo aver creato il modello a grafo, viene visualizzata la visualizzazione grafico in cui è possibile vedere che la modalità predefinita è impostata su Modello con Salva, Recupera dati, Aggiungi nodo e Aggiungi bordo nella parte superiore.

Creare un grafico

Per creare un grafico in Microsoft Fabric, seguire questa procedura nella visualizzazione grafico:

1. Selezionare Recupera i dati.

2. Nel catalogo OneLake, seleziona il lakehouse con i dati di Adventure Works.

3. Selezionare Connetti.

4. Selezionare le tabelle adventureworks_customers e adventureworks_orders e quindi selezionare Carica.

   

Aggiungere due nodi

1. Selezionare Aggiungi nodo.

2. Configurare il primo nodo:

   • Etichetta: Cliente
   • Tabella di mappatura: adventureworks_customers
   • ID della colonna di mapping: CustomerID_K

   

3. Seleziona Conferma.

4. Selezionare di nuovo Aggiungi nodo .

5. Configurare il secondo nodo:

   • Etichetta: Ordine
   • Tabella di mappatura: adventureworks_orders
   • ID della colonna di mapping: SalesOrderDetailID_K

6. Seleziona Conferma.

Aggiungere un bordo

1. Selezionare Aggiungi spigolo.

2. Configurare il bordo:

   • Etichetta: acquisti
   • Tabella di mappatura: adventureworks_orders
   • Nodo di origine: Customer
   • Colonna di mapping origine: CustomerID_FK
   • Nodo di destinazione: Ordine
   • Colonna mapping di destinazione: SalesOrderDetailID_K

   

3. Seleziona Conferma.

4. Selezionare Salva per caricare il grafico.

Eseguire query sul grafo

Eseguire una query GQL per trovare i primi cinque clienti in base al numero di ordini.

1. Selezionare Modalità query .

2. Selezionare Editor di codice dal menu in alto.

3. Immettere la query GQL seguente nella casella di input:

   MATCH (c:Customer)-[:purchases]->(o:`Order`)
   RETURN c.fullName AS customer_name, count(o) AS num_orders
   GROUP BY customer_name
   ORDER BY num_orders DESC
   LIMIT 5
   

4. Selezionare Esegui query per visualizzare i primi cinque clienti in base al numero di ordini.

L'immagine seguente mostra la query GQL e i relativi risultati:

Congratulazioni! Il primo grafo in Microsoft Fabric è stato creato ed è stata eseguita una query su di essa.

Passaggi successivi

• Esercitazione su Graph - Creare un grafico completo con più nodi, archi e query
• Guida al linguaggio GQL - Informazioni sulla sintassi GQL
• Che cos'è Graph in Microsoft Fabric? - Informazioni sui concetti relativi ai grafi