Démarrage rapide : Créer un travail Azure Stream Analytics à l’aide d’un modèle ARM

Azure Stream Analytics est un service d’analyse en temps réel qui traite les données en flux provenant de sources telles que des appareils, capteurs et applications. Dans ce guide de démarrage rapide, vous utilisez un modèle Azure Resource Manager (modèle ARM) pour créer un travail Azure Stream Analytics. Après avoir créé le poste, vous validez le déploiement.

Un modèle Azure Resource Manager est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Vous décrivez votre déploiement prévu sans écrire la séquence de commandes de programmation pour créer le déploiement.

Si votre environnement remplit les prérequis et que vous êtes déjà familiarisé avec l’utilisation des modèles ARM, sélectionnez le bouton Déployer sur Azure. Le modèle s’ouvre dans le portail Azure.

Bouton pour déployer le modèle Resource Manager sur Azure.

Prérequis

Pour effectuer ce qui est décrit dans cet article, vous avez besoin de ce qui suit :

Vérifier le modèle

Ce guide de démarrage rapide utilise un modèle à partir de Azure modèles de démarrage rapide.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.26.54.24096",
      "templateHash": "8637009133184248358"
    }
  },
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for the resources."
      }
    },
    "streamAnalyticsJobName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 63,
      "metadata": {
        "description": "Stream Analytics Job Name, can contain alphanumeric characters and hypen and must be 3-63 characters long"
      }
    },
    "numberOfStreamingUnits": {
      "type": "int",
      "minValue": 3,
      "maxValue": 660,
      "metadata": {
        "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."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.StreamAnalytics/streamingjobs",
      "apiVersion": "2021-10-01-preview",
      "name": "[parameters('streamAnalyticsJobName')]",
      "location": "[parameters('location')]",
      "properties": {
        "sku": {
          "name": "StandardV2"
        },
        "outputErrorPolicy": "Stop",
        "eventsOutOfOrderPolicy": "Adjust",
        "eventsOutOfOrderMaxDelayInSeconds": 0,
        "eventsLateArrivalMaxDelayInSeconds": 5,
        "dataLocale": "en-US",
        "transformation": {
          "name": "Transformation",
          "properties": {
            "streamingUnits": "[parameters('numberOfStreamingUnits')]",
            "query": "SELECT\r\n    *\r\nINTO\r\n    [YourOutputAlias]\r\nFROM\r\n    [YourInputAlias]"
          }
        }
      }
    }
  ],
  "outputs": {
    "location": {
      "type": "string",
      "value": "[parameters('location')]"
    },
    "name": {
      "type": "string",
      "value": "[parameters('streamAnalyticsJobName')]"
    },
    "resourceGroupName": {
      "type": "string",
      "value": "[resourceGroup().name]"
    },
    "resourceId": {
      "type": "string",
      "value": "[resourceId('Microsoft.StreamAnalytics/streamingjobs', parameters('streamAnalyticsJobName'))]"
    }
  }
}

Le modèle définit la ressource suivante :

Déployer le modèle

Dans cette section, vous créez un emploi Azure Stream Analytics en utilisant le modèle ARM.

  1. Cliquez sur l’image ci-après pour vous connecter à Azure et ouvrir un modèle. Le modèle crée une tâche Azure Stream Analytics.

    Bouton pour déployer le modèle Resource Manager sur Azure.

  2. Spécifiez les valeurs requises pour créer votre tâche Azure Stream Analytics.

    Capture d’écran de la page de déploiement personnalisée du portail Azure montrant les champs de propriété pour créer un job Azure Stream Analytics à partir d’un modèle ARM.

    Renseignez les valeurs suivantes :

    Propriété Description
    Abonnement Sélectionnez votre abonnement Azure dans la liste déroulante.
    Groupe de ressources Indiquez si vous souhaitez créer un groupe de ressources Azure ou utiliser un groupe existant. Un groupe de ressources est un conteneur réunissant les ressources associées d’une solution Azure. Pour plus d’informations, consultez Présentation des groupes de ressources Azure.
    Région Sélectionnez USA Est. Pour les autres régions disponibles, consultez Disponibilité des services Azure par région.
    Nom de la tâche Stream Analytics Attribuez un nom à votre tâche Stream Analytics.
    Nombre d’unités de streaming Indiquez le nombre d’unités de streaming dont vous avez besoin. Pour plus d’informations, voir Comprendre et ajuster les unités de streaming.
  3. Sélectionnez Vérifier + créer, puis Créer.

Vérifier les ressources déployées

Utilisez soit le portail Azure pour vérifier le job Azure Stream Analytics, soit un script Azure CLI ou Azure PowerShell pour lister la ressource.

Portail Azure

À la fin du déploiement, sélectionnez Aller à la ressource pour accéder à la page du travail Stream Analytics.

Azure CLI

Utilisez la commande az stream-analytics job show pour obtenir des détails sur le travail créé. Remplacez les espaces réservés par l’ID de votre abonnement Azure, le nom du groupe de ressources et le nom du travail Stream Analytics.

az stream-analytics job show -s SUBSCRIPTIONID -g RESOURCEGROUPNAME -n ASAJOBNAME

Azure PowerShell

Utilisez la commande Get-AzStreamAnalyticsJob pour obtenir des détails sur le travail créé. Remplacez les espaces réservés par l’ID de votre abonnement Azure, le nom du groupe de ressources et le nom de la tâche Stream Analytics.

Get-AzStreamAnalyticsJob -SubscriptionID $subscriptionID -ResourceGroupName $resourceGroupName -Name $streamAnalyticsJobName

Nettoyer les ressources

Si vous prévoyez de continuer avec d’autres tutoriels, vous voudrez peut-être garder ces ressources. Quand vous n’avez plus besoin de ces ressources, supprimez le groupe de ressources. Supprimer le groupe de ressources supprime également le travail Azure Stream Analytics. Pour supprimer le groupe de ressources avec Azure CLI ou Azure PowerShell :

Azure CLI

az group delete --name RESOURCEGROUPNAME

Azure PowerShell

Remove-AzResourceGroup -Name RESOURCEGROUPNAME

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé une tâche Azure Stream Analytics à l’aide d’un modèle ARM et validé le déploiement. Passez à l’article suivant pour apprendre à exporter un modèle ARM pour un poste existant en utilisant VS Code.