Azure Logic Apps で改ページ位置の自動修正を使用し、データ、項目、レコードを増やす
適用対象: Azure Logic Apps (従量課金)
Azure Logic Apps でコネクタ アクションを使用してデータ、項目、レコードを受け取るとき、得られた結果セットが大きすぎて、全部の結果を同時に返せないことがあります。 アクションによっては、結果の数がコネクタの既定のページ サイズを超えることがあります。 この場合、アクションは、結果の最初のページのみを返します。 たとえば、SQL Server コネクタの行の取得アクションの既定のページ サイズは 2048 ですが、その他の設定によって変わることがあります。
一部のアクションでは、改ページ位置の自動修正の上限までロジック アプリで受け取る結果を増やせますが、アクションが完了したとき、それらの結果を 1 つのメッセージとして返すよう、改ページ位置の自動修正設定をオンにできます。 改ページ位置の自動修正を使用するとき、アクションで返す結果の目標数であるしきい値を指定する必要があります。 このアクションでは、指定したしきい値に到達するまで結果が取得されます。 項目の合計数が指定のしきい値より少ないとき、このアクションではすべての結果が受け取られます。
改ページ位置の自動修正設定をオンにすると、コネクタのページ サイズに基づいて結果のページが受け取られます。 この動作は、指定したしきい値よりも多く結果を受け取る可能性があることを意味します。 たとえば、次の改ページ位置の自動修正設定をサポートする、SQL Server の行の取得アクションの使用時です。
- このアクションの既定のページ サイズはページあたり 2,048 件のレコードです。
- 10,000 件のレコードがあるとき、5,000 件を最小として指定するとします。
- 改ページ位置の自動修正により、レコードのページが取得されます。そのため、少なくとも指定の最小レコードを得るために、このアクションで 5,000 件ではなく、6,144 件のレコード (3 ページ x 2048 件) が返されます。
特定のアクションで既定のページ サイズを超過できるコネクタには次のものがあります。
- Azure Blob Storage
- Dynamics 365
- Excel
- HTTP
- IBM DB2
- Microsoft Teams
- Oracle データベース
- Salesforce
- SharePoint
- SQL Server
前提条件
Azure サブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。
改ページ位置の自動修正をオンにするロジック アプリとアクション。 詳細については、「マルチテナント Azure Logic Apps で従量課金ロジック アプリ ワークフローの例を作成する」をご覧ください。
改ページ位置の自動修正をオンにする
ワークフロー デザイナーのアクションで改ページ位置の自動修正がサポートされるかどうかを判断するには、アクションの設定で [改ページ位置の自動修正] 設定を確認します。 この例では、SQL Server の行の取得アクションで改ページ位置の自動修正をオンにする方法を示します。
アクションの右上隅で、省略記号 ( ... ) ボタンを選択し、 [設定] を選択します。
そのアクションで改ページ位置の自動修正がサポートされる場合、そのアクションに改ページ位置の自動修正設定が表示されます。
[改ページ位置の自動修正] 設定を [オフ] から [オン] に変更します。 [しきい値] プロパティに、そのアクションで返す結果の目標数として整数値を指定します。
準備ができたら、 [完了] を選択します。
ワークフロー定義 - 改ページ位置の自動修正
この機能がサポートされるアクションに対して改ページ位置の自動修正をオンにすると、ロジック アプリにワークフロー定義に、そのアクションの "runtimeConfiguration"
プロパティの "minimumItemCount"
プロパティと共に、"paginationPolicy"
プロパティが含まれます。次の例をご覧ください。
"actions": {
"HTTP": {
"inputs": {
"method": "GET",
"uri": "https://www.testuri.com"
},
"runAfter": {},
"runtimeConfiguration": {
"paginationPolicy": {
"minimumItemCount": 1000
}
},
"type": "Http"
}
},
この場合、応答で JSON オブジェクトを含む配列が返されます。
サポートを受ける
ご質問がある場合は、Azure Logic Apps に関する Microsoft Q&A 質問ページを参照してください。