Übersicht über lokale Tests von Stream Analytics-Aufträgen in Visual Studio Code mit ASA-Tools

  • Artikel

Mithilfe von Azure Stream Analytics-Tools (ASA-Tools) für Visual Studio Code können Sie Ihre Stream Analytics-Aufträge lokal testen. Im Zusammenhang mit Lokalität sind drei Aspekte zu berücksichtigen: der Auftragsausführungskontext (ein lokaler Computer oder der Azure-Clouddienst), die Eingabequellen und die Ausgabesenken.

Bei lokalen Ausführungen wird die Abfrage auf dem lokalen Computer ausgeführt. Als Eingabe können Daten aus lokalen Dateien oder Livequellen erfasst werden. Ausgabeergebnisse werden entweder als Dateien an einen lokalen Ordner oder an die Livesenken gesendet.

Überlegungen zur Eingabe für lokale Ausführungen

In VS Code können Sie Liveeingaben und lokale Eingaben definieren:

  • Liveeingaben sind Konfigurationsdateien, die auf eine Instanz der unterstützten Eingaben (Stream- und Verweisdaten) verweisen. Sie bieten außerdem eine Vorschau und Beispieldaten für JSON-Dateien.
  • Lokale Eingaben sind Konfigurationsdateien, die auf eine lokale Datei im unterstützten Format (JSON/CSV/AVRO) verweisen. Diese Dateien können aus einer Liveeingabe erfasst oder auf andere Weise generiert werden.

Beim Erstellen einer lokalen Eingabe kann sie an einer vorhandenen Liveeingabe ausgerichtet werden. In diesem Fall wird die Liveeingabe während der Ausführung lokaler Eingaben simuliert. Die Konfigurationsdatei wird nach der Liveeingabe benannt und erhält das Präfix Local_. Die von dieser lokalen Eingabe verwendete Datendatei muss nicht dem in der Liveeingabe definierten Format und Serialisierungsformat entsprechen. Ihre Formate sind voneinander unabhängig.

Überlegungen zur Ausgabe für lokale Ausführungen

Bei der Ausführung eines Auftrags für lokale Ausgaben werden die Ausgabeergebnisse an den Ordner LocalRunOutputs in Ihrem Projekt gesendet. In diesem Modus müssen keine Ausgaben definiert werden. Die einzige Einschränkung besteht darin, dass jede INTO-Anweisung in der Abfrage auf einen eindeutigen Ausgabenamen verweist. Nach einer Ausführung in lokalen Ausgaben wird für jeden eindeutigen Ausgabenamen eine JSON-Datei erstellt.

Modi für die lokale Ausführung

Es gibt drei von den ASA-Tools in VS Code unterstützte Modi für die lokale Ausführung von Aufträgen:

  • Lokale Ausführung mit lokaler Eingabe und lokaler Ausgabe: am besten für die kostenlose Offlineentwicklung, Komponententests mit dem npm-Paket usw. geeignet
  • Lokale Ausführung mit Liveeingabe und lokaler Ausgabe: am besten für Eingabekonfiguration, Deserialisierung und Partitionierungsdebuggen geeignet
  • Lokale Ausführung mit Liveeingabe und Liveausgabe: am besten für Ausgabekonfiguration, Deserialisierung und Debuggen von Konvertierungsfehlern geeignet

Jeder Modus unterstützt unterschiedliche Eingabe- und Ausgabekonfigurationen:

Ausführung Mode Eingabe Ausgabe
VS-Code Lokale Eingabe in lokale Ausgabe JSON-/CSV-/AVRO-Dateien JSON-Dateien (Das entsprechende Liveausgabeformat wird auch dann nicht verwendet, wenn es vorhanden ist.)
VS-Code Liveeingabe in lokale Ausgabe Alle Eingabeadapter JSON-Dateien (Das entsprechende Liveausgabeformat wird auch dann nicht verwendet, wenn es vorhanden ist.)
VS-Code Liveeingabe in Liveausgabe Alle Eingabeadapter Event Hub, Storage-Konto, Azure SQL
Azure Nicht zutreffend Alle Eingabeadapter Alle Ausgabeadapter

Beim lokalen Ausführen von Aufträgen fallen keine Kosten für den Azure Stream Analytics-Dienst an. Es muss keine Stream Analytics-Ressource in Azure erstellt werden.

Erste Schritte

Informieren Sie sich anhand dieser Schnellstartanleitung, wie Sie mithilfe von Visual Studio Code und ASA-Tools einen Stream Analytics-Auftrag erstellen.

Schritt-für-Schritt-Tutorials zu lokalen Ausführungen finden Sie hier:

Nächste Schritte