Schnellstart: Erstellen eines Azure Stream Analytics-Auftrags mithilfe von Visual StudioQuickstart: Create an Azure Stream Analytics job by using 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.This quickstart shows you how to create and run a Stream Analytics job using Azure Stream Analytics tools for Visual Studio. Der Beispielauftrag liest Streamingdaten von einem IoT Hub-Gerät.The example job reads streaming data from an IoT Hub device. 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.You define a job that calculates the average temperature when over 27° and writes the resulting output events to a new file in blob storage.

Hinweis

Visual Studio und Visual Studio Code Tools unterstützen keine Aufträge in den Regionen „China, Osten“, „China, Norden“, „Deutschland, Mitte“ oder „Deutschland, Nordosten“.Visual Studio and Visual Studio Code tools don't support jobs in the China East, China North, Germany Central, and Germany NorthEast regions.

VoraussetzungenBefore you begin

  • Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.If you don't have an Azure subscription, create a free account.

  • Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

  • Installieren Sie Visual Studio 2019, Visual Studio 2015 oder Visual Studio 2013 Update 4.Install Visual Studio 2019, Visual Studio 2015, or Visual Studio 2013 Update 4. Die Editionen Enterprise (Ultimate/Premium), Professional und Community werden unterstützt.Enterprise (Ultimate/Premium), Professional, and Community editions are supported. Die Express Edition wird nicht unterstützt.Express edition is not supported.

  • Befolgen Sie die Installationsanweisungen für die Stream Analytics-Tools für Visual Studio.Follow the installation instructions to install Stream Analytics tools for Visual Studio.

Vorbereiten der EingabedatenPrepare the input data

Vor dem Definieren des Stream Analytics-Auftrags sollten Sie die Daten vorbereiten, die später als Auftragseingabe konfiguriert werden.Before defining the Stream Analytics job, you should prepare the data, which is later configured as the job input. Führen Sie die folgenden Schritte aus, um die für den Auftrag erforderlichen Eingabedaten vorzubereiten:To prepare the input data required by the job, complete the following steps:

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

  2. Wählen Sie Ressource erstellen > Internet der Dinge (IoT) > IoT Hub aus.Select Create a resource > Internet of Things > IoT Hub.

  3. Geben Sie im Bereich IoT Hub die folgenden Informationen ein:In the IoT Hub pane, enter the following information:

    EinstellungSetting Empfohlener WertSuggested value BeschreibungDescription
    SubscriptionSubscription <Your subscription> Wählen Sie das gewünschte Azure-Abonnement aus.Select the Azure subscription that you want to use.
    Resource groupResource group asaquickstart-resourcegroupasaquickstart-resourcegroup Wählen Sie Neu erstellen aus, und geben Sie einen neuen Ressourcengruppennamen für Ihr Konto ein.Select Create New and enter a new resource-group name for your account.
    RegionRegion <Select the region that is closest to your users> Wählen Sie einen geografischen Standort aus, an dem Sie Ihre IoT Hub-Instanz hosten können.Select a geographic location where you can host your IoT Hub. Verwenden Sie den Standort, der Ihren Benutzern am nächsten ist.Use the location that's closest to your users.
    IoT Hub-NameIoT Hub Name MyASAIoTHubMyASAIoTHub Wählen Sie einen Namen für Ihre IoT Hub-Instanz aus.Select a name for your IoT Hub.

    Erstellen eines IoT Hubs

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

  5. Wählen Sie eine Option für Tarif und Skalierung aus.Choose your Pricing and scale tier. Legen Sie für diese Schnellstartanleitung den Tarif F1 – Free fest, wenn er für Ihr Abonnement noch verfügbar ist.For this quickstart, select the F1 - Free tier if it's still available on your subscription. Falls der Tarif „Free“ nicht verfügbar ist, sollten Sie den niedrigsten verfügbaren Tarif wählen.If the free tier is unavailable, choose the lowest tier available. Weitere Informationen finden Sie unter IoT Hub – Preise.For more information, see IoT Hub pricing.

    Festlegen der Größe und Skalieren Ihrer IoT Hub-Instanz

  6. Klicken Sie auf Überprüfen + erstellen.Select Review + create. Überprüfen Sie die Informationen zu IoT Hub, und klicken Sie auf Erstellen.Review your IoT Hub information and click Create. Die Erstellung der IoT Hub-Instanz kann mehrere Minuten dauern.Your IoT Hub might take a few minutes to create. Sie können den Fortschritt im Bereich Benachrichtigungen überwachen.You can monitor the progress in the Notifications pane.

  7. Klicken Sie in Ihrem IoT Hub-Navigationsmenü unter IoT-Geräte auf Hinzufügen.In your IoT Hub navigation menu, click Add under IoT devices. Fügen Sie eine Geräte-ID hinzu, und klicken Sie auf Speichern.Add a Device ID and click Save.

    Hinzufügen eines Geräts zu Ihrer IoT Hub-Instanz

  8. Öffnen Sie das Gerät nach der Erstellung in der Liste IoT-Geräte.Once the device is created, open the device from the IoT devices list. Kopieren Sie Verbindungszeichenfolge – Primärschlüssel zur späteren Verwendung in einen Editor.Copy the Connection string -- primary key and save it to a notepad to use later.

    Kopieren der Verbindungszeichenfolge für das IoT Hub-Gerät

Erstellen eines BlobspeichersCreate blob storage

  1. Klicken Sie in der linken oberen Ecke des Azure-Portals auf Ressource erstellen > Speicher > Speicherkonto.From the upper left-hand corner of the Azure portal, select Create a resource > Storage > Storage account.

  2. Geben Sie im Bereich Speicherkonto erstellen einen Speicherkontonamen, den Standort und die Ressourcengruppe ein.In the Create storage account pane, enter a storage account name, location, and resource group. Wählen Sie den gleichen Standort und die gleiche Ressourcengruppe wie für die von Ihnen erstellte IoT Hub-Instanz.Choose the same location and resource group as the IoT Hub you created. Klicken Sie dann zum Erstellen des Kontos auf Überprüfen + erstellen.Then click Review + create to create the account.

    Speicherkonto erstellen

  3. Wählen Sie nach der Erstellung des Speicherkontos im Bereich Übersicht die Kachel Blobs aus.Once your storage account is created, select the Blobs tile on the Overview pane.

    Speicherkontoübersicht

  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.From the Blob Service page, select Container and provide a name for your container, such as container1. Übernehmen Sie für Öffentliche Zugriffsebene die Option Private (no anonymous access) (Privat (kein anonymer Zugriff)), und wählen Sie OK aus.Leave the Public access level as Private (no anonymous access) and select OK.

    Erstellen eines Blobcontainers

Erstellen eines Stream Analytics-ProjektsCreate a Stream Analytics project

  1. Starten Sie Visual Studio.Start Visual Studio.

  2. Wählen Sie Datei > Neues Projekt aus.Select File > New Project.

  3. Wählen Sie in der Vorlagenliste links Stream Analytics und dann Azure Stream Analytics Application (Azure Stream Analytics-Anwendung) aus.In the templates list on the left, select Stream Analytics, and then select Azure Stream Analytics Application.

  4. Geben Sie Name, Speicherort und Projektmappenname für Ihr Projekt ein, und klicken Sie auf OK.Input the project Name, Location, and Solution name, and select OK.

    Erstellen eines Stream Analytics-Projekts

Sehen Sie sich die Elemente an, die in einem Azure Stream Analytics-Projekt enthalten sind.Notice the elements that are included in an Azure Stream Analytics project.

Azure Stream Analytics project elements

Auswählen des erforderlichen AbonnementsChoose the required subscription

  1. Wählen Sie in Visual Studio im Menü Ansicht den Server-Explorer aus.In Visual Studio, on the View menu, select Server Explorer.

  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.Right click on Azure, select Connect to Microsoft Azure Subscription, and then sign in with your Azure account.

Festlegen der EingabeDefine input

  1. Erweitern Sie im Projektmappen-Explorer den Knoten Eingaben, und doppelklicken Sie auf Input.json.In Solution Explorer, expand the Inputs node and double-click Input.json.

  2. Fügen Sie unter Stream Analytics Input Configuration (Stream Analytics-Eingabekonfiguration) die folgenden Werte ein:Fill out the Stream Analytics Input Configuration with the following values:

    EinstellungSetting Empfohlener WertSuggested value BeschreibungDescription
    EingabealiasInput Alias EingabeInput Geben Sie einen Namen zur Identifizierung der Auftragseingabe ein.Enter a name to identify the job’s input.
    QuellentypSource Type DatenstromData Stream Wählen Sie die geeignete Eingabequelle aus: Datenstrom oder Referenzdaten.Choose the appropriate input source: Data Stream or Reference Data.
    SourceSource IoT HubIoT Hub Wählen Sie die geeignete Eingabequelle aus.Choose the appropriate input source.
    ResourceResource Datenquelle aus aktuellem Konto wählenChoose data source from current account Geben Sie Daten entweder manuell ein, oder wählen Sie ein vorhandenes Konto aus.Choose to enter data manually or select an existing account.
    SubscriptionSubscription <Your subscription> Wählen Sie das Azure-Abonnement aus, in dem sich die erstellte IoT Hub-Instanz befindet.Select the Azure subscription that has the IoT Hub you created.
    IoT HubIoT Hub MyASAIoTHubMyASAIoTHub Wählen Sie den Namen Ihrer IoT Hub-Instanz aus, oder geben Sie ihn ein.Choose or enter the name of your IoT Hub. IoT Hub-Namen werden automatisch erkannt, wenn sie unter demselben Abonnement erstellt werden.IoT Hub names are automatically detected if they are created in the same subscription.
  3. Übernehmen Sie für die anderen Optionen die Standardwerte, und klicken Sie zum Speichern der Einstellungen auf Speichern.Leave other options to default values and select Save to save the settings.

    Konfigurieren der Eingabedaten

Definieren der AusgabeDefine output

  1. Erweitern Sie im Projektmappen-Explorer den Knoten Ausgaben, und doppelklicken Sie auf Output.json.In Solution Explorer, expand the Outputs node and double-click Output.json.

  2. Fügen Sie unter Stream Analytics Output Configuration (Stream Analytics-Ausgabekonfiguration) die folgenden Werte ein:Fill out the Stream Analytics Output Configuration with the following values:

    EinstellungSetting Empfohlener WertSuggested value BeschreibungDescription
    AusgabealiasOutput Alias OutputOutput Geben Sie einen Namen zur Identifizierung der Auftragsausgabe ein.Enter a name to identify the job’s output.
    SenkeSink Blob StorageBlob Storage Wählen Sie die geeignete Senke aus.Choose the appropriate sink.
    ResourceResource Geben Sie die Datenquelleneinstellungen manuell an.Provide data source settings manually Geben Sie Daten entweder manuell ein, oder wählen Sie ein vorhandenes Konto aus.Choose to enter data manually or select an existing account.
    SubscriptionSubscription <Your subscription> Wählen Sie das Azure-Abonnement mit dem von Ihnen erstellten Speicherkonto aus.Select the Azure subscription that has the storage account you created. Das Speicherkonto kann sich im gleichen oder in einem anderen Abonnement befinden.The storage account can be in the same or in a different subscription. In diesem Beispiel wird davon ausgegangen, dass Sie ein Speicherkonto im gleichen Abonnement erstellt haben.This example assumes that you have created storage account in the same subscription.
    SpeicherkontoStorage Account asaquickstartstorageasaquickstartstorage Wählen Sie den Namen des Speicherkontos aus, oder geben Sie ihn ein.Choose or enter the name of the storage account. Speicherkontonamen werden automatisch erkannt, wenn sie im gleichen Abonnement erstellt werden.Storage account names are automatically detected if they are created in the same subscription.
    ContainerContainer container1container1 Wählen Sie den vorhandenen Container aus, den Sie in Ihrem Speicherkonto erstellt haben.Select the existing container that you created in your storage account.
    PfadmusterPath Pattern outputoutput Geben Sie den Namen eines Dateipfads ein, der innerhalb des Containers erstellt werden soll.Enter the name of a file path to be created within the container.
  3. Übernehmen Sie für die anderen Optionen die Standardwerte, und klicken Sie zum Speichern der Einstellungen auf Speichern.Leave other options to default values and select Save to save the settings.

    Konfigurieren von Ausgabedaten

Definieren der TransformationsabfrageDefine the transformation query

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

  2. Fügen Sie die folgende Abfrage hinzu:Add the following query:

    SELECT *
    INTO Output
    FROM Input
    HAVING Temperature > 27
    

Übermitteln einer Stream Analytics-Abfrage an AzureSubmit a Stream Analytics query to Azure

  1. Wählen Sie im Abfrage-Editor im Skript-Editor die Option An Azure übermitteln aus.In the Query Editor, select Submit To Azure in the script editor.

  2. Wählen Sie die Option Neuen Azure Stream Analytics-Auftrag erstellen, und geben Sie unter Auftragsname einen Namen ein.Select Create a New Azure Stream Analytics job and enter a Job Name. Wählen Sie die Werte für Abonnement, Ressourcengruppe und Standort aus, die Sie zu Beginn der Schnellstartanleitung verwendet haben.Choose the Subscription, Resource Group, and Location you used at the beginning of the Quickstart.

    Übermitteln des Auftrags an Azure

Ausführen des IoT-SimulatorsRun the IoT simulator

  1. Öffnen Sie den Raspberry Pi Azure IoT Online Simulator über eine neue Browserregisterkarte oder ein neues Fenster.Open the Raspberry Pi Azure IoT Online Simulator in a new browser tab or window.

  2. Ersetzen Sie den Platzhalter in Zeile 15 durch die zuvor gespeicherte Verbindungszeichenfolge für das Azure IoT Hub-Gerät.Replace the placeholder in Line 15 with the Azure IoT Hub device connection string you saved in a previous section.

  3. Klicken Sie auf Ausführen.Click Run. In der Ausgabe sollten nun die Sensordaten und -nachrichten angezeigt werden, die an Ihre IoT Hub-Instanz gesendet werden.The output should show the sensor data and messages that are being sent to your IoT Hub.

    Raspberry Pi-Azure IoT-Onlinesimulator

Starten des Stream Analytics-Auftrags und Überprüfen der AusgabeStart the Stream Analytics job and check output

  1. Wenn Ihr Auftrag erstellt wird, wird die Auftragsansicht automatisch geöffnet.When your job is created, the job view opens automatically. Klicken Sie zum Starten des Auftrags auf die Schaltfläche mit dem grünen Pfeil.Select the green arrow button to start the job,

    Starten des Stream Analytics-Auftrags

  2. Ändern Sie den Startmodus der Auftragsausgabe in JobStartTime, und wählen Sie Start.Change the Job output start mode to JobStartTime and select Start.

    Starten der Auftragskonfiguration

  3. Beachten Sie, dass der Status des Auftrags in Ausführen geändert wurde, und Eingabe-/Ausgabeereignisse vorhanden sind.Note the job status has changed to Running, and there are input/output events. Dies kann einige Minuten dauern.This may take a few minutes.

    Ausführen des Stream Analytics-Auftrags

  4. Klicken Sie zum Anzeigen der Ergebnisse im Menü Ansicht auf Cloud-Explorer, und navigieren Sie zum Speicherkonto in Ihrer Ressourcengruppe.To view results, on the View menu, select Cloud Explorer, and navigate to the storage account in your resource group. Doppelklicken Sie unter Blobcontainer auf container1 und dann auf den Dateipfad der Ausgabe.Under Blob Containers, double-click container1, and then the output file path.

    Anzeigen der Ergebnisse

Bereinigen von RessourcenClean up resources

Löschen Sie die Ressourcengruppe, den Streamingauftrag und alle dazugehörigen Ressourcen, wenn Sie sie nicht mehr benötigen.When no longer needed, delete the resource group, the streaming job, and all related resources. Durch das Löschen des Auftrags verhindern Sie, dass Kosten für die vom Auftrag verbrauchten Streamingeinheiten anfallen.Deleting the job avoids billing the streaming units consumed by the job. Wenn Sie den Auftrag in Zukunft verwenden möchten, können Sie ihn beenden und später bei Bedarf neu starten.If you're planning to use the job in future, you can stop it and restart it later when you need. Wenn Sie diesen Auftrag nicht mehr verwenden möchten, löschen Sie alle Ressourcen, die im Rahmen dieser Schnellstartanleitung erstellt wurden:If you are not going to continue to use this job, delete all resources created by this quickstart by using the following steps:

  1. Klicken Sie im Azure-Portal im Menü auf der linken Seite auf Ressourcengruppen und dann auf den Namen der erstellten Ressource.From the left-hand menu in the Azure portal, select Resource groups and then select the name of the resource you created.

  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.On your resource group page, select Delete, type the name of the resource to delete in the text box, and then select Delete.

Nächste SchritteNext steps

In dieser Schnellstartanleitung haben Sie einen einfachen Stream Analytics-Auftrag mit Visual Studio bereitgestellt.In this quickstart, you deployed a simple Stream Analytics job using Visual Studio. Stream Analytics-Aufträge können auch mit dem Azure-Portal und PowerShell bereitgestellt werden.You can also deploy Stream Analytics jobs using the Azure portal and PowerShell.

Informationen zu den Azure Stream Analytics-Tools für Visual Studio finden Sie im folgenden Artikel:To learn about Azure Stream Analytics tools for Visual Studio, continue to the following article: