概念: WQL クエリー結果のページング
クエリーを最初に実行するとき、クエリー パラメータ内のWorkdayクエリー言語 (WQL) が実行され、最大 10,000 行を返すキャッシュが構築されます。追加の行にアクセスするには、以下を使用して結果セットをページ化します。
limit
およびoffset
WQL クエリーのREST API呼び出しのパラメータ。WQL は、ページ制限リクエストをユーザーセッションの長さ (最大 30 分) のみキャッシュします。
残りの結果を表示するには、以下のパラメータを使用します。
パラメータ | 説明 |
|---|---|
limit
| 結果の 1 ページの行数を指定します。ゼロ以上 10,000 の間の値を指定してください。 |
offset
| 結果セットの開始行を指定します。使用先 limit パラメータ。
結果の最初のページに対する最初のリクエストで、以下を省略します offset パラメータを設定するか、ゼロに設定してください。 |
このキーワードは予約されています
LIMIT
句とページング パラメータの両方に対して。LIMIT キーワードでは大文字と小文字が区別されません。- 以下を使用します。LIMIT句。クエリーの応答で返される合計行数を制限します。
- 以下を使用します。limitパラメータを設定し、クエリー応答のページごとに表示する行数を指定します。
例
WQL リクエストを行う場所によって、使用する基本 URL は異なります。
WQL リクエスト ソース
| 使用する基本 URL
|
|---|---|
Workdayテナントホスト | https://{hostname}/api/wql/{version}/{tenant}
|
WCP API Gateway | 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