Diagramme visualisieren

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

In BigQuery Graph-Visualisierungen werden die Grafikelemente angezeigt, die von einer Abfrage zurückgegeben werden, oder die Elemente eines Grafenschemas. Sie können Diagramme in einer Notebook-Umgebung wie BigQuery Studio, 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 Visualisierung als Diagramm Muster, Abhängigkeiten und Anomalien aufdecken kann.

Abfrageergebnisse und Schemas in einer Notebook-Umgebung visualisieren

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

Diagrammabfrageergebnisse 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 Grafikelemente im JSON-Format mit der TO_JSON Funktion zurückgeben. Wir empfehlen, Diagrammpfade 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 die 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.

Mit der folgenden Beispielabfrage werden eine Person, ihre Konten und zurückgezahlten Darlehen gesucht und die Ergebnisse dann in einem Notebook zurückgegeben:

%%bigquery --graph
GRAPH graph_db.FinGraph
MATCH
  p = ((person:Person {name: "Dana"})-[own:Owns]->
  (account:Account)-[transfer:Transfers]->(acount2: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 Anzahl für jedes Label angezeigt. Klicken Sie auf einen Knoten oder eine Kante, um im Diagramm zu navigieren und Eigenschaften, Nachbarn und Verbindungen aufzurufen. Die folgende Abbildung zeigt Eigenschaften, Nachbarn und Verbindungen.

Visualisierung von Abfrageergebnissen.

BigQuery Graph-Schema visualisieren

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

Sie können Diagramme visualisieren, die Sie mit einem Schema erstellen. Durch die Visualisierung des Schemas können Sie die Struktur Ihres Diagramms besser verstehen, einschließlich der Arten von Knoten und Kanten und ihrer Verbindungen. Dies kann bei komplexen Diagrammen nützlich sein, da es eine klare Ansicht der Beziehungen bietet, die aus den DDL-Anweisungen, mit denen Sie das Diagramm erstellt haben, möglicherweise schwer abzuleiten sind. Die folgende Abbildung zeigt ein Beispiel für eine Visualisierung eines Diagrammschemas.

Visualisierung eines Diagrammschemas.

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

  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 Grafikelemente im JSON-Format mit der TO_JSON Funktion 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 Grafikelemente im JSON-Format zurück.

Die folgende Abfrage kann beispielsweise nicht visualisiert werden, da sie Eigenschaftswerte anstelle von Grafikelementen 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 Grafikelemente 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 der Abfrageergebnisse 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 Grafikelemente werden in einer BigQuery Graph-Visualisierung nicht angezeigt

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

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

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

Nächste Schritte