Conversational Analytics API 已知限制

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 次查詢。
  • 但即時通訊要求有更嚴格的限制:
    • 每個專案的速率上限為每分鐘 30 次查詢。
    • 每位使用者每項專案的最高速率為 30 QPM。
    • 每次聊天要求會計為 8 個配額單位,而非標準的 1 個單位。因此, Google Cloud 控制台的「配額」頁面會顯示實際要求限制的 8 倍。舉例來說,240 個單位的上限代表 30 個即時通訊要求。
  • 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 目前不支援只能透過下列複雜圖表類型回答的問題:

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