Quickstart: Een Azure Stream Analytics-taak maken met Bicep

Artikel
06/13/2024

In deze quickstart gebruikt u Bicep om een Azure Stream Analytics-taak te maken. Nadat de taak is gemaakt, valideert u de implementatie.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Vereisten

U hebt een Azure-abonnement nodig om dit artikel te voltooien. Maak gratis een account.

Het Bicep-bestand controleren

Het Bicep-bestand dat in deze quickstart wordt gebruikt, is afkomstig van Azure-quickstartsjablonen.

@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

De Azure-resource die is gedefinieerd in het Bicep-bestand is Microsoft.StreamAnalytics/StreamingJobs: maak een Azure Stream Analytics-taak.

Het Bicep-bestand implementeren

Sla het Bicep-bestand op als main.bicep op uw lokale computer.
Implementeer het Bicep-bestand met behulp van Azure CLI of Azure PowerShell.
- 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>
```
U moet waarden opgeven voor de volgende parameters:
- streamAnalyticsJobName: vervang <de taaknaam> door de naam van de Stream Analytics-taak. De naam kan alfanumerieke tekens en afbreekstreepjes bevatten en moet minimaal 3 tot 63 tekens lang zijn.
- numberOfStreamingUnits: Vervang <int> door het aantal streaming-eenheden. Toegestane waarden zijn: 1, 3, 6, 12, 18, 24, 30, 36, 42 en 48.
Notitie

Wanneer de implementatie is voltooid, ziet u een bericht waarin wordt aangegeven dat de implementatie is voltooid.

Geïmplementeerde resources bekijken

U kunt de Azure Portal gebruiken om de Azure Stream Analytics-taak te controleren of het volgende Azure CLI- of Azure PowerShell-script gebruiken om de resource weer te geven.

Azure-CLI

Gebruik Azure Portal, Azure CLI of Azure PowerShell om de geïmplementeerde resources in de resourcegroep weer te geven.

CLI
Powershell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Resources opschonen

Als u verder wilt gaan met volgende zelfstudies, kunt u deze resources laten staan. Als u de resourcegroep niet meer nodig hebt, verwijdert u deze. Hierdoor wordt ook de Azure Stream Analytics-taak verwijderd. Zo verwijdert u de resourcegroep met behulp van Azure CLI of Azure PowerShell:

CLI
Powershell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Volgende stappen

In deze quickstart hebt u een Azure Stream Analytics-taak gemaakt met bicep en de implementatie gevalideerd. Als u wilt weten hoe u uw eigen Bicep-bestanden maakt met Visual Studio Code, gaat u verder met het volgende artikel:

Quickstart: Bicep-bestanden maken met Visual Studio Code

Delen via