Démarrage rapide : Créer un espace de travail Azure Synapse avec Azure CLI

L’interface de ligne de commande Azure (Azure CLI) est l’expérience de ligne de commande d’Azure pour gérer les ressources Azure. Vous pouvez l’utiliser dans votre navigateur avec Azure Cloud Shell. Vous pouvez également l’installer sur Windows, Linux ou MacOS, et l’exécuter à partir de la ligne de commande.

Dans ce guide de démarrage rapide, vous allez apprendre à créer un espace de travail Synapse en utilisant l’interface Azure CLI.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Prérequis

• Téléchargez et installez jq, un processeur JSON en ligne de commande léger et flexible

• Compte de stockage Azure Data Lake Storage Gen2

  Important

  L’espace de travail Azure Synapse doit pouvoir lire et écrire dans le compte ADLS Gen2 sélectionné. De plus, pour tout compte de stockage que vous liez en tant que compte de stockage principal, vous devez avoir activé l’espace de noms hiérarchique lors de la création du compte de stockage, tel que décrit dans la page Créer un compte de stockage.

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Créer un espace de travail Azure Synapse à l’aide de l’interface Azure CLI

1. Définissez les variables d’environnement nécessaires qui permettent de créer des ressources pour l’espace de travail Azure Synapse.

   Nom de variable d'environnement	Description
   StorageAccountName	Nom de votre compte de stockage ADLS Gen2 existant.
   StorageAccountResourceGroup	Nom du groupe de ressources de votre compte de stockage ADLS Gen2 existant.
   FileShareName	Nom de votre système de fichiers de stockage existant.
   SynapseResourceGroup	Choisissez un nouveau nom pour votre groupe de ressources Azure Synapse.
   Région	Choisissez une des régions Azure.
   SynapseWorkspaceName	Choisissez un nom unique pour votre nouvel espace de travail Azure Synapse.
   SqlUser	Choisissez une valeur pour un nouveau nom d’utilisateur.
   SqlPassword	Choisissez un mot de passe sécurisé.

2. Créez un groupe de ressources en tant que conteneur pour votre espace de travail Azure Synapse :

   az group create --name $SynapseResourceGroup --location $Region
   

3. Créer un espace de travail Azure Synapse :

   az synapse workspace create \
     --name $SynapseWorkspaceName \
     --resource-group $SynapseResourceGroup \
     --storage-account $StorageAccountName \
     --file-system $FileShareName \
     --sql-admin-login-user $SqlUser \
     --sql-admin-login-password $SqlPassword \
     --location $Region
   

4. Obtenez l’URL dev et web de l’espace de travail Azure Synapse :

   WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
   
   WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
   

5. Créez une règle de pare-feu pour autoriser votre accès à l’espace de travail Azure Synapse depuis votre machine :

   ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
   ClientIP=${ClientIP##'Client Ip address : '}
   echo "Creating a firewall rule to enable access for IP address: $ClientIP"
   
   az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
   

6. Ouvrez l’adresse URL web de l’espace de travail Azure Synapse, stockée dans la variable d’environnement WorkspaceWeb, pour accéder à votre espace de travail :

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. Une fois le déploiement terminé, des autorisations supplémentaires sont requises.

• Dans le portail Azure, affectez d’autres utilisateurs de l’espace de travail au rôle Contributeur dans l’espace de travail. Pour connaître les étapes détaillées, consultez Attribuer des rôles Azure à l’aide du portail Azure.
• Affectez aux autres utilisateurs les rôles Synapse RBAC appropriés à l’aide de Synapse Studio.
• Un membre du rôle Propriétaire du compte Stockage Azure doit attribuer le rôle Contributeur aux données Blob du stockage au MSI de l’espace de travail Azure Synapse et aux autres utilisateurs.

Nettoyer les ressources

Effectuez les étapes ci-dessous pour supprimer l’espace de travail Azure Synapse.

Avertissement

Le fait de supprimer un espace de travail Azure Synapse entraîne la suppression des moteurs d’analytique et des données stockées dans la base de données des pools SQL et des métadonnées de l’espace de travail. Il n’est plus possible de se connecter aux points de terminaison SQL ni aux points de terminaison Apache Spark. Tous les artefacts de code seront supprimés (requêtes, notebooks, définitions de travaux et pipelines).

Le fait de supprimer l’espace de travail n’affecte pas les données dans le Data Lake Store Gen2 lié à l’espace de travail.

Pour supprimer l’espace de travail Azure Synapse, exécutez la commande suivante :

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Étapes suivantes

Vous pouvez ensuite créer des pools SQL ou créer des pools Apache Spark pour commencer à analyser et à explorer vos données.