Freigeben über


Schnellstart: Erstellen eines Azure Stream Analytics-Auftrags mithilfe von Visual Studio

In dieser Schnellstartanleitung wird gezeigt, wie Sie mithilfe der Azure Stream Analytics-Tools für Visual Studio einen Stream Analytics-Auftrag erstellen und ausführen. Der Beispielauftrag liest Streamingdaten von einem IoT Hub-Gerät. Sie legen einen Auftrag fest, der bei Überschreitung von 27 Grad die Durchschnittstemperatur berechnet und die entsprechenden Ausgabeereignisse in eine neue Datei im Blobspeicher schreibt.

Hinweis

  • Es wird dringend empfohlen, Stream Analytics-Tools für Visual Studio Code zu verwenden, um eine optimale lokale Entwicklungserfahrung zu gewährleisten. Es gibt bekannte Funktionslücken in Stream Analytics-Tools für Visual Studio 2019 (Version 2.6.3000.0), und die Version wird in Zukunft nicht verbessert.
  • Visual Studio und Visual Studio Code Tools unterstützen keine Aufträge in den Regionen „China, Osten“, „China, Norden“, „Deutschland, Mitte“ oder „Deutschland, Nordosten“.

Voraussetzungen

  • Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.

  • Melden Sie sich beim Azure-Portal an.

  • Installieren Sie Visual Studio 2019, Visual Studio 2015 oder Visual Studio 2013 Update 4. Die Editionen Enterprise (Ultimate/Premium), Professional und Community werden unterstützt. Die Express-Edition wird nicht unterstützt.

  • Befolgen Sie die Installationsanweisungen für die Stream Analytics-Tools für Visual Studio.

Vorbereiten der Eingabedaten

Vor dem Definieren des Stream Analytics-Auftrags sollten Sie die Daten vorbereiten, die später als Auftragseingabe konfiguriert werden. Führen Sie die folgenden Schritte aus, um die für den Auftrag erforderlichen Eingabedaten vorzubereiten:

  1. Melden Sie sich beim Azure-Portal an.

  2. Wählen Sie Ressource erstellen>Internet der Dinge (IoT)>IoT Hub aus.

  3. Geben Sie im Bereich IoT Hub die folgenden Informationen ein:

    Einstellung Empfohlener Wert Beschreibung
    Subscription <Ihr Abonnement> Wählen Sie das gewünschte Azure-Abonnement aus.
    Resource group asaquickstart-resourcegroup Wählen Sie Neu erstellen aus, und geben Sie einen neuen Ressourcengruppennamen für Ihr Konto ein.
    IoT Hub-Name MyASAIoTHub Wählen Sie einen Namen für Ihre IoT Hub-Instanz aus.
    Region <Die Region, die Ihren Benutzern am nächsten liegt> Wählen Sie einen geografischen Standort aus, an dem Sie Ihre IoT Hub-Instanz hosten können. Verwenden Sie den Standort, der Ihren Benutzern am nächsten ist.
    Tarif Kostenlos Wählen Sie für diesen Schnellstart Free aus, wenn er für Ihr Abonnement noch verfügbar ist. Falls der Tarif „Free“ nicht verfügbar ist, sollten Sie den niedrigsten verfügbaren Tarif wählen. Weitere Informationen finden Sie unter IoT Hub – Preise.

    Screenshot zeigt den Assistenten „IoT Hub erstellen“ im Azure-Portal.

  4. Klicken Sie auf Überprüfen + erstellen. Überprüfen Sie die Informationen zu IoT Hub, und wählen Sie Erstellen aus. Die Erstellung der IoT Hub-Instanz kann mehrere Minuten dauern. Sie können den Fortschritt im Bereich Benachrichtigungen überwachen.

  5. Nachdem die Bereitstellung abgeschlossen ist, wählen Sie Zu Ressource wechseln aus, um zur IoT Hub-Seite für Ihren IoT-Hub zu navigieren.

  6. Wählen Sie auf der Seite IoT Hub im linken Navigationsmenü unter Geräteverwaltung die Option Geräte aus.

  7. Wählen Sie auf der Seite Geräte auf der Symbolleiste die Option + Gerät hinzufügen aus.

    Screenshot zeigt die Seite „Geräte“ mit ausgewählter Option „Gerät hinzufügen“.

  8. Geben Sie auf der Seite Gerät erstellen einen Namen für das Gerät ein, und wählen Sie Speichern aus.

    Screenshot: Seite „Gerät erstellen“

  9. Öffnen Sie das Gerät nach der Erstellung in der Liste IoT-Geräte. Wenn Sie das Gerät noch nicht sehen, aktualisieren Sie die Seite.

    Screenshot zeigt die Geräteliste mit dem Gerät, das Sie erstellt haben.

  10. Kopieren Sie die Primäre Verbindungszeichenfolge, und speichern Sie diese zur späteren Verwendung in einem Notizbuch.

Erstellen eines Blobspeichers

  1. Klicken Sie in der linken oberen Ecke des Azure-Portals auf Ressource erstellen>Speicher>Speicherkonto.

  2. Geben Sie im Bereich Speicherkonto erstellen einen Speicherkontonamen, den Standort und die Ressourcengruppe ein. Wählen Sie den gleichen Standort und die gleiche Ressourcengruppe wie für die von Ihnen erstellte IoT Hub-Instanz. Wählen Sie dann zum Erstellen des Kontos Überprüfen + erstellen aus.

    Screenshot zeigt die Seite „Speicherkonto erstellen“ im Azure-Portal.

  3. Wählen Sie nach der Erstellung Ihres Speicherkontos im Bereich Übersicht die Kachel Blob-Dienst aus.

    Screenshot zeigt die Übersichtsseite „Speicherkonto“ mit der Option „Blob-Dienst“ ausgewählt.

  4. Klicken Sie auf der Seite Blob-Dienst auf der Symbolleiste auf + Container.

  5. Geben Sie auf der Seite Neuer Container einen Namen für Ihren Container ein, z. B. container1. Belassen Sie die Öffentliche Zugriffsebene auf Privat (kein anonymer Zugriff), und wählen Sie Erstellen aus.

    Screenshot: Seite „Neuer Container“.

Erstellen eines Stream Analytics-Projekts

  1. Starten Sie Visual Studio.

  2. Wählen Sie Datei > Neues Projekt aus.

  3. Wählen Sie in der Vorlagenliste links Stream Analytics und dann Azure Stream Analytics Application (Azure Stream Analytics-Anwendung) aus.

  4. Geben Sie Name, Speicherort und Lösungsname für Ihr Projekt ein, und wählen Sie Erstellen aus.

    Screenshot zeigt das Dialogfeld „Stream Analytics-Projekt erstellen.

  5. Sehen Sie sich die Elemente an, die in einem Azure Stream Analytics-Projekt enthalten sind.

    Screenshot zeigt das Fenster „Projektmappen-Explorer“ für ein Beispielprojekt einer Stream Analytics-Anwendung in Visual Studio.

Auswählen des erforderlichen Abonnements

  1. Wählen Sie in Visual Studio im Menü Ansicht den Server-Explorer aus.
  2. Klicken Sie mit der rechten Maustaste auf Azure, wählen Sie Verbindung mit Microsoft Azure-Abonnement herstellen aus, und melden Sie sich dann mit Ihrem Azure-Konto an.

Festlegen der Eingabe

  1. Erweitern Sie im Projektmappen-Explorer den Knoten Eingaben, und doppelklicken Sie auf Input.json.

  2. Fügen Sie unter Stream Analytics Input Configuration (Stream Analytics-Eingabekonfiguration) die folgenden Werte ein:

    Einstellung Empfohlener Wert Beschreibung
    Eingabealias Eingabe Geben Sie einen Namen zur Identifizierung der Auftragseingabe ein.
    Quellentyp Datenstrom Wählen Sie die geeignete Eingabequelle aus: Datenstrom oder Referenzdaten.
    `Source` IoT Hub Wählen Sie die geeignete Eingabequelle aus.
    Resource Datenquelle aus aktuellem Konto wählen Geben Sie Daten entweder manuell ein, oder wählen Sie ein vorhandenes Konto aus.
    Subscription <Ihr Abonnement> Wählen Sie das Azure-Abonnement aus, in dem sich die erstellte IoT Hub-Instanz befindet.
    IoT Hub MyASAIoTHub Wählen Sie den Namen Ihrer IoT Hub-Instanz aus, oder geben Sie ihn ein. IoT Hub-Namen werden automatisch erkannt, wenn sie unter demselben Abonnement erstellt werden.
  3. Übernehmen Sie für die anderen Optionen die Standardwerte, und klicken Sie zum Speichern der Einstellungen auf Speichern.

    Screenshot zeigt die Seite „Stream Analytics-Eingabekonfiguration“.

Definieren der Ausgabe

  1. Erweitern Sie im Projektmappen-Explorer den Knoten Ausgaben, und doppelklicken Sie auf Output.json.

  2. Fügen Sie unter Stream Analytics Output Configuration (Stream Analytics-Ausgabekonfiguration) die folgenden Werte ein:

    Einstellung Empfohlener Wert Beschreibung
    Ausgabealias Output Geben Sie einen Namen zur Identifizierung der Auftragsausgabe ein.
    Senke Data Lake Storage Gen 2/Blob Storage Wählen Sie die geeignete Senke aus.
    Resource Geben Sie die Datenquelleneinstellungen manuell an. Geben Sie Daten entweder manuell ein, oder wählen Sie ein vorhandenes Konto aus.
    Subscription <Ihr Abonnement> Wählen Sie das Azure-Abonnement mit dem von Ihnen erstellten Speicherkonto aus. Das Speicherkonto kann sich im gleichen oder in einem anderen Abonnement befinden. In diesem Beispiel wird davon ausgegangen, dass Sie ein Speicherkonto im gleichen Abonnement erstellt haben.
    Speicherkonto asaquickstartstorage Wählen Sie den Namen des Speicherkontos aus, oder geben Sie ihn ein. Speicherkontonamen werden automatisch erkannt, wenn sie im gleichen Abonnement erstellt werden.
    Container container1 Wählen Sie den vorhandenen Container aus, den Sie in Ihrem Speicherkonto erstellt haben.
    Pfadmuster output Geben Sie den Namen eines Dateipfads ein, der innerhalb des Containers erstellt werden soll.
  3. Übernehmen Sie für die anderen Optionen die Standardwerte, und klicken Sie zum Speichern der Einstellungen auf Speichern.

    Screenshot zeigt die Seite „Stream Analytics-Ausgabekonfiguration“.

Definieren der Transformationsabfrage

  1. Öffnen Sie im Projektmappen-Explorer von Visual Studio die Datei Script.asaql.

  2. Fügen Sie die folgende Abfrage hinzu:

    SELECT *
    INTO Output
    FROM Input
    WHERE Temperature > 27
    

Übermitteln einer Stream Analytics-Abfrage an Azure

  1. Wählen Sie im Abfrage-Editor im Skript-Editor die Option An Azure übermitteln aus.

  2. Wählen Sie im Fenster Auftrag übermitteln die Option Neuen Azure Stream Analytics-Auftrag erstellen aus.

  3. Geben Sie einen Auftragsnamen ein.

  4. Wählen Sie das Azure-Abonnement aus.

  5. Wählen Sie die Ressourcengruppe aus.

  6. Behalten Sie den Standardwert für Cluster bei.

  7. Wählen Sie den Speicherort aus, den Sie zu Beginn des Schnellstarts verwendeten.

  8. Klicken Sie dann auf Senden.

    Screenshot zeigt das Dialogfeld „Auftrag übermitteln“.

Ausführen des IoT-Simulators

  1. Öffnen Sie den Raspberry Pi Azure IoT Online Simulator über eine neue Browserregisterkarte oder ein neues Fenster.

  2. Ersetzen Sie den Platzhalter in Zeile 15 durch die zuvor gespeicherte Verbindungszeichenfolge für das Azure IoT Hub-Gerät.

  3. Klicken Sie auf Run (Ausführen). In der Ausgabe sollten nun die Sensordaten und -nachrichten angezeigt werden, die an Ihre IoT Hub-Instanz gesendet werden.

    Screenshot zeigt den Raspberry Pi Azure IoT-Onlinesimulator.

Starten des Stream Analytics-Auftrags und Überprüfen der Ausgabe

  1. Wenn Ihr Auftrag erstellt wird, wird die Auftragsansicht automatisch geöffnet. Klicken Sie zum Starten des Auftrags auf die Schaltfläche mit dem grünen Pfeil.

    Screenshot zeit die Schaltfläche „Start“ zum Starten eines Stream Analytics-Auftrags aus Visual Studio.

  2. Ändern Sie den Startmodus der Auftragsausgabe in JobStartTime, und wählen Sie Start.

    Screenshot zeigt das Dialogfeld „Konfiguration des Stream Analytics-Startauftrag.

  3. Beachten Sie, dass der Status des Auftrags in Ausführen geändert wurde, und Eingabe-/Ausgabeereignisse vorhanden sind. Dies kann einige Minuten dauern. Wählen Sie auf der Symbolleiste die Schaltfläche Aktualisieren aus, um Metriken zu aktualisieren.

    Screenshot zeigt den Auftragsstatus als „laufend“ und Metriken für den Auftrag.

  4. Klicken Sie zum Anzeigen der Ergebnisse im Menü Ansicht auf Cloud-Explorer, und navigieren Sie zum Speicherkonto in Ihrer Ressourcengruppe. Doppelklicken Sie unter Blobcontainer auf container1 und dann auf den Dateipfad der Ausgabe.

    Anzeigen der Ergebnisse

Bereinigen von Ressourcen

Löschen Sie die Ressourcengruppe, den Streamingauftrag und alle dazugehörigen Ressourcen, wenn Sie sie nicht mehr benötigen. Durch das Löschen des Auftrags verhindern Sie, dass Kosten für die vom Auftrag verbrauchten Streamingeinheiten anfallen. Wenn Sie den Auftrag in Zukunft verwenden möchten, können Sie ihn beenden und später bei Bedarf neu starten. Wenn Sie diesen Auftrag nicht mehr verwenden möchten, löschen Sie alle Ressourcen, die im Rahmen dieser Schnellstartanleitung erstellt wurden:

  1. Klicken Sie im Azure-Portal im Menü auf der linken Seite auf Ressourcengruppen und dann auf den Namen der erstellten Ressource.
  2. Klicken Sie auf der Seite mit Ihrer Ressourcengruppe auf Löschen, geben Sie im Textfeld den Namen der zu löschenden Ressource ein, und klicken Sie dann auf Löschen.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie einen einfachen Stream Analytics-Auftrag mit Visual Studio bereitgestellt. Stream Analytics-Aufträge können auch mit dem Azure-Portal und PowerShell bereitgestellt werden.

Informationen zu den Azure Stream Analytics-Tools für Visual Studio finden Sie im folgenden Artikel: