Memvisualisasikan grafik

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

Visualisasi Grafik BigQuery menampilkan hasil yang ditampilkan oleh kueri skema grafik. Anda dapat memvisualisasikan grafik di BigQuery Studio, atau lingkungan notebook, seperti 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 BigQuery Graph

Anda dapat menggunakan konsol Google Cloud untuk memvisualisasikan hasil kueri BigQuery Graph di BigQuery Studio. Untuk memvisualisasikan kueri dengan Grafik BigQuery, kueri harus menampilkan elemen grafik dalam format JSON menggunakan fungsi TO_JSON. Sebaiknya kembalikan jalur grafik, bukan mengembalikan node dan tepi secara terpisah. Mengembalikan jalur menawarkan manfaat berikut:

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

  • Jika Anda menampilkan jalur, pernyataan RETURN Anda bisa kurang kompleks daripada jika Anda menampilkan node dan tepi secara terpisah.

Contoh kueri berikut menampilkan jalur transfer akun, yang dapat Anda visualisasikan:

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;

Untuk memvisualisasikan hasil, di panel Query results, klik Graph. 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. Atau, Anda dapat melihat hasil kueri sebagai tabel atau beralih ke visualisasi skema grafik pokok.

Visualisasi hasil kueri.

Untuk mengetahui informasi selengkapnya, lihat Mengembalikan elemen grafik sebagai JSON.

Memilih opsi visualisasi hasil kueri

Anda dapat memperbarui tampilan node dalam visualisasi kueri. Misalnya, Anda dapat menentukan tata letak visualisasi kueri, warna node, dan properti yang muncul di setiap node.

Pembaruan tampilan hasil kueri ditujukan untuk sesi visualisasi hasil kueri saat ini. Perubahan pada opsi visualisasi Anda tidak akan tetap ada jika Anda menjalankan kueri yang sama lagi.

Memilih tata letak untuk visualisasi Grafik BigQuery

Menu di panel visualisasi menyediakan opsi tata letak berikut:

  • Tata letak paksa (default): Menampilkan node sebagai titik yang saling menolak, sementara node yang terhubung saling menarik, mensimulasikan gaya fisik untuk membuat tata letak yang intuitif secara visual.

  • Hierarkis: Memosisikan node untuk membuat hierarki visual berdasarkan konektivitas.

  • Berurutan: Memosisikan node untuk membuat urutan visual berdasarkan konektivitas.

  • Tampilkan label: Menampilkan semua label node dan tepi pada grafik di semua tingkat zoom.

Memilih properti node atau tepi yang akan ditampilkan

Secara default, node atau tepi menampilkan properti pertamanya. Jika Anda ingin node atau tepi menampilkan properti yang berbeda, lakukan hal berikut:

  1. Saat Anda melihat visualisasi hasil kueri Grafik BigQuery, klik Beralih ke tampilan skema di tab Hasil pada panel hasil kueri.

    Tombol beralih ke tampilan skema.

  2. Dalam visualisasi skema, klik node atau tepi jenis yang ingin Anda perbarui.

  3. Di panel detail yang muncul untuk node atau tepi yang dipilih, klik properti yang ingin Anda tampilkan. Semua node atau tepi dalam hasil kueri Anda yang berjenis node atau tepi yang Anda pilih akan menampilkan properti yang Anda pilih.

Memilih warna node

  1. Saat Anda melihat visualisasi hasil kueri Grafik BigQuery, klik Beralih ke tampilan skema di tab Hasil pada panel hasil kueri.

  2. Dalam visualisasi skema, klik node jenis yang ingin Anda perbarui.

  3. Di panel detail yang muncul untuk node yang dipilih, klik Opsi tampilan node.

  4. Klik warna. Semua node dalam hasil kueri yang berjenis node yang Anda pilih akan ditampilkan dengan warna yang Anda pilih.

Memilih node yang ditampilkan

Untuk memilih node yang ditampilkan dalam visualisasi, lakukan hal berikut:

  1. Di visualisasi kueri, klik kanan node.

  2. Klik salah satu opsi menu berikut untuk mengubah status grafik yang terlihat:

    • Perluas merender node yang berdekatan dengan melintasi semua tepi masuk, tepi keluar, atau memfilter menurut jenis tepi tertentu.

    • Ciutkan memangkas tampilan saat ini dengan menyembunyikan semua node yang terhubung ke node target menggunakan tepi masuk, tepi keluar, atau jenis tepi tertentu.

    • Sembunyikan node menghapus node target dari tampilan saat ini.

    • Tampilkan hanya tetangga menyembunyikan semua node dalam grafik kecuali node target dan node yang terhubung langsung dengannya.

    • Highlight node menandai node target.

Memvisualisasikan skema Grafik BigQuery

Struktur grafik, termasuk node, edge, label, dan propertinya, ditentukan oleh skemanya, yang memetakan elemen grafik ke data dalam tabel BigQuery. 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 tepi yang dikandungnya serta cara menghubungkannya. Hal ini dapat berguna untuk grafik yang kompleks, memberikan tampilan yang jelas tentang hubungan yang mungkin sulit disimpulkan hanya dari pernyataan DDL.

Untuk memvisualisasikan skema grafik, ikuti langkah-langkah berikut:

  1. Di BigQuery Studio, buka panel Explorer.
  2. Luaskan set data yang berisi grafik Anda, luaskan Grafik, lalu pilih grafik Anda.
  3. Klik tab Grafik.

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 transfer antar-akun, lalu menampilkan hasilnya dalam notebook:

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

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 BigQuery Graph

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: Jika Anda menggunakan visualisasi notebook, kueri menampilkan lebih dari 2 MB data. Visualisasi notebook memiliki batas 2 MB, sedangkan visualisasi konsol tidak memiliki batas pasti.Google Cloud

Solusi: Jika Anda menggunakan notebook, sederhanakan kueri untuk menampilkan data kurang dari 2 MB, atau gunakan konsol Google Cloud untuk memvisualisasikan hasilnya.

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