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

  • Artykuł

W tym przewodniku Szybki start utworzysz zadanie usługi Azure Stream Analytics za pomocą narzędzia 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 rozwiązań infrastruktury jako kodu na platformie Azure.

Wymagania wstępne

Aby ukończyć ten artykuł, musisz mieć subskrypcję platformy Azure. Utwórz je 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 programu 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>

    Musisz podać wartości dla następujących parametrów:

    • streamAnalyticsJobName: zastąp <nazwę zadania nazwą> zadania usługi Stream Analytics. Nazwa może zawierać znaki alfanumeryczne i łączniki i musi mieć długość co najmniej 3–63 znaków.
    • numberOfStreamingUnits: zastąp <wartość 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ć witryny Azure Portal, aby sprawdzić zadanie usługi Azure Stream Analytics lub użyć następującego interfejsu wiersza polecenia platformy Azure lub skryptu programu Azure PowerShell, aby wyświetlić listę zasobów.

Interfejs wiersza polecenia platformy Azure

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

az resource list --resource-group exampleRG

Czyszczenie zasobów

Jeśli planujesz kontynuować korzystanie z kolejnych samouczków, możesz pozostawić te zasoby na miejscu. Gdy grupa zasobów nie jest już potrzebna, usuń grupę zasobów, która usuwa zadanie usługi Azure Stream Analytics. Aby usunąć grupę zasobów przy użyciu interfejsu wiersza polecenia platformy Azure lub programu 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 narzędzia Bicep i sprawdzono wdrożenie. Aby dowiedzieć się, jak utworzyć własne pliki Bicep przy użyciu programu Visual Studio Code, przejdź do następującego artykułu:

Szybki start: tworzenie plików Bicep za pomocą programu Visual Studio Code