Conversational Analytics API 已知限制

對話式數據分析 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。
  • 不過,即時通訊要求有更嚴格的限制:
    • 每項專案每分鐘最多 30 次查詢。
    • 每位使用者每項專案每分鐘最多 30 次查詢。
    • 每項聊天要求會計為 8 個配額單位,而非標準的 1 個單位。因此, Google Cloud 控制台的「配額」頁面顯示的限制,會是實際要求限制的 8 倍。舉例來說,240 個單位的限制代表 30 個即時通訊要求。
  • 每個專案中,每個代理的代理對代理 (A2A) 要求速率上限為 100 QPM。內建代理各有專屬限制,自訂資料代理則共用每項專案 100 QPM 的限制。
  • AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner 的對話式數據分析 API,每項專案的 QPM 限制為 50。如要提高這些限制,請與 Google Cloud 客戶服務 團隊聯絡。

問題類型限制

  • 對話式數據分析 API 支援可透過單一圖表回答的問題,例如:

    • 指標趨勢
    • 指標的各維度細目或分布
    • 一或多個維度的不重複值
    • 單一指標值
    • 按照指標呈現前幾名的維度值
  • 對話式數據分析 API 尚不支援只能透過下列複雜圖表回答的問題:

    • 預測
    • 進階統計分析,包括關聯性和異常偵測