Spanner Graph-Visualisierungen verwenden

In Spanner Graph-Visualisierungen werden die Grafikelemente angezeigt, die von einer Abfrage zurückgegeben werden, oder die Elemente eines Grafschema. Eine Visualisierung hilft Ihnen, die Verbindungen zwischen Datenpunkten (Knoten) zu verstehen (Kanten). Eine Tabelle mit Hunderten von Datenpunkten kann schwer zu interpretieren sein, aber die grafische Darstellung kann Muster, Abhängigkeiten und Anomalien aufzeigen.

Ergebnisse von Spanner Graph-Abfragen visualisieren

Wenn Sie die Ergebnisse von Spanner Graph-Abfragen in Spanner Studio visualisieren möchten, muss die Abfrage Grafikelemente im JSON-Format zurückgeben. Verwenden Sie dazu die Funktion SAFE_TO_JSON oder TO_JSON. Wir empfehlen, Diagrammpfade zurückzugeben, anstatt Knoten und Kanten einzeln zurückzugeben. Das Zurückgeben von Pfaden bietet folgende Vorteile:

  • Pfade enthalten vollständige Daten zu Knoten und Kanten. Einige Zwischenknoten und ‑kanten in einer Visualisierung einer komplexen Abfrage sind möglicherweise nicht verfügbar, wenn Sie einzelne Knoten und Kanten zurückgeben.

  • Wenn Sie Pfade zurückgeben, kann Ihre RETURN-Anweisung weniger komplex sein als wenn Sie Knoten und Kanten einzeln zurückgeben.

Die folgende Beispielabfrage gibt die Pfade von Kontoübertragungen zurück, die Sie visualisieren können:

GRAPH FinGraph
MATCH result_paths = (account:Account {is_blocked: True})-[:Transfers]->(dest_account:Account)
RETURN SAFE_TO_JSON(result_paths) AS result_paths

Nachdem Sie eine Abfrage ausgeführt haben, wird die Visualisierung im Bereich „Abfrageergebnisse“ angezeigt. Im Detailbereich wird eine Zusammenfassung der Knoten- und Kantenlabels mit der jeweiligen Anzahl angezeigt. Klicken Sie auf einen Knoten oder eine Kante, um im Diagramm zu navigieren und Attribute, Nachbarn und Verbindungen aufzurufen, wie im folgenden Screenshot dargestellt. Alternativ können Sie die Abfrageergebnisse als Tabelle ansehen oder zu einer Visualisierung des zugrunde liegenden Grafschemas wechseln.

Ein/Aus-Schaltfläche für Abfrageergebnisse.

Weitere Informationen finden Sie unter Graphenelemente als JSON zurückgeben.

Layout für die Visualisierung von Spanner Graph auswählen

Das Menü im Visualisierungsbereich bietet die folgenden Layoutoptionen:

  • Force-Layout (Standard): Knoten werden als Punkte dargestellt, die sich gegenseitig abstoßen, während verbundene Knoten sich anziehen. So werden physische Kräfte simuliert, um ein visuell intuitives Layout zu erstellen.

  • Hierarchisch: Positioniert Knoten, um eine visuelle Hierarchie basierend auf der Konnektivität zu erstellen.

  • Sequenziell: Positioniert Knoten, um eine visuelle Sequenz basierend auf der Konnektivität zu erstellen.

  • Labels anzeigen: Zeigt alle Knoten- und Kantenlabels im Diagramm bei allen Zoomstufen an.

Spanner Graph-Schema visualisieren

Die Struktur eines Spanner-Graphen, z. B. seine Knoten, Kanten, Labels und Attribute, wird durch sein Schema definiert, das Grafikelemente Daten in Spanner-Tabellen zuordnet. Die Graphdefinition wird entweder in einem Schema gespeichert, das Sie mit Eingabetabellen erstellen, oder sie ergibt sich aus den Daten, wenn Sie schemalose Datenverwaltung verwenden.

Sie können Diagramme visualisieren, die Sie mit einem Schema erstellen, oder Diagramme, die die schemalose Datenverwaltung verwenden. Wenn Sie das Schema visualisieren, können Sie die Struktur Ihres Graphen besser nachvollziehen, einschließlich der darin enthaltenen Knoten- und Kantentypen und ihrer Verbindungen. Das kann bei komplexen Diagrammen nützlich sein, da Beziehungen, die sich allein aus DDL-Anweisungen nur schwer ableiten lassen, klar dargestellt werden.

Sie können eine Visualisierung eines Spanner Graph-Schemas in derGoogle Cloud -Konsole aufrufen. Gehen Sie dazu so vor:

  • Wenn Sie eine Visualisierung der Ergebnisse einer Spanner Graph-Abfrage ansehen, klicken Sie im Bereich „Abfrageergebnisse“ auf dem Tab Ergebnisse auf Zur Schemaansicht wechseln.

    Schaltfläche zum Wechseln zur Schemaansicht.

  • Klicken Sie im Bereich Explorer in einem Spanner-Diagramm auf Schema ansehen:

    1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

      Spanner aufrufen

    2. Wählen Sie eine Instanz aus der Liste aus.

    3. Wählen Sie eine Datenbank aus.

    4. Klicken Sie im Navigationsmenü auf Spanner Studio. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

    5. Klicken Sie in einem Spanner-Diagramm auf  Aktionen ansehen und dann auf Schema ansehen.

Fehlerbehebung bei Spanner Graph-Visualisierungen

Die folgenden Informationen können Ihnen helfen, Probleme mit der Visualisierung von Spanner Graph zu beheben und das Verhalten zu verstehen.

Für eine Spanner Graph-Abfrage wird keine Visualisierung angezeigt

Problem: Sie führen eine Spanner Graph-Abfrage aus und die Ergebnisse werden nur im Tabellenformat angezeigt.

Mögliche Ursache: Die Abfrage gibt keine Grafikelemente im JSON-Format zurück. Beispiel:

  • Die folgende Abfrage kann nicht visualisiert werden, da sie Knoten- und Kanten-IDs zurückgibt:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN person.id as person_id, account.id as account_id
  • Die folgende Abfrage kann nicht visualisiert werden, da sie Attributwerte zurückgibt:
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

Empfohlene Lösung:

Geben Sie Grafikelemente im JSON-Format mit SAFE_TO_JSON oder TO_JSON zurück. Weitere Informationen finden Sie unter Spanner Graph-Abfrageergebnisse visualisieren.

Spanner Graph-Abfrageergebnisse werden teilweise visualisiert

Problem: In einer Visualisierung der Abfrageergebnisse wird nur ein Teil der Abfrageergebnisse angezeigt.

Mögliche Ursache: Die Abfrage gibt mehr als 10 MB Daten zurück. In einer Abfragevisualisierung können bis zu 10 MB Daten dargestellt werden.

Empfohlene Lösung: Vereinfachen Sie die Abfrage, damit weniger als 10 MB Daten zurückgegeben werden.

Eine Spanner Graph-Visualisierung enthält einen Knoten oder eine Kante mit einem unerwarteten Label.

Problem: Für einen Knoten oder eine Kante in einer Spanner Graph-Visualisierung wird ein unerwartetes Label angezeigt.

Mögliche Ursache: Dem Knoten oder der Kante sind mehrere Labels zugewiesen. In einer Spanner-Graph-Visualisierung kann für jeden Knoten und jede Kante ein Label angezeigt werden. Wenn ein Knoten oder eine Kante mehrere Labels hat, wird in der Visualisierung das erste Label angezeigt.

Empfohlene Lösung: Keine. Sie können nicht ändern, welches Label angezeigt wird.

Einige Grafikelemente werden in einer Spanner Graph-Visualisierung nicht angezeigt

Problem: Eine Visualisierung enthält alle zurückgegebenen Knoten und Kanten, aber einige der Grafikelemente werden nicht angezeigt.

Mögliche Ursache: Die Abfrage, mit der die Spanner Graph-Visualisierung erstellt wurde, gibt einzelne Knoten und Kanten anstelle eines Graphpfads zurück.

Empfohlene Lösung: Aktualisieren Sie die Abfrage, damit ein Graphpfad zurückgegeben wird.

Nächste Schritte