Diagramme visualisieren

Wenn Sie Support anfordern oder Feedback zu dieser Funktion geben möchten, senden Sie eine E-Mail an bq-graph-preview-support@google.com.

BigQuery Graph-Visualisierungen zeigen die Ergebnisse einer Abfrage eines Graphschemas. Sie können Diagramme in BigQuery Studio oder in einer Notebook-Umgebung wie Google Colab oder Jupyter Notebook visualisieren.

Eine Visualisierung hilft Ihnen, die Verbindungen zwischen Datenpunkten (Knoten) zu verstehen (Kanten). Eine Tabelle mit Hunderten von Datenpunkten kann schwer zu interpretieren sein, während die entsprechende Graphvisualisierung Muster, Abhängigkeiten und Anomalien aufdecken kann.

BigQuery Graph-Abfrageergebnisse visualisieren

Sie können die Google Cloud console verwenden, um BigQuery Graph-Abfrage ergebnisse in BigQuery Studio zu visualisieren. Wenn Sie eine Abfrage mit BigQuery Graph visualisieren möchten, muss die Abfrage mithilfe der TO_JSON Funktion Graphelemente im JSON-Format zurückgeben. Wir empfehlen, Graphpfade zurückzugeben, anstatt Knoten und Kanten einzeln zurückzugeben. Die Rückgabe von Pfaden bietet folgende Vorteile:

  • Pfade enthalten vollständige Daten von 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 bei der Rückgabe einzelner Knoten und Kanten.

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

GRAPH graph_db.FinGraph
MATCH
  p = (person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(account2:Account)<-[own2:Owns]-(person2:Person)
RETURN
  TO_JSON(p) AS path;

Klicken Sie im Bereich Abfrageergebnisse auf Graph, um die Ergebnisse zu visualisieren. 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 Eigenschaften, Nachbarn und Verbindungen anzusehen. Alternativ können Sie die Abfrageergebnisse als Tabelle ansehen oder zu einer Visualisierung des zugrunde liegenden Graphschemas wechseln.

Visualisierung von Abfrageergebnissen.

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

Optionen für die Visualisierung von Abfrageergebnissen auswählen

Sie können die Darstellung der Knoten in einer Abfragevisualisierung ändern. Sie können beispielsweise das Layout der Abfragevisualisierung, die Farbe der Knoten und die Eigenschaft angeben, die auf jedem Knoten angezeigt werden soll.

Die Aktualisierungen der Anzeige von Abfrageergebnissen gelten nur für die aktuelle Visualisierungssitzung. Die Aktualisierungen der Visualisierungsoptionen bleiben nicht erhalten, wenn Sie dieselbe Abfrage noch einmal ausführen.

Layout für eine BigQuery Graph-Visualisierung 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 zusammengezogen werden. So werden physikalische Kräfte simuliert, um ein visuell intuitives Layout zu erstellen.

  • Hierarchisch: Knoten werden so positioniert, dass eine visuelle Hierarchie basierend auf der Konnektivität entsteht.

  • Sequenziell: Knoten werden so positioniert, dass eine visuelle Sequenz basierend auf Konnektivität entsteht.

  • Labels anzeigen: Alle Knoten- und Kantenlabels werden bei allen Zoom stufen im Diagramm angezeigt.

Anzuzeigende Knoten- oder Kanteneigenschaft auswählen

Standardmäßig wird die erste Eigenschaft eines Knotens oder einer Kante angezeigt. Wenn ein Knoten oder eine Kante eine andere Eigenschaft anzeigen soll, gehen Sie so vor:

  1. Wenn Sie eine Visualisierung der Ergebnisse einer BigQuery Graph-Abfrage ansehen, klicken Sie auf dem Tab Ergebnisse des Bereichs mit den Abfrageergebnissen auf Zur Schemaansicht wechseln.

    Schaltfläche zum Wechseln zur Schemaansicht.

  2. Klicken Sie in der Schemavisualisierung auf einen Knoten oder eine Kante des Typs, den Sie aktualisieren möchten.

  3. Klicken Sie im Detailbereich, der für den ausgewählten Knoten oder die ausgewählte Kante angezeigt wird, auf die Eigenschaft, die Sie anzeigen möchten. Alle Knoten oder Kanten in den Abfrageergebnissen, die dem ausgewählten Knoten- oder Kantentyp entsprechen, zeigen die ausgewählte Eigenschaft.

Farbe der Knoten auswählen

  1. Wenn Sie eine Visualisierung der Ergebnisse einer BigQuery Graph-Abfrage ansehen, klicken Sie auf dem Tab **Ergebnisse** des Bereichs mit den Abfrageergebnissen auf **Zur Schemaansicht wechseln**.

  2. Klicken Sie in der Schemavisualisierung auf einen Knoten des Typs, den Sie aktualisieren möchten.

  3. Klicken Sie im Detailbereich, der für den ausgewählten Knoten angezeigt wird, auf Optionen für die Knotendarstellung.

  4. Klicken Sie auf eine Farbe. Alle Knoten in den Abfrageergebnissen, die dem ausgewählten Knotentyp entsprechen, werden in der ausgewählten Farbe angezeigt.

Anzuzeigende Knoten auswählen

So wählen Sie aus, welche Knoten in einer Visualisierung angezeigt werden sollen:

  1. Klicken Sie in der Abfragevisualisierung mit der rechten Maustaste auf einen Knoten.

  2. Klicken Sie auf eine der folgenden Menüoptionen, um den sichtbaren Graphstatus zu ändern:

    • Mit Maximieren werden benachbarte Knoten gerendert, indem alle eingehenden und ausgehenden Kanten durchlaufen oder nach einem bestimmten Kantentyp gefiltert werden.

    • Mit Minimieren wird die aktuelle Ansicht reduziert, indem alle Knoten ausgeblendet werden, die über eingehende oder ausgehende Kanten oder einen bestimmten Kantentyp mit dem Zielknoten verbunden sind.

    • Mit Knoten ausblenden wird der Zielknoten aus der aktuellen Ansicht entfernt.

    • Mit Nur Nachbarn anzeigen werden alle Knoten im Diagramm ausgeblendet, mit Ausnahme des Zielknotens und der Knoten, die direkt mit ihm verbunden sind.

    • Mit Knoten hervorheben wird der Zielknoten hervorgehoben.

BigQuery Graph-Schema visualisieren

Die Struktur eines Graphen, einschließlich seiner Knoten, Kanten, Labels und Eigenschaften, wird durch sein Schema definiert, das Graphelemente Daten in BigQuery-Tabellen zuordnet. Die Graphdefinition wird in einem Schema gespeichert, das Sie mit Eingabetabellen erstellen.

Sie können Graphen visualisieren, die Sie mit einem Schema erstellen. Durch die Visualisierung des Schemas können Sie die Struktur des Graphen besser verstehen, einschließlich der Arten von Knoten und Kanten, die er enthält, und wie sie verbunden sind. Dies kann bei komplexen Graphen nützlich sein, da es eine klare Sicht auf Beziehungen bietet, die sich allein aus DDL-Anweisungen möglicherweise nur schwer ableiten lassen.

So visualisieren Sie ein Graphschema:

  1. Rufen Sie in BigQuery Studio den Bereich Explorer auf.
  2. Maximieren Sie das Dataset, das den Graphen enthält, maximieren Sie Graphen und wählen Sie dann den Graphen aus.
  3. Klicken Sie auf den Tab Graph.

Abfrageergebnisse und Schemas in einer Notebook-Umgebung visualisieren

Sie können Graphabfrageergebnisse und Graphschemas in Notebook-Umgebungen wie BigQuery Studio, Google Colab und Jupyter Notebook visualisieren. Die Visualisierung wird als IPython Magics implementiert.

Graphabfrageergebnisse visualisieren

So visualisieren Sie Abfrageergebnisse in einem Notebook:

  1. Führen Sie in einer Notebookzelle den folgenden Befehl aus, um die neueste BigQuery Magics-Bibliothek zu installieren:

    !pip install bigquery_magics==0.12.1

  2. Prüfen Sie in Ihrer Notebook-Umgebung, ob die BigQuery Graph-Clientbibliothek installiert ist.

  3. Verwenden Sie in einer Notebookzelle den magischen Befehl %%bigquery --graph gefolgt von Ihrer GQL-Abfrage. Die Abfrage muss mithilfe der TO_JSON Funktion Graphelemente im JSON-Format zurückgeben. Wir empfehlen, Graphpfade anstelle einzelner Knoten und Kanten zurückzugeben. Die Rückgabe von Pfaden bietet folgende Vorteile:

    • Pfade enthalten vollständige Daten von Knoten und Kanten. Wenn Sie einzelne Knoten und Kanten zurückgeben, sind einige Zwischenknoten und -kanten in der Visualisierung einer komplexen Abfrage möglicherweise nicht verfügbar.

    • Wenn Sie Pfade zurückgeben, ist Ihre RETURN-Anweisung weniger komplex als bei der Rückgabe einzelner Knoten und Kanten.

  4. Führen Sie die Zelle aus. Die Visualisierung wird im Ausgabebereich der Zelle angezeigt.

Die folgende Beispielabfrage sucht nach einer Person, ihren Konten und Überweisungen zwischen Konten und gibt die Ergebnisse dann in einem Notebook zurück:

%%bigquery --graph
GRAPH graph_db.FinGraph
MATCH
  p = ((person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(account2:Account)<-[own2:Owns]-(person2:Person))
RETURN
  TO_JSON(p) AS path;

Nachdem Sie eine Abfrage ausgeführt haben, wird die Visualisierung im Ausgabebereich 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 Eigenschaften, Nachbarn und Verbindungen anzusehen. Die folgende Abbildung zeigt Eigenschaften, Nachbarn und Verbindungen.

Visualisierung von Abfrageergebnissen.

BigQuery Graph-Schema visualisieren

Die Struktur eines Graphen, einschließlich seiner Knoten, Kanten, Labels und Eigenschaften, wird durch sein Schema definiert, das Daten in BigQuery-Tabellen Graphelementen zuordnet. Die Graphdefinition wird in einem Schema gespeichert, das Sie mit Eingabetabellen erstellen.

Sie können Graphen visualisieren, die Sie mit einem Schema erstellen. Durch die Visualisierung des Schemas können Sie die Struktur des Graphen besser verstehen, einschließlich der Arten von Knoten und Kanten, die er enthält, und wie sie verbunden sind. Dies kann bei komplexen Graphen nützlich sein, da es eine klare Sicht auf Beziehungen bietet, die sich allein aus den DDL-Anweisungen, mit denen Sie den Graphen erstellt haben, möglicherweise nur schwer ableiten lassen. Die folgende Abbildung zeigt ein Beispiel für eine Visualisierung eines Graphschemas.

Visualisierung eines Graphenschemas.

So sehen Sie eine Visualisierung eines BigQuery Graph-Schemas in einem Notebook:

  1. Führen Sie in einer Notebookzelle den folgenden Befehl aus, um die BigQuery Magics-Bibliothek zu installieren:

    !pip install bigquery_magics==0.12.1

  2. Prüfen Sie in Ihrer Notebook-Umgebung, ob die BigQuery Graph-Clientbibliothek installiert ist.

  3. Verwenden Sie in einer Notebookzelle den magischen Befehl %%bigquery --graph gefolgt von Ihrer GQL-Abfrage. Die Abfrage muss mithilfe der TO_JSON Funktion Graphelemente im JSON-Format zurückgeben.

  4. Führen Sie die Zelle aus. Die Visualisierung wird im Ausgabebereich der Zelle angezeigt.

  5. Klicken Sie in der Visualisierungsausgabe auf „Schema“ Schemaansicht.

Probleme mit BigQuery Graph-Visualisierungen beheben

Die folgenden Informationen können Ihnen helfen, Probleme mit BigQuery Graph-Visualisierungen zu beheben und das Verhalten besser zu verstehen.

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

Problem: Sie führen eine BigQuery Graph-Abfrage aus, aber sie wird nur im Tabellen format angezeigt.

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

Die folgende Abfrage kann beispielsweise nicht visualisiert werden, da sie Eigenschaftswerte anstelle von Graphelementen im JSON-Format zurückgibt:

GRAPH graph_db.FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name;

Lösung:

Geben Sie Graphelemente im JSON-Format mit TO_JSON zurück. Weitere Informationen finden Sie unter BigQuery Graph-Abfrageergebnisse visualisieren.

BigQuery Graph-Abfrageergebnisse werden nur teilweise visualisiert

Problem: Eine Visualisierung von Abfrageergebnissen zeigt nur einen Teil der Abfrageergebnisse.

Mögliche Ursache: Die Abfrage gibt mehr als 2 MB Daten zurück. Eine Abfragevisualisierung kann maximal 2 MB Daten anzeigen.

Lösung: Vereinfachen Sie die Abfrage, um weniger als 2 MB Daten zurückzugeben.

Einige Graphelemente werden in einer BigQuery Graph-Visualisierung nicht angezeigt

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

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

Lösung: Aktualisieren Sie die Abfrage, um einen Graphpfad zurückzugeben.

Nächste Schritte