概念︰WQL 查詢結果的分頁
當您第一次執行查詢時，查詢參數中的 Workday 查詢語言 (WQL) 會執行並建置傳回最多 10,000 列的快取。您可以使用
limit
和 offset
在 WQL 查詢的 REST API 呼叫中輸入參數。WQL 只會在使用者階段作業期間快取頁面限制要求。
若要檢視任何剩餘的結果，請使用下列參數︰
參數 | 說明 |
|---|---|
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