Snabbstart: Skapa ett Azure Stream Analytics-jobb med Bicep

  • Artikel

I den här snabbstarten använder du Bicep för att skapa ett Azure Stream Analytics-jobb. När jobbet har skapats verifierar du distributionen.

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. Det ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder den bästa redigeringsupplevelsen för dina infrastruktur-som-kod-lösningar i Azure.

Förutsättningar

För att kunna slutföra den här artikeln måste du ha en Azure-prenumeration. Skapa en kostnadsfritt.

Granska Bicep-filen

Bicep-filen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

@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

Azure-resursen som definieras i Bicep-filen är Microsoft.StreamAnalytics/StreamingJobs: skapa ett Azure Stream Analytics-jobb.

Distribuera Bicep-filen

  1. Spara Bicep-filen som main.bicep på den lokala datorn.

  2. Distribuera Bicep-filen med antingen Azure CLI eller Azure 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>

    Du måste ange värden för följande parametrar:

    • streamAnalyticsJobName: Ersätt <jobbnamn> med Stream Analytics-jobbnamnet. Namnet kan innehålla alfanumeriska tecken och bindestreck och måste vara minst 3–63 tecken långt.
    • numberOfStreamingUnits: Ersätt <int> med antalet strömningsenheter. Tillåtna värden är: 1, 3, 6, 12, 18, 24, 30, 36, 42 och 48.

    Anteckning

    När distributionen är klar bör du se ett meddelande som anger att distributionen lyckades.

Granska distribuerade resurser

Du kan antingen använda Azure Portal för att kontrollera Azure Stream Analytics-jobbet eller använda följande Azure CLI- eller Azure PowerShell-skript för att lista resursen.

Azure CLI

Använd Azure Portal, Azure CLI eller Azure PowerShell för att lista de distribuerade resurserna i resursgruppen.

az resource list --resource-group exampleRG

Rensa resurser

Om du planerar att fortsätta med efterföljande självstudier kanske du vill lämna resurserna på plats. Ta bort resursgruppen när den inte längre behövs, vilket tar bort Azure Stream Analytics-jobbet. Så här tar du bort resursgruppen med hjälp av Azure CLI eller Azure PowerShell:

az group delete --name exampleRG

Nästa steg

I den här snabbstarten skapade du ett Azure Stream Analytics-jobb med Bicep och verifierade distributionen. Om du vill lära dig hur du skapar egna Bicep-filer med Hjälp av Visual Studio Code fortsätter du till följande artikel:

Snabbstart: Skapa Bicep-filer med Visual Studio Code