Spanner Graph-Schema visuell erstellen und verwalten

In diesem Dokument finden Sie eine Anleitung zum visuellen Verwalten von Spanner Graph-Schemas in Spanner Studio. Die visuelle Modellierung vereinfacht das Graphdesign, da Sie Knoten und Kanten über eine intuitive Benutzeroberfläche zuordnen können, anstatt DDL-Anweisungen manuell zu erstellen. Diese Funktion erleichtert das Design, das Verständnis und die Zusammenarbeit mit anderen. Außerdem werden bei diesem Ansatz automatisch die Best Practices für Spanner Graph-Schemas angewendet, sodass sie von Anfang an optimiert sind.

Spanner Graph-Schemas können auch mit erstellt und bearbeitet werden DDL. Weitere Informationen zu Property Graph-Schemas finden Sie in der Übersicht über Spanner Graph-Schemas overview. Wenn beim Erstellen eines Property Graph-Schemas Fehler auftreten, finden Sie unter Fehlerbehebung bei Spanner Graph weitere Informationen.

Der Detailbereich für Kanten beim Bearbeiten eines Diagrammschemas in Spanner Studio

Graph erstellen

Rufen Sie Spanner Studio auf und klicken Sie auf der Startseite auf Graph erstellen, um zu beginnen. Mit dem Graphmodellierungstool können Sie Ihren Graph auf verschiedene Arten erstellen:

  • Von Grund auf neu:Entwerfen Sie Knoten und Kanten vollständig über die visuelle Benutzeroberfläche. Spanner generiert automatisch die erforderlichen DDLs und Schemaobjekte zur Leistungsoptimierung.

  • Aus vorhandenen Tabellen:Ordnen Sie Ihre aktuellen relationalen Tabellen direkt einem Graphmodell zu, sofern sie miteinander verbunden sind.

  • Hybridansatz:Modellieren Sie einige Elemente von Grund auf neu, während Sie andere aus Ihren vorhandenen Tabellen zuordnen.

Knoten modellieren

So fügen Sie dem Graph einen Knoten hinzu:

Von Grund auf neu

Wenn Sie einen neuen Knoten erstellen, generiert Spanner automatisch eine Datenbanktabelle dafür. Wenn Sie die Attribute und Schlüssel des Knotens definieren, konfiguriert Spanner die Spalten und Primärschlüssel für die Tabelle.

  1. Öffnen Sie die Graphmodellierungsfläche in Spanner Studio.
  2. Fügen Sie dem Graph einen Knoten hinzu und wählen Sie Neu als Datenquelle aus.
  3. Weisen Sie dem Knoten einen Namen zu. Die für diesen Knoten erstellte Tabelle wird nach diesem Wert benannt.
  4. Weisen Sie dem Knoten ein Label zu. Standardmäßig entspricht dieses Label dem Namen des Knotens, kann aber geändert werden.
  5. Definieren Sie die mit dem Label verknüpften Attribute, einschließlich der Namen und Datentypen. Wählen Sie für mindestens ein Attribut Ist Elementschlüssel aus, um es als Schlüssel festzulegen. Wählen Sie Ist nicht null aus, um Nullwerte zu verhindern.

Aus einer vorhandenen Tabelle

Wenn Sie einen Knoten einer vorhandenen Tabelle zuordnen, verwendet Spanner das Schema der Tabelle als Grundlage. Das Label, die Attribute und die Schlüssel werden automatisch von der Tabelle übernommen, können aber überschrieben werden.

  1. Öffnen Sie die Graphmodellierungsfläche in Spanner Studio.
  2. Fügen Sie dem Graph einen Knoten hinzu und wählen Sie Vorhandene Datenquelle als Datenquelle aus.
  3. Weisen Sie dem Knoten ein Label zu. Standardmäßig entspricht dieses Label dem Namen des Knotens, kann aber geändert werden.
  4. Definieren Sie die mit dem Label verknüpften Attribute. Spanner ordnet die Spalten der Tabelle den Attributen und die Primärschlüssel den Elementschlüsseln zu. Sie können diese Einrichtung auf folgende Weise anpassen:
    • Neue Attribute erstellen:Fügen Sie neue Attribute hinzu. Spanner erstellt dann automatisch die zugrunde liegenden Spalten in Ihrer Tabelle.
    • Attribute löschen:Entfernen Sie alle zugeordneten Spalten, die Sie für diesen Knoten nicht benötigen.

Kanten modellieren

So fügen Sie dem Graph eine Kante hinzu:

Von Grund auf neu

Wenn Sie eine neue Kante von Grund auf neu erstellen, wird die zugrunde liegende Tabelle automatisch erstellt. Wenn Sie die Quell- und Zielknoten definieren, konfiguriert Spanner im Hintergrund die erforderlichen Primärschlüssel und Referenzspalten.

  1. Öffnen Sie die Graphmodellierungsfläche in Spanner Studio.

  2. Fügen Sie dem Graph eine Kante hinzu und wählen Sie Neu als Datenquelle aus. Geben Sie den Namen der Kante ein.

  3. Wählen Sie die Quell- und Zielknoten aus. Spanner generiert die Attribute, die zum Identifizieren der Quell- und Ziel-Elementschlüssel erforderlich sind, und verwendet sie als Standard-Elementschlüssel der Kante.

    Standardmäßig kann zwischen zwei bestimmten Knoten nur eine einzige Kante vorhanden sein, da Spanner die Elementschlüssel des Quell- und Zielknotens verwendet, um jede Kante eindeutig zu identifizieren. Wenn Sie mehrere Kanten zwischen denselben beiden Knoten benötigen (ein häufiger Anwendungsfall in der Praxis), definieren Sie ein zusätzliches Attribut und wählen Sie Ist Elementschlüssel aus, damit jede Kante eindeutig ist.

  4. Weisen Sie der Kante ein Label zu. Standardmäßig entspricht dieses Label dem Namen der Kante.

  5. Definieren Sie alle zusätzlichen Attribute für die Kante.

Wenn Sie die Kante fertiggestellt haben, generiert Spanner automatisch die DDL-Anweisungen, die zum Optimieren der Kantentraversierungen erforderlich sind. Weitere Informationen finden Sie unter DDL prüfen und generieren.

Aus einer vorhandenen Tabelle

Wenn Sie eine Kante einer vorhandenen Tabelle zuordnen, verwendet Spanner das Schema der Tabelle als Grundlage. Das Label, die Attribute und die Schlüssel werden automatisch von der Tabelle übernommen, können aber überschrieben oder neue Attribute hinzugefügt werden.

  1. Öffnen Sie die Graphmodellierungsfläche in Spanner Studio.

  2. Fügen Sie dem Graph eine Kante hinzu und wählen Sie Vorhandene Tabelle als Datenquelle aus.

  3. Wählen Sie die Quell- und Zielknoten aus. Definieren Sie die Referenzspalten für Quelle und Ziel references columns.

  4. Weisen Sie der Kante ein Label zu. Standardmäßig entspricht dieses Label dem Namen der Eingabetabelle der Kante.

  5. Definieren Sie die mit dem Label verknüpften Attribute. Spanner ordnet die Spalten der Tabelle automatisch den Attributen und die Primärschlüssel den Elementschlüsseln der Kante zu. Sie können diese Einrichtung auf folgende Weise ändern:

    • Neue Attribute erstellen:Fügen Sie neue Attribute hinzu. Spanner erstellt dann die zugrunde liegenden Spalten in Ihrer Tabelle.
    • Attribute löschen:Entfernen Sie alle zugeordneten Spalten, die Sie für diese Kante nicht benötigen.

Für Kanten, die aus vorhandenen Tabellen erstellt wurden, generiert Spanner keine DDL-Anweisungen zur Optimierung der Kantentraversierungen. Informationen zum manuellen Anwenden von Optimierungen finden Sie in den Best Practices für Schemas.

Graph ändern

Sie können einen vorhandenen Property Graph in Spanner Studio laden, um seine Struktur zu aktualisieren.

  1. Suchen Sie im Objekt-Explorer den Graph, den Sie bearbeiten möchten, und wählen Sie im Menü Weitere Optionen die Option Visuell ansehen/ändern aus.
  2. Fügen Sie neue Knoten oder Kanten von Grund auf neu oder aus vorhandenen Tabellen zugeordnet hinzu.
  3. Aktualisieren Sie die Attribute vorhandener Knoten und Kanten. Sie können verfügbare Spalten aus den zugrunde liegenden Tabellen verwenden oder neue Attribute hinzufügen. Die entsprechenden Spalten werden dann automatisch der zugrunde liegenden Tabelle hinzugefügt.
  4. Entfernen Sie Knoten oder Kanten aus der Graphdefinition.

DDL prüfen und generieren

Wenn die Modellierung abgeschlossen ist, generiert Spanner die folgenden DDL-Anweisungen basierend auf Ihrem Modell.

  • CREATE OR REPLACE PROPERTY GRAPH: Erstellt oder aktualisiert die Graphdefinition.
  • CREATE TABLE: Erstellt die zugrunde liegenden Tabellen für alle Knoten oder Kanten, die von Grund auf neu erstellt wurden.
  • ALTER TABLE ADD COLUMN: Fügt Knoten oder Kanten, die aus vorhandenen Tabellen zugeordnet wurden, neue Attributspalten hinzu.
  • ALTER TABLE ADD CONSTRAINT: Erstellt Fremdschlüsseleinschränkungen, um die Traversierung von Vorwärtskanten zu optimieren.
  • CREATE INDEX: Erstellt Indexe für Rückwärtskanten, um die Traversierung von Rückwärtskanten zu optimieren.

So übernehmen Sie die Graphänderungen:

  1. Klicken Sie auf die Schaltfläche DDL generieren , um das Schema zu generieren. Die zuvor beschriebenen erforderlichen DDL-Anweisungen werden erstellt.
  2. Prüfen Sie die generierten DDL-Anweisungen im Spanner Studio-Editor. Die Anweisungen werden in der richtigen Reihenfolge für die Ausführung präsentiert und enthalten Kommentare, in denen die einzelnen Schemaobjekte erläutert werden. Sie können alle Anweisungen bearbeiten, bevor Sie fortfahren.
  3. Führen Sie die Anweisungen aus, um die Änderungen in Ihrer Datenbank zu übernehmen.

Beschränkungen

  • Nur additive Änderungen:Aus Sicherheitsgründen generiert das Tool keine DROP TABLE- oder DROP COLUMN-Anweisungen. Wenn Sie einen Knoten, eine Kante oder ein Attribut entfernen, wird nur die PROPERTY GRAPH-Definition aktualisiert. Die zugrunde liegenden Tabellen und Spalten werden nicht gelöscht.
  • Einige nicht unterstützte Schemaobjekte:Dieses Tool generiert nicht automatisch alle möglichen Schemaobjekte, Spaltendatentypen oder deren Qualifizierer. Sie können die generierten DDL-Anweisungen jedoch im Editor manuell bearbeiten, bevor Sie sie übernehmen.
  • Keine Unterstützung für das Speichern von Entwürfen:Wenn Sie einen Graph modellieren, wird der Fortschritt nicht gespeichert, wenn Sie die Seite schließen.
  • Keine Unterstützung für schemalose Daten:Dieses Tool generiert nur Graphen mit formaler Struktur. Wenn Ihr Anwendungsfall schemalose Daten erfordert, können Sie dieses Schema als Grundlage verwenden, um Ihren schemalosen Datengraph zu erstellen.
  • Keine Unterstützung für Ansichten und benannte Schematabellen:Sie können keine Datenbankansichten oder benannten Schematabellen als Datenquelle auswählen, wenn Sie Knoten und Kanten vorhandenen Datenquellen zuordnen.
  • Keine zugeordneten Kanteneinschränkungen oder Indexe:Das Tool generiert keine Fremdschlüsseleinschränkungen oder Indexe für Rückwärtskanten für Kanten, die aus vorhandenen Tabellen zugeordnet wurden. Informationen zur manuellen Erstellung finden Sie in den Best Practices.

Nächste Schritte