Creare e gestire visivamente uno schema Spanner Graph

Anteprima : gestione visiva di Spanner Graph

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nota: questa funzionalità è disponibile con le versioni Enterprise ed Enterprise Plus di Spanner. Per saperne di più, consulta la Panoramica delle versioni di Spanner.

Questo documento fornisce una guida alla gestione visiva degli schemi di Spanner Graph in Spanner Studio. La modellazione visiva semplifica la progettazione dei grafici consentendoti di mappare nodi e archi tramite un'interfaccia intuitiva anziché creare istruzioni DDL manuali. Questa funzionalità semplifica la progettazione, la comprensione e la collaborazione con altri utenti. Inoltre, questo approccio applica automaticamente le best practice per lo schema di Spanner Graph, garantendo che sia ottimizzato fin dall'inizio.

Gli schemi di Spanner Graph possono anche essere creati e modificati con DDL. Per ulteriori informazioni sugli schemi dei grafici delle proprietà, consulta la panoramica dello schema di Spanner Graph overview. Se si verificano errori durante la creazione di uno schema di grafico delle proprietà, consulta Risolvere i problemi di Spanner Graph.

Crea un grafico

Per iniziare, vai a Spanner Studio e fai clic su Crea grafico nella home page. Lo strumento di modellazione dei grafici offre la flessibilità di creare il grafico in diversi modi:

• Da zero: progetta nodi e archi interamente tramite l'interfaccia visiva. Spanner genera automaticamente le istruzioni DDL necessarie e gli oggetti dello schema di ottimizzazione delle prestazioni.

• Da tabelle esistenti: mappa le tabelle relazionali correnti direttamente in un modello di grafico, a condizione che abbiano connessioni stabilite tra loro.

• Un approccio ibrido: modella alcuni elementi da zero mentre ne mappi altri dalle tabelle esistenti.

Modella i nodi

Per aggiungere un nodo al grafico:

Da zero

Quando crei un nuovo nodo, Spanner genera automaticamente una tabella di database. Quando definisci le proprietà e le chiavi del nodo, Spanner configura le colonne e le chiavi primarie della tabella.

1. Apri l'area di disegno di modellazione dei grafici in Spanner Studio.
2. Aggiungi un nodo al grafico e seleziona Nuovo come origine dati.
3. Assegna un nome al nodo. La tabella creata per questo nodo viene denominata in base a questo valore.
4. Assegna un'etichetta al nodo. Per impostazione predefinita, questa etichetta corrisponde al nome del nodo, ma può essere modificata.
5. Definisci le proprietà associate all'etichetta, inclusi nomi e tipi di dati. Seleziona È chiave elemento per almeno una proprietà per designarla come chiave. Seleziona Non è null per non consentire valori null.

Da una tabella esistente

Quando mappi un nodo a una tabella esistente, Spanner utilizza lo schema della tabella come base. L'etichetta, le proprietà e le chiavi vengono ereditate automaticamente dalla tabella, ma possono essere sostituite.

1. Apri l'area di disegno di modellazione dei grafici in Spanner Studio.
2. Aggiungi un nodo al grafico e seleziona Origine dati esistente come origine dati.
3. Assegna un'etichetta al nodo. Per impostazione predefinita, questa etichetta corrisponde al nome del nodo, ma può essere modificata.
4. Definisci le proprietà associate all'etichetta. Spanner mappa le colonne della tabella alle proprietà e le chiavi primarie alle chiavi degli elementi. Puoi personalizzare questa configurazione in uno dei seguenti modi:
   • Crea nuove proprietà: aggiungi nuove proprietà, in modo che Spanner crei automaticamente le colonne sottostanti nella tabella.
   • Elimina proprietà: rimuovi le colonne mappate che non ti servono per questo nodo.

Modella gli archi

Per aggiungere un arco al grafico:

Da zero

Quando crei un nuovo arco da zero, la tabella sottostante viene creata automaticamente. Quando definisci i nodi di origine e di destinazione, Spanner configura in background le chiavi primarie e le colonne di riferimento necessarie.

1. Apri l'area di disegno di modellazione dei grafici in Spanner Studio.

2. Aggiungi un arco al grafico e seleziona Nuovo come origine dati. Inserisci il nome dell'arco.

3. Seleziona i nodi di origine e di destinazione. Spanner genera le proprietà necessarie per identificare le chiavi degli elementi di origine e di destinazione, utilizzandole come chiavi degli elementi predefinite dell'arco.

   Per impostazione predefinita, può esistere un solo arco tra due nodi specifici perché Spanner utilizza le chiavi degli elementi dei nodi di origine e di destinazione per identificare in modo univoco ogni arco. Se hai bisogno di più archi tra gli stessi due nodi (un caso d'uso comune nel mondo reale), definisci una proprietà aggiuntiva e seleziona È chiave elemento per mantenere univoco ogni arco.

4. Assegna un'etichetta all'arco. Per impostazione predefinita, corrisponde al nome dell'arco.

5. Definisci eventuali proprietà aggiuntive per l'arco.

Quando finalizzi l'arco, Spanner genera automaticamente le istruzioni DDL necessarie per ottimizzare le traversate degli archi. Per ulteriori dettagli, consulta Esaminare e generare istruzioni DDL.

Da una tabella esistente

Quando mappi un arco a una tabella esistente, Spanner utilizza lo schema della tabella come base. L'etichetta, le proprietà e le chiavi vengono ereditate automaticamente dalla tabella, ma puoi sostituirle o aggiungere nuove proprietà.

1. Apri l'area di disegno di modellazione dei grafici in Spanner Studio.

2. Aggiungi un arco al grafico e seleziona Tabella esistente come origine dati.

3. Seleziona i nodi di origine e di destinazione. Definisci le colonne di riferimento di origine e di destinazione

4. Assegna un'etichetta all'arco. Per impostazione predefinita, corrisponde al nome della tabella di input dell'arco.

5. Definisci le proprietà associate all'etichetta. Spanner mappa automaticamente le colonne della tabella alle proprietà e le chiavi primarie alle chiavi degli elementi dell'arco. Puoi modificare questa configurazione nei seguenti modi:

   • Crea nuove proprietà: aggiungi nuove proprietà e Spanner creerà le colonne sottostanti nella tabella.
   • Elimina proprietà: rimuovi le colonne mappate che non ti servono per questo arco.

Per gli archi creati da tabelle esistenti, Spanner non genera istruzioni DDL per ottimizzare le traversate degli archi. Fai riferimento alle best practice per lo schema per applicare manualmente le ottimizzazioni.

Modifica un grafico

Puoi caricare un grafico delle proprietà esistente in Spanner Studio per aggiornarne la struttura.

1. In Esplora oggetti, trova il grafico che vuoi modificare e scegli Visualizza/modifica visivamente dal Altre opzioni menu.
2. Aggiungi nuovi nodi o archi da zero o mappati da tabelle esistenti.
3. Aggiorna le proprietà dei nodi e degli archi esistenti. Puoi utilizzare le colonne disponibili dalle tabelle sottostanti oppure aggiungere nuove proprietà e le colonne corrispondenti vengono aggiunte automaticamente alla tabella sottostante.
4. Rimuovi nodi o archi dalla definizione del grafico.

Esamina e genera istruzioni DDL

Al termine della modellazione, Spanner genera le seguenti istruzioni DDL in base al modello.

• CREATE OR REPLACE PROPERTY GRAPH: crea o aggiorna la definizione del grafico.
• CREATE TABLE: crea le tabelle sottostanti per tutti i nodi o gli archi creati da zero.
• ALTER TABLE ADD COLUMN: aggiunge nuove colonne di proprietà ai nodi o agli archi mappati da tabelle esistenti.
• ALTER TABLE ADD CONSTRAINT: crea vincoli di chiave esterna per ottimizzare la traversata degli archi in avanti.
• CREATE INDEX: crea indici degli archi inversi per ottimizzare la traversata degli archi inversi.

Esegui il commit delle modifiche al grafico:

1. Premi il pulsante Genera istruzioni DDL per generare lo schema. Vengono create le istruzioni DDL necessarie descritte in precedenza.
2. Esamina le istruzioni DDL generate nell'editor di Spanner Studio. Le istruzioni vengono presentate nell'ordine corretto di esecuzione e includono commenti che spiegano ogni oggetto dello schema. Puoi modificare le istruzioni prima di procedere.
3. Esegui le istruzioni per eseguire il commit delle modifiche al database.

Limitazioni

• Solo modifiche additive: per motivi di sicurezza, lo strumento non genera istruzioni DROP TABLE o DROP COLUMN. La rimozione di un nodo, un arco o una proprietà aggiorna solo la definizione di PROPERTY GRAPH. Non elimina le tabelle e le colonne sottostanti.
• Alcuni oggetti dello schema non supportati: questo strumento non genera automaticamente tutti gli oggetti dello schema, i tipi di dati delle colonne o i relativi qualificatori possibili. Tuttavia, puoi modificare manualmente le istruzioni DDL generate nell'editor prima di eseguirne il commit.
• Nessun supporto per il salvataggio delle bozze: quando modelli un grafico, i progressi non vengono salvati se chiudi la pagina.
• Nessun supporto per i dati senza schema: questo strumento genera solo grafici con struttura formale. Se il tuo caso d'uso richiede dati senza schema, puoi utilizzare questo esempio di schema come base per creare il grafico dei dati senza schema.
• Nessun supporto per viste e tabelle di schema denominate: non puoi selezionare viste di database o tabelle di schema denominate come origine dati quando mappi nodi e archi a origini dati esistenti.
• Nessun vincolo o indice degli archi mappati: lo strumento non genera vincoli di chiave esterna o indici degli archi inversi per gli archi mappati da tabelle esistenti. Consulta le best practice per la creazione manuale.

Passaggi successivi

• Gestisci i dati di Spanner Graph.
• Scopri di più sulle query Spanner Graph.
• Scopri le best practice per l'ottimizzazione delle query Spanner Graph.