以圖表呈現
如要尋求支援或針對這項功能提供意見回饋，請傳送電子郵件至 bq-graph-preview-support@google.com。
BigQuery 圖表視覺化會顯示查詢傳回的圖表元素，或圖表結構定義的元素。您可以在筆記本環境中以視覺化方式呈現圖表，例如 BigQuery Studio、Google Colab 或 Jupyter Notebook。
視覺化呈現可協助您瞭解資料點 (節點) 的連結方式 (邊緣)。數百個資料點的表格可能難以解讀，但圖表視覺化功能可以顯示模式、依附元件和異常狀況。
在筆記本環境中以視覺化方式呈現查詢結果和結構定義
您可以在筆記本環境 (例如 BigQuery Studio、Google Colab 和 Jupyter Notebook) 中，以視覺化方式呈現圖形查詢結果和圖形結構定義。視覺化效果會以 IPython Magics 的形式導入。
以視覺化方式呈現圖形查詢結果
如要在筆記本中以視覺化方式呈現查詢結果，請按照下列步驟操作：
在筆記本儲存格中執行下列指令，安裝最新的 BigQuery 神奇指令程式庫：
!pip install bigquery_magics==0.12.1在筆記本環境中，請確認已安裝 BigQuery Graph 用戶端程式庫。
在筆記本儲存格中，使用
%%bigquery --graph魔法指令，然後輸入 GQL 查詢。查詢必須使用TO_JSON函式，以 JSON 格式傳回圖形元素。建議您傳回圖形路徑，而非個別節點和邊緣。傳回路徑有下列好處：路徑包含節點和邊緣的完整資料。如果傳回個別節點和邊緣，複雜查詢的視覺化可能不會顯示部分中間節點和邊緣。
如果傳回路徑，
RETURN陳述式會比傳回個別節點和邊緣簡單。
執行儲存格。視覺化內容會顯示在儲存格的輸出區域。
下列範例查詢會找出某人、其帳戶和已償還的貸款，然後在筆記本中傳回結果：
%%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;
執行查詢後，輸出區域會顯示視覺化圖表。詳細資料面板會顯示節點和邊緣標籤的摘要，以及每個標籤的計數。按一下節點或邊緣，即可瀏覽圖表並查看屬性、鄰居和連線。下圖顯示屬性、鄰居和連線。
將 BigQuery 圖表結構定義視覺化
圖表的結構 (包括節點、邊緣、標籤和屬性) 是由結構定義所定義，該結構定義會將 BigQuery 資料表中的資料對應至圖表元素。圖表定義會儲存在您使用輸入資料表建立的結構定義中。
您可以將使用結構定義建立的圖表視覺化。將結構定義視覺化，有助於瞭解圖譜的結構，包括所含節點和邊緣的類型，以及這些節點和邊緣之間的連結。這項功能有助於瞭解複雜的圖表，因為您可清楚查看關係，而這些關係可能難以從用於建立圖表的 DDL 陳述式推斷。下圖顯示圖表結構定義的視覺化範例。
如要在筆記本中查看 BigQuery 圖表結構定義的視覺化呈現方式，請按照下列步驟操作：
在筆記本儲存格中執行下列指令，安裝 BigQuery Magic 程式庫：
!pip install bigquery_magics==0.12.1在筆記本環境中，請確認已安裝 BigQuery Graph 用戶端程式庫。
在筆記本儲存格中，使用
%%bigquery --graph魔法指令，然後輸入 GQL 查詢。查詢必須使用TO_JSON函式，以 JSON 格式傳回圖形元素。執行儲存格。視覺化內容會顯示在儲存格的輸出區域。
在視覺化輸出內容中，按一下「結構定義」 結構定義檢視畫面。
排解 BigQuery 圖表視覺化問題
下列資訊有助於排解及瞭解 BigQuery 圖表視覺化問題和行為。
BigQuery 圖形查詢未顯示視覺化效果
問題：您執行 BigQuery 圖表查詢，但系統只以表格格式顯示查詢結果。
可能原因：查詢未以 JSON 格式傳回圖表元素。
舉例來說，下列查詢會傳回屬性值，而非 JSON 格式的圖表元素，因此無法產生視覺化結果：
GRAPH graph_db.FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name;
解決方法：
使用 TO_JSON 以 JSON 格式傳回圖表元素。詳情請參閱「將 BigQuery 圖形查詢結果視覺化」一文。
BigQuery Graph 查詢結果會以部分視覺化方式呈現
問題：查詢結果的視覺化圖表只顯示部分查詢結果。
可能原因：查詢傳回的資料超過 2 MB。查詢資料的視覺化效果最多可顯示 2 MB 的資料。
解決方法：簡化查詢，讓傳回的資料量少於 2 MB。
BigQuery 圖表視覺化畫面不會顯示部分圖表元素
問題：視覺化內容包含所有傳回的節點和邊緣，但部分圖表元素未顯示。
可能原因：用於建立 BigQuery 圖表視覺化效果的查詢會傳回個別節點和邊緣，而非圖表路徑。
解決方法：更新查詢，傳回圖表路徑。
後續步驟
- 進一步瞭解 BigQuery Graph。
- 瞭解如何建立及查詢圖表。
- 瞭解圖形視覺化工具和整合。