Краткое руководство. Создание задания Azure Stream Analytics с помощью Bicep

  • Статья

В этом кратком руководстве показано, как с помощью Bicep создать задание Azure Stream Analytics. После создания задания необходимо проверить развертывание.

Bicep — это предметно-ориентированный язык (DSL), который использует декларативный синтаксис для развертывания ресурсов Azure. Он обеспечивает краткий синтаксис, надежную безопасность типов и поддержку повторного использования кода. Bicep предлагает лучшие возможности для разработки решений Azure типа "инфраструктура как код".

Необходимые компоненты

Для работы с этой статьей требуется подписка Azure. Создайте ее бесплатно.

Проверка BICEP-файла

Файл Bicep, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска 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

Ресурс Azure, определенный в файле Bicep — Microsoft.StreamAnalytics/StreamingJobs. Создайте задание Azure Stream Analytics.

Развертывание BICEP-файла

  1. Сохраните файл Bicep с именем main.bicep на локальном компьютере.

  2. Разверните файл Bicep с помощью Azure CLI или 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>

    Необходимо указать значения для следующих параметров:

    • streamAnalyticsJobName: замените <job-name> на имя задания Stream Analytics. Имя может содержать буквенно-цифровые символы и дефисы; его длина должна составлять от 3 до 63 символов.
    • numberOfStreamingUnits: замените <int> на количество единиц потоковой передачи. Допустимые значения: 1, 3, 6, 12, 18, 24, 30, 36, 42 и 48.

    Примечание.

    После завершения развертывания должно отобразиться сообщение о том, что развертывание успешно выполнено.

Просмотр развернутых ресурсов

Вы можете использовать портал Azure, чтобы проверить задание Azure Stream Analytics, а также следующие скрипты Azure CLI или Azure PowerShell, чтобы просмотреть ресурс.

Azure CLI

Используйте портал Azure, Azure CLI или Azure PowerShell для получения списка ресурсов, развернутых в группе ресурсов.

az resource list --resource-group exampleRG

Очистка ресурсов

Если вы планируете продолжить работу с последующими учебниками, эти ресурсы можно пока сохранить. Удалите ненужную группу ресурсов. Задание Azure Stream Analytics будет также удалено. Чтобы удалить группу ресурсов с помощью Azure CLI или Azure PowerShell, выполните следующие действия.

az group delete --name exampleRG

Следующие шаги

В этом кратком руководстве вы создали задание Azure Stream Analytics с помощью Bicep и проверили развертывание. Чтобы узнать, как создать собственные файлы Bicep с помощью Visual Studio Code, перейдите к следующей статье:

Краткое руководство. Создание файлов Bicep с помощью Visual Studio Code