Obter mais dados, itens ou registos utilizando a paginação nas Aplicações Lógicas do Azure

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

Ao recuperar 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. Com algumas ações, o número de resultados pode exceder o tamanho de página padrão do conector. Nesse caso, a ação retorna apenas a primeira página de resultados. Por exemplo, o tamanho de 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.

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, mas retornar esses resultados como uma única mensagem quando a ação terminar. Ao usar paginação, você deve especificar um valor limite, que é o número de resultados de destino que você deseja que a ação retorne. A ação recupera os resultados até atingir o limite especificado. Quando o número total de itens é inferior ao limite especificado, a ação recupera todos os resultados.

Ativar a configuração 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 de página padrão da ação é de 2048 registros por página.
• Suponha que você tenha 10.000 registros e especifique 5000 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 6144 registros (3 páginas x 2048 registros), não 5000 registros.

Aqui está uma lista com apenas alguns dos conectores onde você pode exceder o tamanho de página padrão para ações específicas:

• Armazenamento de Blobs do Azure
• Dynamics 365
• Excel
• HTTP
• IBM DB2
• Microsoft Teams
• Oracle Database
• Salesforce
• SharePoint
• SQL Server

Pré-requisitos

• Uma subscrição do Azure. Se ainda não tiver uma subscrição do Azure, inscreva-se numa conta gratuita do Azure.

• O aplicativo lógico e a ação em que você deseja ativar a paginação. Para obter mais informações, consulte Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo em aplicativos lógicos do Azure multilocatário.

Ativar paginação

Para determinar se uma ação oferece suporte à paginação no designer de fluxo de trabalho, verifique as configurações da ação para a configuração Paginação . Este exemplo mostra como ativar a paginação na ação Obter linhas do SQL Server.

1. No canto superior direito da ação, escolha o botão de reticências (...) e selecione Configurações.

   

   Se a ação oferecer suporte à paginação, a ação mostrará a configuração de Paginação .

2. Altere a configuração de Paginação de Desativado para Ativado. Na propriedade Threshold, especifique um valor inteiro para o número de resultados de destino que você deseja que a ação retorne.

   

3. Quando estiver pronto, escolha Concluído.

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 seu aplicativo lógico inclui a propriedade junto com a "paginationPolicy" "minimumItemCount" propriedade na propriedade dessa "runtimeConfiguration" 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.

Obter suporte

Para perguntas, visite a página de perguntas e respostas da Microsoft para Aplicativos Lógicos do Azure.