Guida introduttiva: Creare un processo di Analisi di flusso di Azure con Bicep

In questa guida introduttiva si usa Bicep per creare un processo di Analisi di flusso di Azure. Una volta creato il processo, è possibile convalidare la distribuzione.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, indipendenza dai tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

Prerequisiti

Per completare questo articolo, è necessario avere una sottoscrizione di Azure. È possibile crearne uno gratuitamente.

Esaminare il file Bicep

Il file Bicep usato in questo avvio rapido proviene dai modelli di avvio rapido di 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

La risorsa di Azure definita nel file Bicep è Microsoft.StreamAnalytics/StreamingJobs: creare un processo di Analisi di flusso di Azure.

Distribuire il file Bicep

  1. Salvare il file Bicep come main.bicep nel computer locale.

  2. Distribuire il file Bicep usando l'interfaccia della riga di comando di Azure o 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>
    

    È necessario specificare i valori per i parametri seguenti:

    • streamAnalyticsJobName: sostituire <job-name> con il nome del processo di Analisi di flusso. Il nome può contenere caratteri alfanumerici e trattini e deve contenere almeno 3-63 caratteri.
    • numberOfStreamingUnits: sostituire <int> con il numero di unità di streaming. I valori consentiti includono: 1, 3, 6, 12, 18, 24, 30, 36, 42 e 48.

    Nota

    Al termine della distribuzione, verrà visualizzato un messaggio che indica che la distribuzione è riuscita.

Esaminare le risorse distribuite

È possibile usare il portale di Azure per controllare il processo di Analisi di flusso di Azure oppure lo script dell'interfaccia della riga di comando di Azure o di Azure PowerShell seguente per elencare la risorsa.

Interfaccia della riga di comando di Azure

Usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per elencare le risorse distribuite nel gruppo di risorse.

az resource list --resource-group exampleRG

Pulire le risorse

Se si prevede di usare le esercitazioni successive, è consigliabile non cancellare le risorse create. Quando non è più necessario, eliminare il gruppo di risorse per eliminare il processo di Analisi di flusso di Azure. Per eliminare il gruppo di risorse con l'interfaccia della riga di comando di Azure oppure con Azure PowerShell:

az group delete --name exampleRG

Passaggi successivi

In questa guida introduttiva è stato creato un processo di Analisi di flusso di Azure usando Bicep e convalidato la distribuzione. Per informazioni su come creare file Bicep personalizzati con Visual Studio Code, continuare con l'articolo seguente: