Schnellstart: Erstellen eines Azure Stream Analytics-Auftrags mithilfe von Bicep

Artikel
06/01/2023

In diesem Schnellstart verwenden Sie Bicep zum Erstellen eines Azure Stream Analytics-Auftrags. Nachdem der Auftrag erstellt wurde, überprüfen Sie die Bereitstellung.

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Voraussetzungen

Für diesen Artikel benötigen Sie ein Azure-Abonnement. Erstellen Sie ein kostenloses Konto.

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

@description('Location for the resources.')
param location string = resourceGroup().location

@description('Stream Analytics Job Name, can contain alphanumeric characters and hypen and must be 3-63 characters long')
@minLength(3)
@maxLength(63)
param streamAnalyticsJobName string

@description('You can choose the number of Streaming Units, ranging from 3, 7, 10, 20, 30, in multiples of 10, and continuing up to 660.')
@minValue(3)
@maxValue(660)

param numberOfStreamingUnits int

resource streamingJob 'Microsoft.StreamAnalytics/streamingjobs@2021-10-01-preview' = {
  name: streamAnalyticsJobName
  location: location
  properties: {
    sku: {
      name: 'StandardV2'
    }
    outputErrorPolicy: 'Stop'
    eventsOutOfOrderPolicy: 'Adjust'
    eventsOutOfOrderMaxDelayInSeconds: 0
    eventsLateArrivalMaxDelayInSeconds: 5
    dataLocale: 'en-US'
    transformation: {
      name: 'Transformation'
      properties: {
        streamingUnits: numberOfStreamingUnits
        query: 'SELECT\r\n    *\r\nINTO\r\n    [YourOutputAlias]\r\nFROM\r\n    [YourInputAlias]'
      }
    }
  }
}

output location string = location
output name string = streamingJob.name
output resourceGroupName string = resourceGroup().name
output resourceId string = streamingJob.id

Die in der Bicep-Datei definierte Azure-Ressource ist Microsoft.StreamAnalytics/StreamingJobs: Erstellen eines Azure Stream Analytics-Auftrags.

Bereitstellen der Bicep-Datei

Speichern Sie die Bicep-Datei als main.bicep auf Ihrem lokalen Computer.
Stellen Sie die Bicep-Datei entweder mit Azure CLI oder mit Azure PowerShell bereit.
- BEFEHLSZEILENSCHNITTSTELLE (CLI)
- PowerShell
```
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters streamAnalyticsJobName =<job-name> numberOfStreamingUnits=<int>
```
```
New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -streamAnalyticsJobName "<job-name>" -numberOfStreamingUnits <int>
```
Sie müssen Werte für die folgenden Parameter bereitstellen:
- streamAnalyticsJobName: Ersetzen Sie <job-name> durch den Namen des Stream Analytics-Auftrags. Der Name kann alphanumerische Zeichen und Bindestriche enthalten und muss zwischen 3 und 63 Zeichen lang sein.
- numberOfStreamingUnits: Ersetzen Sie <int> durch die Anzahl der Streamingeinheiten. Zulässige Werte sind: 1, 3, 6, 12, 18, 24, 30, 36, 42 und 48.
Hinweis

Nach Abschluss der Bereitstellung sollte eine Meldung mit dem Hinweis angezeigt werden, dass die Bereitstellung erfolgreich war.

Überprüfen der bereitgestellten Ressourcen

Sie können entweder das Azure-Portal nutzen, um den Azure Stream Analytics-Auftrag zu überprüfen, oder das unten angegebene Azure CLI- oder Azure PowerShell-Skript, um die Ressource aufzulisten.

Azure CLI

Verwenden Sie das Azure-Portal, die Azure CLI oder Azure PowerShell, um die bereitgestellten Ressourcen in der Ressourcengruppe aufzulisten.

BEFEHLSZEILENSCHNITTSTELLE (CLI)
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Bereinigen von Ressourcen

Falls Sie mit weiteren Tutorials fortfahren möchten, empfiehlt es sich ggf., diese Ressourcen nicht zu bereinigen. Wenn Sie die Ressourcen nicht mehr benötigen, löschen Sie die Ressourcengruppe. Dadurch wird auch der Azure Stream Analytics-Auftrag gelöscht. Die Ressourcengruppe kann über die Azure-Befehlszeilenschnittstelle oder mithilfe von Azure PowerShell gelöscht werden:

BEFEHLSZEILENSCHNITTSTELLE (CLI)
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Nächste Schritte

In dieser Schnellstartanleitung haben Sie mithilfe von Bicep einen Azure Stream Analytics-Auftrag erstellt und die Bereitstellung überprüft. Um zu erfahren, wie Sie eigene Bicep-Dateien mit Visual Studio Code erstellen, fahren Sie mit dem folgenden Artikel fort:

Schnellstart: Erstellen von Bicep-Dateien mit Visual Studio Code

Freigeben über