Freigeben über


Migrieren von ASA-Projekten zu Visual Studio Code

Dieser Artikel enthält Anleitungen für Visual Studio-Benutzer, die Azure Stream Analytics (ASA)-Projekte zu Visual Studio Code (VS Code) migrieren. Beachten Sie, dass die ASA Tools-Erweiterung für Visual Studio nicht mehr verwaltet wird. Es wird empfohlen, die ASA-Tools-Erweiterung in VSCode für lokale Tests zu verwenden, bevor Sie einen ASA-Auftrag übermitteln und starten.

Wenn Sie über ein lokales ASA-Projekt in Visual Studio verfügen, führen Sie die folgenden Schritte aus, um Ihr ASA-Projekt an das Azure-Portal zu übermitteln.

Installieren Sie die Erweiterung für VS Code und die ASA-Tools

  1. Installieren von Visual Studio Code

  2. Öffnen Sie Visual Studio Code, wählen Sie "Erweiterungen " im linken Bereich aus, suchen Sie nach Stream Analytics , und wählen Sie " Installieren " in der Erweiterung "Azure Stream Analytics Tools " aus.

    Suchen nach Stream Analytics

  3. Überprüfen Sie nach der Installation der Erweiterung, ob Die Azure Stream Analytics-Tools in aktivierten Erweiterungen sichtbar sind.

  4. Wählen Sie das Azure-Symbol auf der Visual Studio Code-Aktivitätsleiste aus. Wählen Sie unter Stream Analytics auf der Seitenleiste die Option "Bei Azure anmelden" aus.

    Anmelden bei Azure in Visual Studio Code

  5. Wenn Sie angemeldet sind, wird Ihr Azure-Kontoname auf der Statusleiste in der unteren linken Ecke des Visual Studio Code-Fensters angezeigt.

Exportieren eines ASA-Auftrags und Öffnen in VS Code

Wenn Sie im Azure-Portal einen ASA-Auftrag erstellt haben, können Sie den ASA-Auftrag in VS Code auf Ihrem lokalen Computer exportieren. Zwei Möglichkeiten zum Exportieren eines ASA-Auftrags:

Option 1 – Exportieren aus dem Azure-Portal

  1. Melden Sie sich beim Azure-Portal an, und öffnen Sie Ihren ASA-Auftrag. Wählen Sie auf der Seite "Abfrage " die Option " In VS Code öffnen" aus, um den Auftrag zu exportieren.

    Screenshot des Azure-Portals mit dem Open in VS Code zum Starten von VS Code auf dem lokalen Computer.

  2. Wählen Sie einen Ordner aus, in den Sie das ASA-Projekt exportieren möchten.

  3. Anschließend wird automatisch ein ASA-Projekt erstellt und Ihrem Arbeitsbereich in VS Code hinzugefügt. Ein Ordner mit demselben Namen wie Ihr ASA-Auftrag sollte angezeigt werden.

    VS Code Export ASA-Projekt

  4. Ein Stream Analytics-Projekt besteht aus drei Ordnern: Eingaben, Ausgaben und Funktionen. Es verfügt außerdem über das Abfrageskript (*.asaql) , eine JobConfig.json-Datei, und eine asaproj.json-Konfigurationsdatei. Wenn Sie mehrere Eingabe- und Ausgabequellen für den Auftrag konfiguriert haben, werden JSON-Dateien für jede Quelle unter den Ordnern erstellt.

    VS-Codeeingaben und -Ausgabeordner

Option 2 : Exportieren eines ASA-Auftrags in VS-Code

  1. Wählen Sie das Azure-Symbol auf der VS-Code-Aktivitätsleiste aus. Suchen Sie das Abonnement, in dem Ihr ASA-Auftrag erstellt wird, und wählen Sie "Exportieren " aus, um den ASA-Auftrag zu exportieren.

    Exportieren eines ASA-Auftrags in VS Code

  2. Nachdem der Export abgeschlossen ist, sehen Sie ein ASA-Projekt, das in Ihrem Arbeitsbereich erstellt wurde.

    ASA-Auftrag im VS Code-Arbeitsbereich

  3. Wenn Ihr ASA-Auftrag mehrere Eingabe- und Ausgabequellen konfiguriert hat, erstellt er JSON-Dateien für jede Quelle unter den Ordnern "Eingaben" bzw. "Ausgabe" .

Ausführen eines ASA-Auftrags in VS Code

Nachdem ein ASA-Auftrag exportiert wurde, können Sie Die Abfrage auf dem lokalen Computer ausführen. Zur Eingabe können Daten aus lokalen Dateien oder Livequellen aufgenommen werden. Ausgabeergebnisse werden entweder als Dateien an einen lokalen Ordner oder an die Livesenken gesendet. Weitere Details finden Sie unter "Ausführen von Aufträgen lokal mit VS Code".

Führen Sie die folgenden Schritte aus, um Ihren Auftrag mit Liveeingabe auszuführen und Ausgabeergebnisse lokal zu speichern:

  1. Bevor Sie beginnen, installieren Sie .NET Core SDK , und starten Sie Visual Studio Code neu.

  2. Wechseln Sie zu. *.asaql-Datei , wählen Sie "Lokal ausführen" aus.

    Screenshot des Visual Studio-Codings mit

  3. Wählen Sie dann unter der Befehlspalette die Option " LiveEingabe und lokale Ausgabe verwenden " aus.

    Vscode-Befehlspalette

  4. Wenn Ihr Auftrag erfolgreich gestartet wurde, können Sie die Ausgabeergebnisse, das Auftragsdiagramm und die Metriken für Ihren ASA-Auftrag anzeigen.

    Screenshot der Visual Studio Code-Anwendung unter Verwendung der Funktionen

Weitere Details zum Debuggen finden Sie unter Debuggen von ASA-Abfragen lokal mithilfe des Auftragsdiagramms

Häufig gestellte Fragen

Wie migrieren Sie ein lokales ASA-Projekt von Visual Studio zu VS Code?

Wenn Sie ein lokales ASA-Projekt in Visual Studio haben und es noch nicht übermittelt haben, führen Sie die folgenden Schritte aus, um Ihr ASA-Projekt an Azure zu senden.

  1. Öffnen Sie Ihr ASA-Projekt in Visual Studio, und sie sollten die Ordner "Funktionen", "Eingaben" und "Ausgaben" im Projektmappen-Explorer anzeigen.

    VS-Projektmappen-Explorer

  2. Öffnen Sie das Skript (*.asaql), wählen Sie im Editor "An Azure senden" aus.

    VS Submit to Azure

  3. Wählen Sie " Neuen Azure Stream Analytics-Auftrag erstellen " aus, und geben Sie einen Auftragsnamen ein. Wählen Sie das Abonnement, die Ressourcengruppe und den Speicherort für das ASA-Projekt aus.

    VS-Projekt speichern

  4. Anschließend können Sie zum Azure-Portal wechseln und den ASA-Auftrag unter Ihrer Ressourcengruppe finden.

  5. Informationen zum Exportieren eines ASA-Auftrags in VS Code finden Sie hier.

Muss ich die Eingabe- und Ausgabequellen konfigurieren, nachdem ein ASA-Auftrag exportiert wurde?

Nein, wenn Ihr ASA-Auftrag mehrere Eingabe- und Ausgabequellen im Azure-Portal konfiguriert hat, erstellt er JSON-Dateien für jede Quelle unter den Ordnern.

Wie fügen Sie eine neue Eingabequelle in VS Code hinzu?

  1. Klicken Sie im Stream Analytics-Projekt mit der rechten Maustaste auf den Ordner "Eingaben". Wählen Sie anschließend ASA: Eingabe hinzufügen im Kontextmenü aus.

    vscode Eingabe hinzufügen

  2. Wählen Sie den Eingabetyp aus, und folgen Sie den Anweisungen zum Bearbeiten Ihrer EINGABE-JSON-Dateien.

    vscode-CodeLens: „Eingabe hinzufügen“

  3. Anschließend können Sie eine Vorschau von Daten anzeigen und überprüfen, ob die neue Eingabequelle hinzugefügt wird.

    Screenshot des Visual Studio Code mit Vorschaudaten.

Nächste Schritte

Weitere Informationen zu Azure Stream Analytics Tools für Visual Studio Code finden Sie in den folgenden Artikeln: