Créer un cluster et une base de données Azure Data Explorer avec Azure CLI

Azure Data Explorer est un service d’analytique données rapide et complètement managé pour l’analyse en temps réel de gros volumes de données diffusées en continu par des applications, des sites web, des appareils IoT, etc. Pour utiliser Azure Data Explorer, créez tout d’abord un cluster et une ou plusieurs bases de données dans ce cluster. Ensuite, ingérez (chargez) des données dans une base de données pour pouvoir exécuter des requêtes dessus. Dans cet article, vous créez un cluster et une base de données en utilisant Azure CLI.

Prérequis

Utiliser Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droit d’un bloc de code. La sélection de Essayer ne copie pas automatiquement le code dans Cloud Shell. Example of Try It for Azure Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur. Launch Cloud Shell in a new window.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure. Cloud Shell button in the Azure portal.

Pour exécuter le code de cet article dans Azure Cloud Shell :

  1. Démarrez Cloud Shell.

  2. Sélectionnez le bouton Copier dans un bloc de code pour copier le code.

  3. Collez le code dans la session Cloud Shell en sélectionnant CtrlMajV sur Windows et Linux, ou en sélectionnant CmdMajV sur macOS.

  4. Sélectionnez Entrée pour exécuter le code.

Configurer les paramètres CLI

Si vous choisissez d’installer et d’utiliser localement Azure CLI, cet article nécessite Azure CLI version 2.0.4 ou ultérieure. Exécutez az --version pour vérifier votre version. Si vous devez effectuer une installation ou une mise à niveau, consultez Installer Azure CLI.

Les étapes suivantes ne sont pas obligatoires si vous exécutez des commandes dans Azure Cloud Shell. Si vous utilisez l’interface de ligne de commande en local, suivez ces étapes pour vous connecter à Azure et définir votre abonnement actuel :

  1. Installez l’extension pour utiliser la dernière version de Kusto CLI :

    az extension add -n kusto
    
  2. Exécutez la commande ci-après pour vous connecter à Azure :

    az login
    
  3. Définissez l’abonnement dans lequel vous voulez créer le cluster. Remplacez MyAzureSub par le nom de l’abonnement Azure que vous voulez utiliser :

    az account set --subscription MyAzureSub
    
  4. Définissez le groupe de ressources où vous voulez créer le cluster. Remplacez testrg par le nom du groupe de ressources que vous souhaitez utiliser :

    az group create --name testrg --location westus
    

Créer le cluster Azure Data Explorer

  1. Créez votre cluster avec la commande suivante :

    az kusto cluster create --cluster-name azureclitest --sku name="Standard_D13_v2" tier="Standard" --resource-group testrg --location westus
    
    Paramètre Valeur suggérée Description du champ
    name azureclitest Nom souhaité de votre cluster.
    sku Standard_D13_v2 Référence SKU utilisée pour votre cluster. Paramètres : name - Nom de la référence SKU. tier - Niveau de la référence SKU.
    resource-group testrg Nom du groupe de ressources dans lequel sera créé le cluster.
    location westus Emplacement où sera créé le cluster.

    Vous pouvez définir d’autres paramètres facultatifs, comme la capacité du cluster.

  2. Exécutez la commande suivante pour vérifier si votre cluster a bien été créé :

    az kusto cluster show --cluster-name azureclitest --resource-group testrg
    

Si le résultat contient provisioningState avec la valeur Succeeded, alors le cluster a correctement été créé.

Créer la base de données dans le cluster Azure Data Explorer

  1. Créez votre base de données avec la commande suivante :

    az kusto database create --cluster-name azureclitest --database-name clidatabase --resource-group testrg --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=westus
    
    Paramètre Valeur suggérée Description du champ
    cluster-name azureclitest Nom du cluster dans lequel la base de données est créée.
    database-name clidatabase Nom de votre base de données.
    resource-group testrg Nom du groupe de ressources dans lequel sera créé le cluster.
    read-write-database P365DP31Dwestus Type de base de données. Paramètres : soft-delete-period - Représente la durée pendant laquelle les données restent disponibles pour les requêtes. Pour plus d’informations, consultez Stratégie de conservation. hot-cache-period - Représente la durée pendant laquelle les données sont conservées dans le cache. Pour plus d’informations, consultez Stratégie de cache. location - Emplacement où sera créée la base de données.
  2. Exécutez la commande suivante pour voir la base de données que vous avez créée :

    az kusto database show --database-name clidatabase --resource-group testrg --cluster-name azureclitest
    

Vous disposez maintenant d’un cluster et d’une base de données.

Nettoyer les ressources

  • Si vous envisagez de suivre nos autres articles, conservez les ressources que vous avez créées.

  • Pour nettoyer les ressources, supprimez le cluster. Lorsque vous supprimez un cluster, cela supprime également toutes les bases de données qu’il contient. Utilisez la commande suivante pour supprimer votre cluster :

    az kusto cluster delete --cluster-name azureclitest --resource-group testrg
    

Étapes suivantes