Teilen über


Lokales Testen der Stream Analytics-Abfrage anhand von Livestream-Eingaben mit Visual Studio Code

Das lokale Testen Ihrer Stream Analytics-Abfrage anhand von Livestream-Eingaben ist ein wichtiger Schritt, um die Genauigkeit und Effizienz Ihrer Abfragelogik sicherzustellen. Mit der Azure Stream Analytics-Erweiterung (ASA) für Visual Studio Code (VS Code) verfügen Sie über die erforderlichen Tools, um diese Tests nahtlos durchzuführen. Dieser Artikel führt Sie durch die Schritte zum Einrichten Ihrer Umgebung, zum Konfigurieren der Livestream-Eingabe und zum lokalen Ausführen Ihrer Abfrage für gründliche Tests.

Voraussetzungen

Definieren einer Livestream-Eingabe

  1. Klicken Sie mit der rechten Maustaste auf den Ordner Eingaben in Ihrem Stream Analytics-Projekt, und wählen Sie ASA: Eingabe hinzufügen aus. Screenshot der VS Code-Erweiterung, die Eingaben über das Dropdown-Menü hinzufügt. ODER drücken Sie Strg+Umschalt+P , um die Befehlspalette zu öffnen, und geben Sie ASA: Add Input ein. Wählen Sie dann das Abfrageskript für die Verarbeitung des Eingabedatenstroms aus. Screenshot der VS Code-Erweiterung, die Eingaben über die Befehlspalette hinzufügt.

  2. Wählen Sie in der Dropdownliste einen Typ einer Liveeingabequelle aus, wählen Sie Aus Ihren Azure-Abonnements aus , und geben Sie einen Namen für die Eingabequelle ein. Screenshot der VS Code-Erweiterung, die eine Reihe von Schritten für die Event Hub-Eingabekonfiguration zeigt.

  3. Sie sehen eine neue JSON-Datei , die im Eingabeordner erstellt wurde. Öffnen Sie die Datei , und wählen Sie Aus Ihren Abonnements aus , um Sie bei der Konfiguration Ihrer Event Hubs-Eingabe zu unterstützen. Screenshot der VS Code-Erweiterung, die die JSON-Eingabedateien anzeigt.

  4. Wählen Sie Datenvorschau aus, um zu überprüfen, ob die Live-Eingabe erfolgreich konfiguriert wurde. Screenshot der VS Code-Erweiterung in der Vorschau von Liveeingabedaten.

Lokales Ausführen der Abfrage

Öffnen Sie die Abfragedatei, wählen Sie Lokal ausführen oder auf der Menüleiste die Schaltfläche Wiedergabe aus, um ein Optionsfenster für die lokale Ausführung zum Konfigurieren des lokalen Ausführungsmodus zu öffnen.

Screenshot der VS Code-Erweiterung, die im Abfrage-Editor die Option

Wählen Sie Live-Eingabe und lokale Ausgabe verwenden aus, um den Auftrag lokal für den Live-Eingabestream auszuführen und Ausgabeergebnisse in einem lokalen Ordner zu erzeugen. Wählen Sie dann Ausführen aus, um die lokale Ausführung des Auftrags zu starten.

Screenshot der VS Code-Erweiterung, die den Wiedergabemodus für die lokale Ausführung auswählt.

Sie können sehen, dass alle 3 Sekunden ein lokales Testfenster geöffnet und aktualisiert wird. Die Ausgabeergebnisse werden im JSON-Format im Ordner LocalRunOutputs gespeichert.

Screenshot der VS Code-Erweiterung mit lokalem Testfenster.

Angeben von Eingabepartitionen für lokale Tests

Um zu vermeiden, dass alle Daten aus Event Hubs erfasst werden, können Sie während des lokalen Tests bestimmte Partitionen für Ihre Event Hubs angeben.

  1. Wählen Sie Lokal ausführen aus, um das Optionsfenster für die lokale Ausführung zu öffnen.
  2. Wählen Sie unter Select the input partitions section (Eingabepartitionen auswählen ) die Option Custom (Benutzerdefiniert) aus.
  3. Geben Sie die spezifischen Partitionsnummern ein, von denen Sie Daten für Ihre lokalen Tests erfassen möchten.

Screenshot der VS Code-Erweiterung, die Event Hub-Partitionen angibt.

Durch das Angeben der Partitionen können Sie sich auf das Testen Ihrer Abfragelogik konzentrieren, ohne sich um ein großes Datenvolumen kümmern zu müssen. Dieses Feature ermöglicht ein effizienteres und gezielteres Testen Ihres Stream Analytics-Auftrags.

Übermitteln eines Auftrags an Azure

Nachdem Sie die lokalen Tests Ihrer Abfrage abgeschlossen haben, können Sie Ihr Stream Analytics-Projekt an Azure übermitteln und mit der Ausführung des Auftrags in der Cloud beginnen.

  1. Wählen Sie die Option An Azure übermitteln aus, oder klicken Sie in der Abfragedatei auf die Schaltfläche Hochladen .
  2. Im Fenster mit den Übermittlungsoptionen können Sie einen vorhandenen Auftrag in Azure aktualisieren oder einen neuen Auftrag für den Upload erstellen.
  3. Geben Sie die erforderlichen Details an, einschließlich Ihres Abonnements, Ihrer Ressourcengruppe und der Region für die Bereitstellung.

Screenshot der VS Code-Erweiterung, die einen Auftrag an Azure übermittelt.

Sobald der Übermittlungsprozess abgeschlossen ist, können Sie Ihren Cloud-Auftrag in einem neuen Fenster anzeigen. Von dort aus können Sie die Leistung überwachen und die Konfigurationen nach Bedarf verwalten. Sie können den Auftrag auch in Ihrem Browser öffnen, indem Sie auf den Link klicken, der im AUSGABE-Panel angezeigt wird.

Screenshot der VS Code-Erweiterung, die den Cloudansichtsauftrag zeigt.

Nächste Schritte