對話式數據分析 API 對資料來源數量、圖表樣式和資料集大小有下列已知限制。
資料來源限制
本節說明對話式數據分析 API 在連線及查詢 BigQuery、Looker 和資料庫來源 (AlloyDB for PostgreSQL、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner) 時的限制和行為。
Looker 資料來源限制
連結至 Looker 資料來源時,請注意下列事項:
- 您可以在對話中查詢任何納入的探索。
- 代理一次只能查詢一個探索。無法同時在多個探索中執行查詢。
- 代理可以在同一對話中查詢多個探索。
在包含多個部分的問題或後續問題的對話中,代理可以查詢多個探索。
舉例來說,使用者連結了兩個探索,分別名為
cat-explore和dog-explore。使用者輸入問題:「貓和狗哪個比較多?」這會建立兩項查詢:一項用於計算cat-explore中的貓咪數量,另一項用於計算dog-explore中的狗狗數量。代理完成兩項查詢後,會比較兩者的數字。QueryData方法不支援 BigQuery 或 Looker 資料來源。
資料庫資料來源限制
連結至 AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 或 Spanner 資料來源時,請考量下列事項:
資料代理會使用與其互動的使用者憑證存取資料。如果使用者存取共用資料代理,但無權存取代理設定的資料表,則資料代理無法存取這些資料表。
為資料代理選取資料表,可引導代理著重於哪些資料表。資料表選取並非安全性設定。即使您指定資料來源只能從特定資料表 (例如
table1和table2) 提取資訊,如果執行查詢的使用者具備一般權限,可查看同一資料庫中table3的內容,系統仍可能傳回非預期資料表 (table3) 的資料。
BigQuery 搜尋範圍限制
使用搜尋範圍,讓對話式數據分析 API 選擇要查詢的 BigQuery 資料表時,須遵守下列限制:
- 搜尋範圍只能用於含有內嵌內容的無狀態對話要求。永久資料代理或使用對話參照的有狀態對話要求,不支援搜尋範圍。
- 最多可指定 100 個資料集和 100 項專案。
詳情請參閱「連結至 BigQuery 資料集和專案」。
圖表限制
支援的圖表類型包括:
- 區
- 長條圖
- Geoshape
- 熱視圖
- 折線圖 (時間序列)
- 圓餅圖
- 散布圖
資料處理限制
- 如果是 Looker 資料來源,對話式數據分析 API 每次查詢最多可傳回 5,000 列。
- 如果是 BigQuery 資料來源,Conversational Analytics API 會將資料查詢限制為 500 GB 的處理位元組。
- 如果是 AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner 資料來源,對話式數據分析 API 每次查詢最多可傳回 1,000 列。
- 對話式數據分析 API 採用 Python 推論和內容擷取功能,可處理時間複雜度高達
O(100k)列的資料。 - 查詢大量資料可能會降低資料代理的推論準確度。
- 對話式數據分析 API 的輸出長度上限為 8,192 個詞元。查詢大量資料時,可能會傳回
MAX_TOKENS錯誤。 - 系統訊息
DataResult欄位中傳回的資料有大小限制。資料結果會截斷至最多 3,000,000 個位元組。這項截斷程序會在這個大小限制內,盡可能保留完整資料列。
查詢限制
- 不支援 BigQuery 的彈性資料欄名稱功能。
- BigQuery 支援結構體,但有時可能會失敗。
- 如果是 Looker 資料來源,API 無法設定使用 LookML
parameter參數定義的篩選器限定欄位值。 - 如果 Looker (Google Cloud Core) 執行個體位於 VPC Service Controls 範圍內,則不支援使用對話式數據分析 API,透過數據分析 Pro 連線至私人 IP Looker (Google Cloud Core) 執行個體,且不符合 VPC Service Controls 法規遵循要求。
- 如果連線至採用私人 IP 設定的 Looker (Google Cloud Core) 執行個體,對話式數據分析 API 不支援設為使用 CMEK 或 VPC Service Controls 的 Looker (Google Cloud Core) 執行個體。
- 如果數據分析資料來源停用了報表中的欄位編輯功能,對話式數據分析 API 就無法正常運作,因為這項設定會導致對話式數據分析無法建立計算結果欄位。
查詢驗證或執行期間發生失敗時,對話式數據分析 API 可能會產生修正後的查詢,自動重試作業。每項要求最多會嘗試重試三次。
如果查詢因權限或驗證問題而失敗,對話式數據分析 API 不會重試查詢。重試次數不確定;如果錯誤訊息指出查詢無法復原,對話式數據分析 API 就不會再次嘗試查詢,即使查詢仍低於每項要求三次錯誤的限制。
配額限制
- 對話式數據分析 API 對整體要求 (包括對話和非對話要求) 有下列限制:
- 每個專案每秒最多 30 次查詢 (QPS),即每分鐘 1,800 次查詢 (QPM)。
- 每位使用者在每項專案的速率上限為 10 QPS,即 600 QPM。
- 不過,即時通訊要求有更嚴格的限制:
- 每個專案中,每個代理的代理對代理 (A2A) 要求速率上限為 100 QPM。內建代理各有專屬限制,自訂資料代理則共用每項專案 100 QPM 的限制。
- AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner 的對話式數據分析 API,每項專案的 QPM 限制為 50。如要提高這些限制,請與 Google Cloud 客戶服務 團隊聯絡。
問題類型限制
對話式數據分析 API 支援可透過單一圖表回答的問題,例如:
- 指標趨勢
- 指標的各維度細目或分布
- 一或多個維度的不重複值
- 單一指標值
- 按照指標呈現前幾名的維度值
對話式數據分析 API 尚不支援只能透過下列複雜圖表回答的問題:
- 預測
- 進階統計分析,包括關聯性和異常偵測