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.
    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.
    IoT Hub-Name MyASAIoTHub Wählen Sie einen Namen für Ihre IoT Hub-Instanz aus.

    Create an IoT Hub

  4. Klicken Sie auf Weiter: Set size and scale (Größe und Skalierung festlegen).

  5. Wählen Sie eine Option für Tarif und Skalierung aus. Legen Sie für diese Schnellstartanleitung den Tarif F1 – Free fest, 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.

    Size and scale your IoT Hub

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

  7. Klicken Sie in Ihrem IoT Hub-Navigationsmenü unter IoT-Geräte auf Hinzufügen. Fügen Sie eine Geräte-ID hinzu, und klicken Sie auf Speichern.

    Add a device to your IoT Hub

  8. Öffnen Sie das Gerät nach der Erstellung in der Liste IoT-Geräte. Kopieren Sie Verbindungszeichenfolge – Primärschlüssel zur späteren Verwendung in einen Editor.

    Copy IoT Hub device connection string

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. Klicken Sie dann zum Erstellen des Kontos auf Überprüfen + erstellen.

    Create storage account

  3. Wählen Sie nach der Erstellung des Speicherkontos im Bereich Übersicht die KachelBlobs aus.

    Storage account overview

  4. Wählen Sie auf der Seite Blob-Dienst die Option Container aus, und geben Sie einen Namen für Ihren Container (etwa container1) ein. Übernehmen Sie für Öffentliche Zugriffsebene die Option Private (no anonymous access) (Privat (kein anonymer Zugriff)), und wählen Sie OK aus.

    Create blob 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 Projektmappenname für Ihr Projekt ein, und klicken Sie auf OK.

    Create a Stream Analytics project

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

Azure Stream Analytics project elements

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.

    Configure input data

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 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.

    Configure output data

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 die Option Neuen Azure Stream Analytics-Auftrag erstellen, und geben Sie unter Auftragsname einen Namen ein. Wählen Sie die Werte für Abonnement, Ressourcengruppe und Standort aus, die Sie zu Beginn der Schnellstartanleitung verwendet haben.

    Submit job to Azure

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 Ausführen. In der Ausgabe sollten nun die Sensordaten und -nachrichten angezeigt werden, die an Ihre IoT Hub-Instanz gesendet werden.

    Raspberry Pi Azure IoT Online Simulator

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.

    Start Stream Analytics job

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

    Start job configuration

  3. Beachten Sie, dass der Status des Auftrags in Ausführen geändert wurde, und Eingabe-/Ausgabeereignisse vorhanden sind. Dies kann einige Minuten dauern.

    Running Stream Analytics job

  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.

    View results

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: