Beispiel für parallele Web-API-Vorgänge mit TPL Dataflow-Komponenten (C#)

  • Artikel

Dieses .NET 6.0-Beispiel zeigt, wie Sie parallele Datenoperationen mit der Dataverse Web-API mit Dataflow-Komponenten der Task Parallel Library (TPL) ausführen. Mehr Informationen: Dataflow (Task Parallel Library).

In diesem Beispiel wird der allgemeine Helfercode in der WebAPIService-Klassenbibliothek (C#) verwendet.

Anforderungen

  • Microsoft Visual Studio 2022.
  • Zugriff auf Dataverse mit Rechten, um Datenvorgänge auszuführen.

Wie man dieses Beispiel ausführt

  1. Klonen Sie das PowerApps-Beispiele-Repository oder laden Sie es herunter.

  2. Suchen Sie den Ordner /dataverse/webapi/C#-NETx/TPLDataFlowParallelOperations/.

  3. De Datei TPLDataFlowParallelOperations.sln mit Visual Studio 2022 öffnen

  4. Bearbeiten Sie die appsettings.json-Datei, um die folgenden Eigenschaftswerte festzulegen:

    Eigenschaften Anweisungen
    Url Die Url für Ihre Umgebung. Ersetzen Sie den https://yourorg.api.crm.dynamics.com-Wert des Platzhalters durch den Wert für Ihre Umgebung. Gehen Sie zu Entwicklerressourcen anzeigen, um die URL für Ihre Umgebung zu finden.
    UserPrincipalName Ersetzen Sie den you@yourorg.onmicrosoft.com-Wert des Platzhalters durch den UPN-Wert, den Sie für den Zugriff auf die Umgebung verwenden.
    Password Ersetzen Sie den yourPassword-Wert des Platzhalters durch das von Ihnen verwendete Kennwort.

  5. Die Datei appsettings.json speichern

  6. Drücken Sie F5, um das Beispiel auszuführen.

Code

Der Code für dieses Beispiel ist hier: PowerApps-Beispiele/dataverse/webapi/C#-NETx/TPLDataFlowParallelOperations/Program.cs

Veranschaulichung

Dieses Beispiel enthält Einstellungen, die Sie anwenden können, um Ihre Verbindung zu optimieren.

Dieses Beispiel sendet zunächst eine einfache Anforderung, um auf den Wert des x-ms-dop-hint Antwortheaders zuzugreifen, um die empfohlenen Parallelitätsgrade für diese Umgebung zu bestimmen. Wenn der maximale Parallelitätsgrad gleich dem Wert des x-ms-dop-hint-Antwortheaders festgelegt wird, sollten Sie einen stabilen Zustand erreichen, in dem der Durchsatz mit einem Minimum der zurückgegebenen 429 TooManyRequests-Dienstschutzgrenzwertfehler optimiert ist.

Um bei diesem Beispiel auf Dienstschutzgrenzwerte zu stoßen, sollten Sie die numberOfRecords-Variable auf über 10.000 oder was auch immer erforderlich ist, erhöhen, damit das Beispiel länger als 5 Minuten läuft. Sie sollten auch den Code ändern, um maxDegreeOfParallelism auf deutlich über dem Wert des x-ms-dop-hint Antwortheaders einzustellen. Anschließend sollten Sie mit Fiddler beobachten können, wie WebAPIService die Anforderungen wiederholt, die diesen Fehler zurückgeben.

Dieses Beispiel erstellt einfach eine konfigurierbare Anzahl von Firmendatensätzen, die es dann löscht. Dieses Beispiel verwendet Datenflusskomponenten, um die Datensätze zu verarbeiten und die Ergebnisse des Erstellungsvorgangs in die nächste Phase zu transformieren, in der diese Datensätze gelöscht werden. Aufgrund der Art dieses Dataflows beginnen Löschvorgänge für zuvor erstellte Datensätze, bevor alle zu erstellenden Datensätze abgeschlossen sind.

Vielleicht möchten Sie dieses Beispiel mit Web-API CDSWebApiService-Beispiel für parallele Vorgänge (C#) vergleichen.

Bereinigung

Standardmäßig löscht dieses Beispiel alle darin erstellten Datensätze. Wenn Sie die erstellten Datensätze nach Abschluss des Beispiels anzeigen möchten, ändern Sie die deleteCreatedRecords-Variable auf false und Sie werden aufgefordert, zu entscheiden, ob Sie die Datensätze löschen möchten.

Siehe auch

Dataverse-Web-API verwenden
WebAPIService-Klassenbibliothek (C#)
Erstellen einer Tabellenzeile über die Web-API
Aktualisieren und Löschen von Tabellenzeilen über die Web-API
API-Grenzwerte für den Serviceschutz
Web API Beispiele
Beispiel grundlegender Web-API-Operationen (C#)
Web API-Abfragedatenbeispiel (C#)
Beispiel bedingter Web-API-Operationen (C#)
Web-API-Funktionen- und Aktionen-Beispiel (C#)
Beispiel für Web-API-Tabellenschemavorgänge (C#)
Web-API WebApiService-Beispiel für parallele Operationen (C#)

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).