SOAP API 開発者ガイド
jqueryMore()
query() からオブジェクトの次のバッチを取得します。
構文
使用方法
このコールを使用して query() コールを処理し、結果セット内に大量のレコード (通常 500 超) を取得します。query() コールは、最初の 500 レコードを取得し、queryLocator オブジェクト内にサーバ側カーソルを作成します。queryMore() コールは、最大 500 レコードのチャンクまで後続のレコードを処理し、新規に生成された QueryLocator を返します。結果セット内のレコードを反復処理するために、一般的には、すべての結果セット内のレコードが処理される (Done フラグが true になる) まで、queryMore() を繰り返しコールします。返されるレコードの最大数は最高 2,000 にまで変更可能です。詳細は、『Salesforce SOQL および SOSL リファレンス』の「クエリのバッチサイズの変更」を参照してください。
クエリに GROUP BY 句がある場合、queryMore() を使用できません。詳細は、『Salesforce SOQL および SOSL リファレンス』の「GROUP BY」および「queryMore()」を参照してください。
外部オブジェクトを照会するとき、Salesforce Connect は Web サービスコールアウト経由で外部データにリアルタイムにアクセスします。queryMore() コールを実行するたびに、Web サービスコールアウトが行われます。バッチの区切りとページサイズは、アダプタと外部データソースの設定方法に応じて異なります。
- 可能ならば、外部オブジェクトのクエリを、デフォルトのバッチサイズである 500 行よりも少ない行を返すように絞り込んでページングを避けます。バッチを取得するたびに queryMore() コールが必要になり、その結果、Web サービスコールアウトが行われます。
- 外部データが頻繁に変更される場合は、queryMore() コールの使用を避けてください。次の queryMore() コールまでの間に外部データが変更された場合、予期しない QueryResult になることがあります。
SELECT ステートメントの主オブジェクト (「主導」オブジェクト) が外部オブジェクトの場合、queryMore() は主オブジェクトのみをサポートし、サブクエリをサポートしません。
デフォルトでは、Salesforce Connect の OData 2.0 および 4.0 アダプタは、クライアント駆動のページングを使用します。クライアント駆動ページングにより、OData アダプタは各 queryMore() コールを、$skip および $top システムクエリオプションを使用してバッチの区切りとページサイズを指定する OData クエリに変換します。これらのオプションは、LIMIT および OFFSET 句を使用した結果セットのページ処理に似ています。外部データソースのサーバ駆動ページングを有効にすると、要求されたページサイズ (デフォルトの queryMore() バッチサイズの 500 行を含む) が Salesforce で無視されます。バッチは、外部システムによって返されるページで決まりますが、各ページは 2,000 行を超��ることはできません。
サンプルコード —Java
このサンプルでは、すべての取引先責任者の名および姓を取得するクエリを実行します。クエリ文字列を渡して、query() をコールし、レコードの最初のバッチを取得します。次に、ループで queryMore() をコールして、レコードが返されなくなるまで、後続のバッチを取得します。照会した取引先責任者の名と姓をコンソールに書き込みます。
サンプルコード —C#
このサンプルでは、すべての取引先責任者の名および姓を取得するクエリを実行します。クエリ文字列を渡して、query() をコールし、レコードの最初のバッチを取得します。次に、ループで queryMore() をコールして、レコードが返されなくなるまで、後続のバッチを取得します。照会した取引先責任者の名と姓をコンソールに書き込みます。
引数
| 名前 | 型 | 説明 |
|---|---|---|
| queryLocator | QueryLocator | クエリ結果セットにおいて、現在の処理位置を追跡するサーバ側のカーソルを表します。 |