概念:WQL 查詢結果的分頁
首次執行查詢時,查詢參數中的Workday查詢語言 (WQL) 會執行並建置傳回最多 10,000 列的快取。結果可以使用
limit
與offset
在 WQL 查詢的REST API呼叫中加入 參數。WQL 只會在使用者階段階段作業 () 快取頁面限制要求,最長 30 分鐘。
若要檢視其餘結果,請使用以下參數:
參數 | 說明 |
|---|---|
limit
| 指定 1 頁結果中的列數。值必須介於 0 到 10,000 之間。 |
offset
| 指定結果集的起始列。用於 limit 參數。
在初始要求, 申請中取得第一頁結果時,請省略 offset 參數,或將其設為零。 |
Workday 會保留關鍵字
LIMIT
同時適用於子句和分頁參數。LIMIT 關鍵字不區分大小寫。我們使用大小寫字母來區分子句和分頁參數。
- 使用LIMIT子句以限制查詢回應中傳回的總列數。
- 使用limit參數,以指定在查詢回應的每頁顯示多少列。
範例
根據您提出 WQL 要求的來源,您使用的基本 URL 會有所不同。
WQL 要求來源
| 使用的基本 URL
|
|---|---|
Workday用戶自訂斜槓專案總召 | https://{hostname}/api/wql/{version}/{tenant}
|
WCP API閘道 | https://api.workday.com/wql/{version}
|
若要從結果集的第一列傳回 1,000 列,請執行以下操作︰
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
若要傳回接下來的 1,000 列,請將抵銷增至 1,000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers