Conversational Analytics API 已知限制

Conversational Analytics API 在資料來源數量、圖表樣式和資料集大小方面,有下列已知限制。

資料來源限制

本節說明您連線及查詢 Looker 和資料庫來源 (PostgreSQL 適用的 AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner) 時,對話式數據分析 API 的限制和行為。

Looker 資料來源限制

連結至 Looker 資料來源時,請注意下列事項:

  • 您可以在對話中查詢任何包含的探索。
  • 代理程式一次只能查詢一個 Explore。您無法同時查詢多個探索。
  • 在同一場對話中,代理程式可以查詢多個探索。
  • 在包含多個問題的對話中,或在包含後續問題的對話中,代理程式可以查詢多個探索。

    舉例來說,使用者連結了兩個「探索」,分別名為 cat-exploredog-explore。使用者輸入「貓的數量比較多還是狗的數量比較多?」這個問題,這會建立兩項查詢:一項用於計算 cat-explore 中的貓隻數量,另一項則用於計算 dog-explore 中的狗隻數量。代理程式完成兩項查詢後,會比較兩項查詢的結果。

  • QueryData 方法不支援 BigQuery 或 Looker 資料來源。

資料庫資料來源限制

連線至 AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 或 Spanner 資料來源時,請注意下列事項:

  • 資料代理程式會使用與資料代理程式互動的使用者憑證存取資料。如果使用者存取共用的資料代理程式,但無權存取代理程式設定的資料表,則資料代理程式無法存取這些資料表。

  • 資料代理的資料表選取畫面會引導代理,瞭解要著重使用的資料表。選取表格並非安全性設定,即使您指定資料來源只能從特定資料表 (例如 table1table2) 擷取資訊,如果執行查詢的使用者具有一般權限,可查看相同資料庫中 table3 的內容,系統仍可能會從非預期資料表 (table3) 傳回資料。

圖表限制

支援的視覺化類型如下:

  • 長條圖
  • Geoshape
  • 熱視圖
  • 折線 (時間序列)
  • 圓餅圖
  • 散布圖

資料處理限制

  • 如果是 Looker 資料來源,對話式數據分析 API 每個查詢最多可傳回 5,000 列
  • 如果是 BigQuery 資料來源,對話式數據分析 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 資源,CMEK 僅支援 Looker 資料來源。
  • 如果數據分析資料來源已停用在報表中編輯欄位,對話式數據分析 API 就無法正常運作,因為這項設定會禁止對話式數據分析建立計算結果欄位。
  • 如果查詢驗證或執行期間發生失敗情形,Conversation Analytics API 可能會自動重試作業,方法是產生修正後的查詢。每個要求最多會重試三次。

    如果查詢因權限或驗證問題而失敗,對話式數據分析 API 不會重試查詢。重試次數不確定;如果錯誤訊息指出查詢無法復原,即使查詢仍低於每個要求三個錯誤的限制,API 也不會再次嘗試查詢。

配額限制

  • 對話式數據分析 API 的整體要求 (包括即時通訊和非即時通訊要求) 設有下列限制:
    • 每項專案每秒最多可執行 10 次查詢 (每秒查詢次數),也就是每分鐘 600 次查詢。
    • 每位使用者每個專案的最高速率為 10 QPS,也就是 600 QPM。
  • 但即時通訊要求有更嚴格的限制:
    • 每個專案的速率上限為每分鐘 30 次查詢。
    • 每位使用者每項專案的 QPM 上限為 30。
  • AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner 的對話式數據分析 API,每個專案的 QPM 限制為 50。如要提高這些限制,請洽詢 Google Cloud 客戶服務

問題類型限制

  • 對話式數據分析 API 支援可透過單一視覺化內容回答的問題,例如:

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

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