為了幫助確保一致的性能，Wdata 的功能和開發人員應用程式設計介面 (API) 支援自訂整合以將您的資料與 Workiva 平台連接，—實施了若干限制。
雖然這些條件約束為工作區提供了邊界，但我們建議您盡可能自行限制資料集的數量。其他資料集對處理時間具有串聯效應，在接近這些限制或執行特別複雜的查詢時，您可能會注意到效能降低。
表格、查詢、視圖和鏈結
Wdata 對表格、查詢、視圖和鏈結強制實施許多功能限制。
表格
| 功能 | 限制 |
|---|---|
| 檔案上傳 |
建議檔案大小：不超過 300 MB 最大檔案大小：1 GB 檔案格式：CSV 或 TSV 附註： ZIP 檔案可用於減少上傳大小，但不會導致查詢效能改善。 |
| 每個表格的欄數 | 150 |
| 事實資料表 | 10 億列 |
| 維度資料表 |
建議：不超過 100 萬列 最大值：200 萬列 |
| 每個試算表的連線數 | 300 個傳入和 300 個傳出 |
| 標籤值 |
最大：300 建議您不要新增額外的標籤值，而是要建立單獨的查詢表或使用查詢在試算表中建立聯結表。 |
查詢
| 功能 | 限制 |
|---|---|
| 每個查詢的參數量 | 30 |
| 查詢參數名稱 | 256 個字元 |
| 每個參數挑選清單的項目數 | 512 |
| 查詢 SQL 編輯器陳述式 | 30,000 個字元 |
| 每份試算表、文件或簡報的已連結查詢 | 100 |
| 每個試算表的儲存格數量 | 2,000,000 |
SQL 編輯器的 UNION 運算符數 |
20 |
檢視
| 功能 | 限制 |
|---|---|
| 每個視圖的查詢列數 | 1,000,000 |
附註: 嘗試加入 LIMIT 子句以減少查詢大小。
鏈結 (Chains)
| 功能 | 限制 |
|---|---|
| 連線 | 解決方案訂閱提供一個；企業版提供五個。要購買額外連線，請聯絡您的客戶成功經理。 |
| 變數 | 我們不再強制執行限制，但觀察到當變數鏈接近 1000+ 的範圍時，應用程式的回應能力會降低。 |
| 通知 |
外寄電子郵件上限為 40MB 附註： 此傳送限制並不影響某些第三方提供者設定的接收限制。 |
API 頻率限制
以下的速率限制是在工作區層級執行，而不是以每位使用者為基礎。若超過這些限制，您會收到錯誤回應，其狀態代碼為 429 要求次數過多。
您也應該注意，API 將任何要求的長度限制為 10 分鐘。
注意: API 可能會根據當前系統負載或過高頻率額外限制您的請求。尤其是頻寬密集的執行，例如在短時間內在大型資料集上執行，可能會產生些微延遲，以確保系統保持效能。
管理工作
| 要求 | 每個工作區的每分鐘限制 |
| 刪除一個單一工作區 | 5 |
| 匯出一個單一工作區 | 5 |
| 匯入資料 | 5 |
| 按大小擷取 Workspace 檔案 | 10 |
| 擷取 Workspace 查詢使用情況 | 55 |
| 擷取 Workspace 上傳使用情況 | 50 |
| 驗證檔案 | 5 |
| 驗證表格 | 5 |
鏈結
每日和短期限制均適用於 API。
限制：
- 24 小時內向 API 發出 50,000 個要求
- 20 秒內 100 個要求的高載限制
連線管理
| 要求 | 每個工作區的每分鐘限制 |
| 取得連線詳細資料 | 515 |
| 列出連線 | 2000 |
| 重新整理連線 | 203 |
| 批次重新整理連線 | 20 |
| 取得批次刷新的狀態 | 1000 |
| 取得重新整理連線狀態 | 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 |
| 匯入一個單一檔案 | 50 |
| 取消匯入單一檔案 | 170 |
| 擷取匯入資訊 | 50 |
| 從試算表匯入 | 10 |
標籤管理
| 要求 | 每個工作區的每分鐘限制 |
| 擷取一個標籤清單 | 50 |
| 新建一個標籤 | 10 |
| 刪除一個單一標籤 | 10 |
| 更新單一標籤 | 10 |
權仗管理
| 要求 | 每個工作區的每分鐘限制 |
| 新建一個權杖 | 150 |
公用程式
| 要求 | 每個工作區的每分鐘限制 |
| 剖析日期 | 10 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
儲存空間和查詢限制
API 目前按訂閱層級限制生命週期儲存和年度查詢的大小。這些限制基於掃描的總位元組數，而不是查詢建立之結果的大小。工作區擁有者可以追蹤其使用方式，以驗證其組織是否仍在限制範圍內。
| 訂閱 | 終身儲存空間 | 年度查詢 |
|---|---|---|
| 解決方案 | 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 呼叫會使用傳輸層安全性 (TLS) 1.3；進階加密標準 (AES) 256 待用。