Memvisualisasikan grafik

Untuk meminta dukungan atau memberikan masukan terkait fitur ini, kirim email ke bq-graph-preview-support@google.com.

Visualisasi BigQuery Graph menampilkan elemen grafik yang ditampilkan oleh kueri atau elemen skema grafik. Anda dapat memvisualisasikan grafik di lingkungan notebook, seperti BigQuery Studio, Google Colab, atau Jupyter Notebook.

Visualisasi membantu Anda memahami cara titik data (node) terhubung (tepi). Meskipun tabel dengan ratusan titik data sulit untuk ditafsirkan, visualisasi grafiknya dapat mengungkapkan pola, dependensi, dan anomali.

Memvisualisasikan hasil kueri dan skema di lingkungan notebook

Anda dapat memvisualisasikan hasil kueri grafik dan skema grafik di lingkungan notebook seperti BigQuery Studio, Google Colab, dan Jupyter Notebook. Visualisasi diterapkan sebagai IPython Magic.

Memvisualisasikan hasil kueri grafik

Untuk memvisualisasikan hasil kueri dalam notebook, ikuti langkah-langkah berikut:

  1. Di sel notebook, jalankan perintah berikut untuk menginstal library magic BigQuery terbaru:

    !pip install bigquery_magics==0.12.1

  2. Di lingkungan notebook, pastikan Anda telah menginstal library klien BigQuery Graph.

  3. Di sel notebook, gunakan perintah magic %%bigquery --graph yang diikuti dengan kueri GQL Anda. Kueri harus menampilkan elemen grafik dalam format JSON menggunakan fungsi TO_JSON. Sebaiknya kembalikan jalur grafik, bukan node dan tepi individual. Mengembalikan jalur memberikan manfaat berikut:

    • Jalur berisi data lengkap node dan tepi. Jika Anda menampilkan node dan tepi individual, beberapa node dan tepi perantara dalam visualisasi kueri kompleks mungkin tidak tersedia.

    • Jika Anda menampilkan jalur, pernyataan RETURN Anda tidak terlalu rumit dibandingkan jika Anda menampilkan node dan tepi individual.

  4. Jalankan sel. Visualisasi ditampilkan di area output sel.

Contoh kueri berikut menemukan seseorang, akunnya, dan pinjaman yang telah dilunasi, lalu menampilkan hasilnya dalam notebook:

%%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;

Setelah Anda menjalankan kueri, area output akan menampilkan visualisasi. Panel detail menampilkan ringkasan label node dan tepi dengan jumlah untuk setiap label. Klik node atau tepi untuk menjelajahi grafik dan melihat properti, tetangga, dan koneksi. Gambar berikut menunjukkan properti, tetangga, dan koneksi.

Visualisasi hasil kueri.

Memvisualisasikan skema Grafik BigQuery

Struktur grafik, termasuk node, edge, label, dan propertinya, ditentukan oleh skemanya, yang memetakan data dalam tabel BigQuery ke elemen grafik. Definisi grafik disimpan dalam skema yang Anda buat menggunakan tabel input.

Anda dapat memvisualisasikan grafik yang Anda buat dengan skema. Memvisualisasikan skema membantu Anda memahami struktur grafik, termasuk jenis node dan edge yang dikandungnya serta koneksinya. Hal ini dapat berguna untuk grafik yang kompleks karena memberikan tampilan yang jelas tentang hubungan yang mungkin sulit disimpulkan dari pernyataan DDL yang Anda gunakan untuk membuat grafik. Gambar berikut menunjukkan contoh visualisasi skema grafik.

Visualisasi skema grafik.

Untuk melihat visualisasi skema BigQuery Graph di notebook, ikuti langkah-langkah berikut:

  1. Di sel notebook, jalankan perintah berikut untuk menginstal library magic BigQuery:

    !pip install bigquery_magics==0.12.1

  2. Di lingkungan notebook, pastikan Anda telah menginstal library klien BigQuery Graph.

  3. Di sel notebook, gunakan perintah magic %%bigquery --graph yang diikuti dengan kueri GQL Anda. Kueri harus menampilkan elemen grafik dalam format JSON menggunakan fungsi TO_JSON.

  4. Jalankan sel. Visualisasi ditampilkan di area output sel.

  5. Di output visualisasi, klik schema Tampilan skema.

Memecahkan masalah visualisasi Grafik BigQuery

Informasi berikut dapat membantu Anda memecahkan masalah dan memahami masalah serta perilaku visualisasi Grafik BigQuery.

Visualisasi tidak muncul untuk kueri Grafik BigQuery

Masalah: Anda menjalankan kueri Grafik BigQuery, tetapi kueri tersebut hanya muncul dalam format tabel.

Kemungkinan penyebab: Kueri tidak menampilkan elemen grafik dalam format JSON.

Misalnya, kueri berikut tidak dapat divisualisasikan karena menampilkan nilai properti, bukan elemen grafik dalam format JSON:

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

Solusi:

Menampilkan elemen grafik dalam format JSON menggunakan TO_JSON. Untuk informasi selengkapnya, lihat Memvisualisasikan hasil kueri BigQuery Graph.

Hasil kueri BigQuery Graph divisualisasikan sebagian

Masalah: Visualisasi hasil kueri hanya menampilkan sebagian hasil kueri.

Kemungkinan penyebab: Kueri menampilkan lebih dari 2 MB data. Visualisasi kueri dapat menampilkan data maksimum 2 MB.

Solusi: Sederhanakan kueri untuk menampilkan data kurang dari 2 MB.

Beberapa elemen grafik tidak ditampilkan dalam visualisasi Grafik BigQuery

Masalah: Visualisasi mencakup semua node dan tepi yang ditampilkan, tetapi beberapa elemen grafik tidak ditampilkan.

Kemungkinan penyebab: Kueri yang digunakan untuk membuat visualisasi Grafik BigQuery menampilkan node dan tepi individual, bukan jalur grafik.

Solusi: Perbarui kueri untuk menampilkan jalur grafik.

Langkah berikutnya