Freigeben über


Testen der Benutzerdatenfunktionen im Fabric-Portal

Das Fabric-Portal bietet Features zum Testen und Überprüfen der Codeänderungen ihrer Benutzerdatenfunktionen vor der Veröffentlichung. Sie können unveröffentlichten Code im Entwicklungsmodus testen oder veröffentlichte Funktionen im Modus "Nur ausführen" überprüfen. Für lokale Tests können Sie die VS Code-Erweiterung verwenden.

Das Testen hilft Ihnen bei folgendem:

  • Überprüfen, ob Ihre Funktionen ohne Fehler erfolgreich ausgeführt werden
  • Überprüfen, ob Ihre Funktionen erwartete Ergebnisse mit unterschiedlichen Eingaben zurückgeben
  • Schnelles Debuggen von Problemen durch Anzeigen von Protokollen und Fehlermeldungen
  • Schnelleres Durchlaufen von Codeänderungen im Entwicklungsmodus ohne Veröffentlichung nach jeder Bearbeitung
  • Vergewissern Sie sich, dass veröffentlichte Funktionen im Modus "Nur Ausführen" ordnungsgemäß funktionieren

Hinweis

Einige Benutzer haben je nach Region ihres Fabric-Mandanten möglicherweise keinen Zugriff auf die Testfunktion im Entwicklungsmodus. Überprüfen Sie die Hinweise zu regionalen Einschränkungen in diesem Artikel.

Voraussetzungen

Bevor Sie Ihre Funktionen testen können, benötigen Sie Folgendes:

  • Ein Element "Benutzerdatenfunktionen" in Ihrem Fabric-Arbeitsbereich
  • Schreiben von Berechtigungen für den Zugriff auf den Entwicklungsmodus und Verwenden der Testfunktion
  • In Ihrem Code definierte Funktionen (veröffentlicht oder unveröffentlicht)

Grundlagen des Entwicklungsmodus und des Nur-Ausführungsmodus

Fabric-Benutzerdatenfunktionen bieten zwei Modi, die bestimmen, was Sie testen können:

  • Entwicklungsmodus – Testen Sie sowohl veröffentlichte als auch nicht veröffentlichte Funktionen. Mit diesem Modus können Sie Codeänderungen überprüfen, bevor Sie sie veröffentlichen.
  • Nur Modus ausführen – Nur veröffentlichte Funktionen ausführen. In diesem Modus wird gezeigt, was andere Benutzer mit Ausführungsberechtigungen ausführen können.

Sie können zwischen den Modi wechseln, indem Sie den Modusschalter in der oberen rechten Ecke der Seite "Benutzerdatenfunktionen" verwenden. Weitere Informationen zur Portalschnittstelle finden Sie unter Verwenden des Portal-Editors.

Screenshot, der zeigt, wie Modi im Fabric-Portal gewechselt werden.

Testen der Funktionen im Entwicklungsmodus

So testen Sie eine Funktion im Entwicklungsmodus:

  1. Wechseln Sie mit dem Modusschalter in der oberen rechten Ecke zum Entwicklungsmodus .

  2. Zeigen Sie mit der Maus auf die Funktion, die Sie in der Funktionsliste testen möchten.

  3. Wählen Sie das Symbol "Test " aus, um den Testbereich zu öffnen.

    Screenshot, der zeigt, wie eine neue Funktion getestet wird.

Hinweis

Die Testsitzung kann einige Sekunden dauern, bis sie gestartet werden. Sobald die Sitzung aktiv ist, können Sie Tests sofort ausführen, auch nachdem Sie Codeänderungen vorgenommen haben.

Verstehen des Testpanels

Wenn Sie das Symbol "Test" auswählen, wird der Bereich "Test" als Dialogfeld geöffnet, in dem Sie Ihre Tests konfigurieren und ausführen. Das Panel bietet alles, was Sie zum Testen Ihrer Funktionen und zum Überprüfen der Ergebnisse benötigen:

Screenshot der verschiedenen Teile des Testbereichs.

  • Funktionsauswahl – Wählen Sie aus dem Dropdownmenü aus, welche Funktion getestet werden soll. Die Liste enthält sowohl veröffentlichte als auch nicht veröffentlichte Funktionen.
  • Parameter – Bereitstellen von Eingabewerten für Funktionen, die Parameter erfordern.
  • Testausgabe – Zeigen Sie den Rückgabewert Ihrer Funktion oder Fehlerdetails an, wenn die Funktion fehlschlägt.
  • Protokollausgabe – Anzeigen von Protokollen , die vom Code generiert wurden, einschließlich anweisungen, die dem logging Objekt hinzugefügt wurden. Weitere Informationen zum Anzeigen und Analysieren von Protokollen finden Sie unter Anzeigen von Funktionsprotokollen.

Um den Test auszuführen, geben Sie alle erforderlichen Parameter an, und wählen Sie die Schaltfläche " Test " aus. Die Testsitzungsanzeige in der Statusleiste zeigt an, wann Ihre Testsitzung aktiv ist. Die Sitzung bleibt für 15 Minuten Inaktivität aktiv, sodass Sie mehrere Male testen können, ohne auf den Neustart der Sitzung zu warten.

Testen veröffentlichter Funktionen im Modus "Nur Ausführen"

Um veröffentlichte Funktionen zu testen, wie andere Benutzer sie ausführen würden:

  1. Veröffentlichen Sie Ihre Funktionen , sofern noch nicht geschehen.
  2. Wechseln Sie zum Modus "Nur ausführen ", indem Sie den Modusschalter verwenden.
  3. Zeigen Sie auf eine Funktion in der Funktionsliste.
  4. Wählen Sie das Symbol "Ausführen" aus, um den Bereich "Ausführen" zu öffnen.
  5. Geben Sie alle erforderlichen Parameter im Bereich "Ausführen" an.
  6. Wählen Sie "Ausführen" aus, um die Funktion auszuführen.

Der Bereich "Ausführen" stellt dieselben Elemente wie der Testbereich bereit: Funktionsauswahl, Parameter, Ausgabe und Protokolle. Dieser Modus ist nützlich, um sicherzustellen, dass veröffentlichte Funktionen für Benutzer mit Ausführungsberechtigungen ordnungsgemäß funktionieren.

Bewährte Methoden für Tests

Befolgen Sie die folgenden Methoden, um Ihre Funktionen effektiv zu testen:

  • Testen Sie frühzeitig und häufig – Testen Sie Funktionen, während Sie sie entwickeln, anstatt zu warten, bis der gesamte Code abgeschlossen ist.
  • Testen Sie mit unterschiedlichen Eingaben – Validieren Sie Ihre Funktionen mit verschiedenen Parameterwerten, einschließlich Randfällen.
  • Überprüfen Sie die Protokolle sorgfältig – Verwenden Sie die Protokollausgabe, um das Funktionsverhalten zu verstehen und Probleme zu identifizieren.
  • Testen Vor der Veröffentlichung – Immer im Entwicklungsmodus testen, bevor sie veröffentlicht werden, um sicherzustellen, dass Funktionen wie erwartet funktionieren.
  • Verwenden Sie den Modus "Nur ausführen" für die Überprüfung. Verwenden Sie nach der Veröffentlichung den Modus "Nur ausführen", um sicherzustellen, dass veröffentlichte Funktionen ordnungsgemäß funktionieren.

Behandlung von Testfragen

Wenn beim Testen Ihrer Funktionen Probleme auftreten, sollten Sie die folgenden gängigen Lösungen in Betracht ziehen:

Testsitzung nicht gestartet

  • Warten Sie einige Sekunden, bis die Testsitzung initialisiert wird.
  • Überprüfen Sie Ihre Netzwerkverbindung, und stellen Sie sicher, dass Sie auf Fabric-Dienste zugreifen können.
  • Überprüfen Sie, ob Ihre Region die Testfunktion unterstützt (siehe regionale Einschränkungen)

Funktion schlägt mit Verbindungsfehlern fehl

  • Überprüfen, ob alle erforderlichen Datenverbindungen ordnungsgemäß konfiguriert sind
  • Stellen Sie sicher, dass Sie über Berechtigungen für den Zugriff auf die verbundenen Datenquellen verfügen.
  • Überprüfen, ob Verbindungsanmeldeinformationen gültig und nicht abgelaufen sind

Funktion schlägt mit Import- oder Modulfehlern fehl

  • Vergewissern Sie sich, dass alle erforderlichen Bibliotheken installiert sind.
  • Warten Sie, bis die Bibliotheksinstallation abgeschlossen ist, bevor Sie testen
  • Überprüfen Sie die Dienstlimitierungen hinsichtlich der Größenbeschränkungen der Bibliothek

Test überschreitet die Zeit

  • Überprüfen des Zeitlimits für die Ausführung (240 Sekunden)
  • Optimieren Des Funktionscodes, um die Ausführungszeit zu reduzieren
  • Überprüfen von Protokollen, um zu ermitteln, welche Vorgänge am längsten dauert

Rückgabewert-Fehler: Wert zu groß

  • Überprüfen des Grenzwerts für die Antwortgröße (30 MB)
  • Verringern der Von Ihrer Funktion zurückgegebenen Datenmenge
  • Betrachten Sie Paginierungs- oder Filterergebnisse.

Weitere Informationen zur Diagnose von Problemen finden Sie in den Funktionsprotokollen anzeigen.

Regionale Einschränkungen für die Testfunktion im Entwicklungsmodus

Die Testfunktion ist noch nicht in allen Fabric-Regionen verfügbar. Wenn Ihre Mandantenregion nicht unterstützt wird, wird im Azure Functions-Portal eine Meldung angezeigt. Sie können die unterstützten Regionen im Artikel " Dienstdetails und Einschränkungen " anzeigen.

Screenshot, der das Banner

Wenn die Testfunktion in Ihrer Region nicht verfügbar ist, können Sie Ihre Funktionen weiterhin veröffentlichen und die Ausführungsfunktion verwenden, um sie zu überprüfen. Alternativ können Sie eine neue Kapazität in einer unterstützten Region erstellen.