Compartilhar via


Configurar a paginação para obter mais dados do que o limite de tamanho de página nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

Quando você obtém dados, itens ou registros usando uma ação de conector nos Aplicativos Lógicos do Azure, você pode obter conjuntos de resultados tão grandes que a ação não retorna todos os resultados ao mesmo tempo. Por exemplo, o tamanho da página padrão para a ação Obter linhas do conector do SQL Server é 2048, mas pode variar com base em outras configurações.

Para algumas ações, o número de resultados pode exceder o tamanho da página padrão do conector. Nesse caso, a ação retorna apenas a primeira página de resultados.

Algumas ações permitem ativar uma configuração de paginação para que seu aplicativo lógico possa recuperar mais resultados até o limite de paginação. A ação retorna esses resultados como uma única mensagem quando a ação é concluída.

Ao usar a paginação, você deve especificar um valor de limite , que é o número de resultados que você deseja que a ação retorne. A ação obtém resultados até atingir o limite especificado. Quando o número total de itens é menor que o limite especificado, a ação obtém todos os resultados.

A ativação das configurações de paginação recupera páginas de resultados com base no tamanho da página de um conector. Esse comportamento significa que, às vezes, você pode obter mais resultados do que o limite especificado. Por exemplo, ao usar a ação Obter linhas do SQL Server, que dá suporte à configuração de paginação:

  • O tamanho da página padrão da ação é de 2048 registros por página.
  • Suponha que você tenha 10.000 registros e especifique 5.000 registros como o mínimo.
  • A paginação obtém páginas de registros, portanto, para obter pelo menos o mínimo especificado, a ação retorna 6.144 registros (3 páginas x 2048 registros), não 5.000 registros.

Aqui está uma lista de alguns dos conectores em que você pode exceder o tamanho da página padrão para algumas ações:

Pré-requisitos

Ativar paginação

Para determinar se uma ação dá suporte à paginação no designer de fluxo de trabalho, verifique as configurações da ação para a configuração de Paginação .

  1. Abra o recurso de aplicativo lógico no portal do Azure.

  2. Com base no tipo de aplicativo lógico, siga as etapas correspondentes:

    • Consumo: no menu lateral do recurso, em Ferramentas de Desenvolvimento, selecione o designer para abrir o fluxo de trabalho.

    • Padrão: no menu da barra lateral do recurso, em Fluxos de Trabalho, selecione Fluxos de Trabalho. Selecione o fluxo de trabalho para abrir o designer.

  3. No designer, selecione a ação. No painel de informações que é aberto, selecione Configurações.

    Se a ação der suporte à paginação, em Rede, a configuração paginação estará disponível.

  4. Altere a configuração de Paginação de Desativada para Ativada.

    A captura de tela mostra o painel de informações de ação com a guia Configurações, Paginação definida como Ativada e um valor limite.

  5. Na propriedade Threshold , especifique um valor inteiro para o número de destino de resultados que você deseja que a ação retorne.

  6. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Definição de fluxo de trabalho – paginação

Quando você ativa a paginação para uma ação que dá suporte a esse recurso, a definição de fluxo de trabalho do aplicativo lógico inclui a propriedade "paginationPolicy" juntamente com a propriedade "minimumItemCount" na propriedade "runtimeConfiguration" da ação, por exemplo:

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

Nesse caso, a resposta retorna uma matriz que contém objetos JSON.

Obtenha suporte