Szybki start: tworzenie zadania usługi Azure Stream Analytics przy użyciu Bicep

W tym przewodniku Szybki start utworzysz zadanie usługi Azure Stream Analytics przy użyciu usługi Bicep. Po utworzeniu zadania należy zweryfikować wdrożenie.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Bicep oferuje najlepsze środowisko tworzenia dla rozwiązań infrastruktury jako kodu na platformie Azure.

Wymagania wstępne

Aby ukończyć ten artykuł, musisz mieć subskrypcję platformy Azure. Utwórz go bezpłatnie.

Przejrzyj plik Bicep

Plik Bicep używany w tym przewodniku Szybki start pochodzi z szablonów szybkiego startu platformy Azure.

@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

Zasób platformy Azure zdefiniowany w pliku Bicep to Microsoft.StreamAnalytics/StreamingJobs: tworzenie zadania usługi Azure Stream Analytics.

Wdrażanie pliku Bicep

  1. Zapisz plik Bicep jako main.bicep na komputerze lokalnym.

  2. Wdróż plik Bicep przy użyciu interfejsu wiersza polecenia platformy Azure lub 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>
    

    Należy podać wartości następujących parametrów:

    • streamAnalyticsJobName: zastąp <nazwę zadania nazwą> zadania usługi Stream Analytics. Nazwa może zawierać znaki alfanumeryczne i łączniki oraz musi mieć długość co najmniej 3–63 znaków.
    • numberOfStreamingUnits: zastąp <int> liczbą jednostek przesyłania strumieniowego. Dozwolone wartości to: 1, 3, 6, 12, 18, 24, 30, 36, 42 i 48.

    Uwaga

    Po zakończeniu wdrażania powinien zostać wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Przeglądanie wdrożonych zasobów

Możesz użyć Azure Portal, aby sprawdzić zadanie usługi Azure Stream Analytics lub użyć następującego interfejsu wiersza polecenia platformy Azure lub skryptu Azure PowerShell, aby wyświetlić listę zasobów.

Interfejs wiersza polecenia platformy Azure

Użyj Azure Portal, interfejsu wiersza polecenia platformy Azure lub Azure PowerShell, aby wyświetlić listę wdrożonych zasobów w grupie zasobów.

az resource list --resource-group exampleRG

Oczyszczanie zasobów

Jeśli planujesz kontynuować pracę z kolejnymi samouczkami, możesz pozostawić te zasoby na miejscu. Gdy grupa zasobów nie będzie już potrzebna, usuń zadanie usługi Azure Stream Analytics. Aby usunąć grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure lub Azure PowerShell:

az group delete --name exampleRG

Następne kroki

W tym przewodniku Szybki start utworzono zadanie usługi Azure Stream Analytics przy użyciu rozwiązania Bicep i zweryfikowano wdrożenie. Aby dowiedzieć się, jak tworzyć własne pliki Bicep przy użyciu Visual Studio Code, przejdź do następującego artykułu: