Получение дополнительных данных, элементов или записей с помощью разбиения на страницы в Azure Logic AppsGet more data, items, or records by using pagination in Azure Logic Apps

При извлечении данных, элементов или записей с помощью действия соединителя в Azure Logic Appsвы можете получить результирующие наборы так, чтобы они не возвращали все результаты одновременно.When you retrieve data, items, or records by using a connector action in Azure Logic Apps, you might get result sets so large that the action doesn't return all the results at the same time. При некоторых действиях количество результатов может превышать размер страницы по умолчанию для соединителя.With some actions, the number of results might exceed the connector's default page size. В этом случае действие возвращает только первую страницу результатов.In this case, the action returns only the first page of results. Например, размер страницы по умолчанию для действия получения строк соединителя SQL Server равен 2048, но может отличаться в зависимости от других параметров.For example, the default page size for the SQL Server connector's Get rows action is 2048, but might vary based on other settings.

Некоторые действия позволяют включить параметр разбивки на страницы , чтобы приложение логики получало больше результатов до предела разбивки на страницы, но вернуть результаты в виде одного сообщения после завершения действия.Some actions let you turn on a pagination setting so that your logic app can retrieve more results up to the pagination limit, but return those results as a single message when the action finishes. При использовании разбивки на страницы необходимо указать пороговое значение, которое является целевым числом результатов, возвращаемых действием.When you use pagination, you must specify a threshold value, which is the target number of results you want the action to return. Действие получает результаты, пока не достигнет указанного порогового значения.The action retrieves results until reaching your specified threshold. Если общее число элементов меньше заданного порогового значения, действие извлекает все результаты.When your total number of items is less than the specified threshold, the action retrieves all the results.

Включение параметра разбивки на страницы приводит к извлечению страниц результатов на основе размера страницы соединителя.Turning on the pagination setting retrieves pages of results based on a connector's page size. Такое поведение означает, что иногда может получиться больше результатов, чем заданное пороговое значение.This behavior means that sometimes, you might get more results than your specified threshold. Например, при использовании действия SQL Server Получение строк , которое поддерживает настройку разбивки на страницы:For example, when using the SQL Server Get rows action, which supports pagination setting:

  • Размер страницы по умолчанию для этого действия составляет 2048 записей на страницу.The action's default page size is 2048 records per page.
  • Предположим, что у вас есть 10 000 записей и в качестве минимального количества записей указано 5000.Suppose you have 10,000 records and specify 5000 records as the minimum.
  • Разбиение на страницы — получение страниц записей, поэтому для получения хотя бы указанного минимума действие возвращает 6144 записей (3 страницы x 2048 записей), а не 5000 записей.Pagination gets pages of records, so to get at least the specified minimum, the action returns 6144 records (3 pages x 2048 records), not 5000 records.

Ниже приведен список, содержащий только некоторые соединители, в которых можно превысить размер страницы по умолчанию для определенных действий.Here's a list with just some of the connectors where you can exceed the default page size for specific actions:

Предварительные требованияPrerequisites

Включить разбивку на страницыTurn on pagination

Чтобы определить, поддерживает ли действие разбиение на страницы в конструкторе приложений логики, проверьте параметры для параметра разбивки на страницы .To determine whether an action supports pagination in the Logic App Designer, check the action's settings for the Pagination setting. В этом примере показано, как включить разбивку на страницы в действии SQL Server Получение строк .This example shows how to turn on pagination in the SQL Server's Get rows action.

  1. В правом верхнем углу действия нажмите кнопку с многоточием (...) и выберите Параметры.In the action's upper-right corner, choose the ellipses (...) button, and select Settings.

    Открытие параметров действия

    Если действие поддерживает разбивку на страницы, действие отображает параметр разбивки на страницы .If the action supports pagination, the action shows the Pagination setting.

  2. Измените значение параметра разбивка на страницы с на вкл.Change the Pagination setting from Off to On. В свойстве threshold укажите целочисленное значение для целевого количества результатов, которое должно быть возвращено действием.In the Threshold property, specify an integer value for the target number of results that you want the action to return.

    Укажите Минимальное число возвращаемых результатов

  3. Когда вы будете готовы, нажмите кнопку Готово.When you're ready, choose Done.

Определение рабочего процесса — разбивка на страницыWorkflow definition - pagination

При включении разбивки на страницы для действия, которое поддерживает эту возможность, определение рабочего процесса приложения логики "paginationPolicy" включает свойство вместе со "minimumItemCount" свойством в "runtimeConfiguration" свойстве этого действия, например:When you turn on pagination for an action that supports this capability, your logic app's workflow definition includes the "paginationPolicy" property along with the "minimumItemCount" property in that action's "runtimeConfiguration" property, for example:

"actions": {
   "HTTP": {
      "inputs": {
         "method": "GET",
         "uri": "https://www.testuri.com"
      },
      "runAfter": {},
      "runtimeConfiguration": {
         "paginationPolicy": {
            "minimumItemCount": 1000
         }
      },
      "type": "Http"
   }
},

Получение поддержкиGet support

Если у вас возникли вопросы, то посетите форум Azure Logic Apps.For questions, visit the Azure Logic Apps forum.