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