為了幫助確保一致的性能，Wdata 的功能和開發人員應用程式設計介面 (API) 支援自訂整合以將您的資料與 Workiva 平台連接，—實施了若干限制。
雖然這些限制為您的 Workspace 提供了界限，但我們建議您盡可能自行限制資料集的數量。其他資料集會對處理時間產生串聯影響，當接近這些上限或運行特別複雜的查詢時，您可能會注意到性能下降。
表格、查詢、檢視和鏈
Wdata 對表格、查詢、檢視和鏈實施了許多功能限制。
表格
| 功能 | 限制 |
|---|---|
| 檔案上傳 |
推薦檔案大小： 300 MB 或更少 最大檔案大小：1 GB 檔案格式： CSV 或 TSV 備註： ZIP 檔案可用於減小上傳大小，但不會提高查詢性能。 |
| 每個表格的欄數 | 150 |
| 事實表 | 10 億列 |
| 維度表 |
推薦： 100 萬列或更少 最大： 200 萬列 |
| 每份試算表的已連結資料集 | 100 |
| 標籤值 |
最大： 300 我們建議不要新增額外的標籤值，而是建立單獨的查找表或使用查詢在電子試算表中建立連接表。 |
查詢
| 功能 | 限制 |
|---|---|
| 每個查詢的參數量 | 30 |
| 查詢參數名稱 | 256 個字元 |
| 每個參數挑選清單的項目數 | 512 |
| 查詢 SQL 編輯器陳述式 | 30,000 個字元 |
| 每份試算表、文件或簡報的已連結查詢 | 100 |
| 每個試算表的儲存格數量 | 2,000,000 |
SQL 編輯器的 UNION 運算符數 |
20 |
視圖
| 功能 | 限制 |
|---|---|
| 每個視圖的查詢列數 | 1,000,000 |
鏈結
| 功能 | 限制 |
|---|---|
| 連線 | 解決方案訂閱提供一個，企業版提供五個。若要購買額外連線，請聯絡您的客戶成功經理。 |
| 變數 | 每個鏈結 100 |
API 頻率限制
API 可能會根據目前的系統負載或頻率過高來限制您要求的速率。 若超過這些限制，您會收到錯誤回應，其狀態代碼為 429 要求次數過多。
您也應該注意，API 將任何要求的長度限制為 10 分鐘。
管理工作
| 要求 | 每個工作區每分鐘的限制 |
| 刪除一個單一工作區 | 5 |
| 匯出一個單一工作區 | 5 |
| 匯入資料 | 5 |
| 按大小擷取 Workspace 檔案 | 10 |
| 擷取 Workspace 查詢使用情況 | 55 |
| 擷取 Workspace 上傳使用情況 | 50 |
| 驗證檔案 | 5 |
| 驗證表格 | 5 |
鏈結
每日和短期限制均適用於 API。
限制：
- 24 小時內 50,000 個 API 要求
- 20 秒內 100 個要求的突發限制
連接管理
| 要求 | 每個工作區每分鐘的限制 |
| 重新整理連線 | 200 |
| 重新整理一批連線 | 1 |
| 獲取刷新連接狀態 | 1000 |
檔案管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取一個檔案清單 | 650 |
| 上傳一個單一檔案 | 50 |
| 刪除一個單一檔案 | 50 |
| 擷取一個單一檔案 | 150 |
| 下載一個單一檔案 | 50 |
| 擷取錯誤 | 20 |
| 將一個檔案匯出到試算表 | 5 |
資料夾管理
| 要求 | 每個工作區每分鐘的限制 |
| 搜尋 | 150 |
| 擷取一個資料夾清單 | 150 |
| 新建一個資料夾 | 150 |
| 刪除一個單一資料夾 | 150 |
| 擷取一個單一資料夾 | 150 |
| 更新一個單一資料夾 | 150 |
| 擷取一個資料夾內容清單 | 150 |
| 將內容移動到一個資料夾中 | 150 |
參數管理
| 要求 | 每個工作區每分鐘的限制 |
| 獲取參數 | 50 |
| 建立參數 | 10 |
| 刪除參數 | 50 |
| 取得參數 | 10 |
| 更新參數 | 10 |
透視表管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取一個樞紐分析檢視清單 | 50 |
| 新建一個樞紐分析檢視 | 10 |
| 刪除一個單一樞紐分析檢視 | 50 |
| 擷取一個單一樞紐分析檢視 | 50 |
| 更新一個單一樞紐分析檢視 | 10 |
查詢管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取查詢清單 | 192 |
| 新建一個查詢 | 57 |
| 擷取查詢欄資料 | 255 |
| 剖析查詢以確定它是否有效 | 255 |
| 刪除一個單一查詢 | 150 |
| 擷取一個單一查詢 | 1139 |
| 更新一個單一查詢 | 93 |
| 擷取依存性 | 10 |
| 擷取一個依存清單 | 60 |
| 擷取一個查詢結果清單 | 39 |
| 執行一個查詢 | 400 |
| 取消一個正在運行的查詢 | 25 |
| 擷取一個單一查詢結果 | 1200 |
| 下載一個查詢結果 | 100 |
| 將查詢結果匯出為試算表 | 400 |
選擇清單管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取選取清單的其中一個清單 | 10 |
| 新建一個選取清單 | 36 |
| 刪除一個單一選取清單 | 10 |
| 擷取一個單一清單 | 108 |
| 更新一個單一選取清單 | 12 |
共享表格管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取一個共用表格清單 | 90 |
| 新建一個共用表格 | 8 |
| 刪除一個單一共用表格 | 10 |
| 擷取一個單一共用表格 | 366 |
表格管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取一個表格清單 | 220 |
| 新建一個表格 | 100 |
| 刪除一個單一表格 | 45 |
| 擷取一個單一表格 | 700 |
| 更新一個單一表格 | 25 |
| 擷取一個依存清單 | 60 |
| 匯入一個單一檔案 | 30 |
| 取消匯入單一檔案 | 170 |
| 擷取匯入資訊 | 50 |
| 從試算表匯入 | 10 |
標籤管理
| 要求 | 每個工作區每分鐘的限制 |
| 擷取一個標籤清單 | 50 |
| 新建一個標籤 | 10 |
| 刪除一個單一標籤 | 10 |
| 更新單一標籤 | 10 |
代幣管理
| 要求 | 每個工作區每分鐘的限制 |
| 新建一個權杖 | 150 |
公用程式
| 要求 | 每個工作區每分鐘的限制 |
| 剖析日期 | 10 |
儲存空間和查詢限制
該 API 目前會按您的訂閱級別限制終身儲存空間和年度查詢的大小。這些限制是根據掃描的總位元數，而不是您的查詢所建立結果的大小。Workspace 所有者可以追蹤他們的使用情況，以驗證他們的組織是否在這些限制範圍內。
| 訂閱 | 終身儲存空間 | 年度查詢 |
|---|---|---|
| 解決方按 | 100GB | 120TB |
| 企業 | 500GB | 3,000TB |
實際上，五年內僅 1GB 的儲存空間就可以包含 800 萬條記錄，包括：
- 每月實際切割 10 個維度
- 每月滾動12個月預測
- 預算資料
我們建議您根據儲存空間或查詢需求選擇訂閱層級。例如：
- 使用解決方案訂閱，您每年可以查詢含有 100 GB 資料的表格共 1,200 次；或含有 50 GB 資料的表格共 2,400 次。
- 使用企業版訂閱，您則會獲得 3,000 TB 的查詢上限，讓您每年可以查詢資料 300 萬次。
若要購買額外的終身儲存空間，請聯絡您的帳戶擁有者或客戶成功經理。
注意：這些是固定上限，這意味著一旦達到上限，未來的匯入或查詢將無法完成。例如，您將無法將資料集匯入到超出儲存上限的表格中，並且一旦超出查詢上限，Wdata 查詢就會失敗。
逾時
Workiva Wdata API 目前將任何要求的長度限制為 10 分鐘。
請注意，逾時情況可能因您連接的 Workiva API 而有所不同。在Workiva 開發人員中心深入瞭解。
承載大小
Workiva API 將任何要求的大小限制為最大 10485760 個位元組 (10MB)。這是對所有 Workiva API 的設定限制。
加密
為確保資料隱私和完整性，API 呼叫使用傳輸層安全性 (Transport Layer Security, TLS) 1.3；靜態時，則使用進階加密標準 (Advanced Encryption Standard, AES) 256。