Mit Spanner-Graphvisualisierungen arbeiten

Auf dieser Seite wird beschrieben, wie Sie mit Spanner-Graphvisualisierungen arbeiten. Eine Spanner Graph-Visualisierung kann die Grafikelemente enthalten, die von einer Abfrage zurückgegeben werden, oder die Elemente eines Grafikschemas. Mithilfe von Visualisierungen können Sie nachvollziehen, wie Datenpunkte (Knoten) miteinander verbunden sind (Kanten). Eine Tabelle mit Hunderten von Datenpunkten kann zwar schwer zu interpretieren sein, die zugehörige Grafikvisualisierung kann jedoch Muster, Abhängigkeiten und Anomalien aufzeigen.

Spanner Graph-Abfrageergebnisse visualisieren

Wenn Sie Spanner-Graphabfrageergebnisse in Spanner Studio visualisieren möchten, muss die Abfrage Graphenelemente im JSON-Format mithilfe der Funktion SAFE_TO_JSON oder TO_JSON zurückgeben. Außerdem empfehlen wir, Graphpfade zurückzugeben, anstatt Knoten und Kanten einzeln zurückzugeben. Vorteile von Rückgabepfaden:

  • 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 der Kontoübertragungen zurück, die visualisiert werden 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

Nach dem Ausführen einer Abfrage wird die Visualisierung im Bereich „Abfrageergebnisse“ angezeigt. Der Detailbereich enthält eine Zusammenfassung der Knoten- und Kantenlabels mit einer entsprechenden Anzahl. Klicken Sie auf einen Knoten oder eine Kante, um sich im Diagramm zu bewegen und sich Eigenschaften, Nachbarn und Verbindungen anzusehen, wie im folgenden Screenshot dargestellt. Alternativ können Sie die Abfrageergebnisse auch als Tabelle anzeigen oder zu einer Visualisierung des zugrunde liegenden Graph-Schemas wechseln.

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

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

Layout für Spanner-Grafikvisualisierung auswählen

Im Menü im Bereich „Visualisierung“ sind die folgenden Layoutoptionen verfügbar:

  • Force-Layout (Standardeinstellung): Die Knoten werden als Punkte dargestellt, die sich gegenseitig abstoßen, während verbundene Knoten aneinander gezogen werden. Dadurch werden physische Kräfte wie Magnetismus simuliert, um ein visuell intuitives Layout zu erstellen.
  • Hierarchisch: Positioniert Knoten, um eine visuelle Hierarchie basierend auf der Konnektivität zu generieren
  • Sequenziell: Positioniert Knoten, um eine visuelle Sequenz basierend auf der Konnektivität zu generieren
  • Labels anzeigen: Hiermit werden unabhängig von der Zoomstufe alle Knoten- und Kantenlabels im Diagramm angezeigt.

Probleme mit Visualisierungen beheben

Im Folgenden finden Sie Informationen zur Fehlerbehebung und zum Verhalten der Spanner-Graphvisualisierung.

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

Problem: Sie führen eine Spanner-Graphabfrage aus, die nur im Tabellenformat angezeigt wird.

Mögliche Ursache: Die Abfrage gibt keine Graphenelemente 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:

Mit SAFE_TO_JSON oder TO_JSON können Sie Diagramme im JSON-Format zurückgeben. Weitere Informationen finden Sie unter Spanner-Graph-Abfrageergebnisse visualisieren.

Abfrageergebnisse werden teilweise visualisiert

Problem: In einer Visualisierung von Abfrageergebnissen 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 angezeigt werden.

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

Ein Knoten oder eine Kante wird mit einem unerwarteten Label angezeigt

Problem: Ein Knoten oder eine Kante in einer Grafikvisualisierung hat ein unerwartetes Label.

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

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

Einige Diagrammelemente sind in einer Visualisierung nicht verfügbar

Problem: Eine Visualisierung enthält alle zurückgegebenen Knoten und Kanten, aber einige der Graphenelemente fehlen.

Mögliche Ursache: Die Abfrage, die zum Erstellen der Visualisierung verwendet wurde, gibt einzelne Knoten und Kanten anstelle eines Graphenpfads zurück.

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

Nächste Schritte