Abrufen weiterer Daten, Elemente oder Datensätze mithilfe der Paginierung in Azure Logic Apps

  • Artikel

Gilt für: Azure Logic Apps (Verbrauch)

Wenn Sie Daten, Elemente oder Datensätze mithilfe einer Connectoraktion in Azure Logic Apps abrufen, erhalten Sie möglicherweise so große Resultsets, dass die Aktion nicht alle Ergebnisse gleichzeitig zurückgibt. Bei einigen Aktionen kann die Anzahl der Ergebnisse die Standardseitengröße des Connectors überschreiten. In diesem Fall gibt die Aktion nur die erste Seite mit Ergebnissen zurück. Die Standardseitengröße für die Aktion Zeilen abrufen des SQL Server-Connectors ist z. B. 2048, dieser Wert kann aber basierend auf anderen Einstellungen abweichen.

Bei einigen Aktionen können Sie eine Paginierung-Einstellung aktivieren, sodass Ihre Logik-App mehr Ergebnisse bis zur Paginierungsgrenze abrufen kann, diese aber nach Abschluss der Aktion als einzelne Nachricht zurückgibt. Wenn Sie die Paginierung verwenden, müssen Sie einen Schwellenwert angeben, der die Zielanzahl der Ergebnisse angibt, die von der Aktion zurückgegeben werden sollen. Die Aktion ruft Ergebnisse ab, bis der angegebene Schwellenwert erreicht ist. Wenn Ihre Gesamtzahl der Elemente unter dem angegebenen Schwellenwert liegt, ruft die Aktion alle Ergebnisse ab.

Durch Aktivieren der Paginierungseinstellung werden Ergebnisseiten abgerufen, die auf der Seitengröße eines Connectors basieren. Dieses Verhalten bedeutet, dass Sie unter Umständen mehr Ergebnisse erzielen können, als durch den Schwellenwert angegeben. Wenn Sie z. B. die SQL Server-Aktion Zeilen abrufen verwenden, die die Paginierungseinstellung unterstützt:

  • Die Standardseitengröße der Aktion beträgt 2048 Datensätze pro Seite.
  • Angenommen, Sie verfügen über 10.000 Datensätze und geben als Mindestwert 5000 Datensätze an.
  • Die Paginierung ruft Seiten von Datensätzen ab, daher gibt die Aktion 6144 (3 Seiten x 2048 Datensätze) und nicht 5000 Datensätze zurück, um mindestens den angegebenen Mindestwert zu erreichen.

Hier folgt eine Liste mit nur einigen der Connectors, bei denen Sie die Standardseitengröße für bestimmte Aktionen überschreiten können:

Voraussetzungen

Aktivieren der Paginierung

Um festzustellen, ob eine Aktion die Paginierung im Workflow-Designer unterstützt, überprüfen Sie die Einstellungen der Aktion für die Einstellung Paginierung. In diesem Beispiel wird veranschaulicht, wie die Paginierung in der SQL Server-Aktion Zeilen abrufen aktiviert wird.

  1. Wählen Sie in der Aktion oben rechts zuerst die Auslassungspunkte ( ... ) und dann Einstellungen aus.

    Open the action's settings

    Wenn die Aktion die Paginierung unterstützt, zeigt sie die Einstellung Paginierung an.

  2. Ändern Sie die Einstellung Paginierung von Aus in Ein. Geben Sie in der Eigenschaft Schwellenwert einen ganzzahligen Wert für die Zielanzahl der Ergebnisse an, die die Aktion zurückgeben soll.

    Specify minimum number of results to return

  3. Wählen Sie abschließend Fertig aus.

Workflowdefinition – Paginierung

Wenn Sie die Paginierung für eine Aktion aktivieren, die diese Funktion unterstützt, enthält die Workflowdefinition Ihrer Logik-App die Eigenschaft "paginationPolicy" zusammen mit der Eigenschaft "minimumItemCount" in der Eigenschaft "runtimeConfiguration" dieser Aktion. Beispiel:

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

In diesem Fall gibt die Antwort ein Array zurück, das JSON-Objekte enthält.

Support

Weitere Informationen finden Sie auf der Frageseite von Microsoft Q&A für Azure Logic Apps.