azdata context

S’applique à : Azure Data CLI (azdata)

Note

Certains scénarios précédemment gérés par Azure Data CLI (azdata) sont désormais gérés par le biais d’extensions Azure CLI (az) et de flux de travail Basés sur Azure Arc. Il n’existe aucun remplacement unique de 1:1 pour toutes les azdata commandes. Le tableau suivant met en évidence les alternatives Azure CLI couramment associées là où elles existent.

zone de commande azdata	Extension /groupe de commandes Azure CLI	informations de référence sur Azure CLI
azdata arc dc *	az arcdata	Informations de référence sur l’interface CLI de données Azure Arc
azdata arc sql mi *	az arcdata sql mi	Gérer Azure SQL Managed Instance avec l’interface CLI
azdata arc postgres *	az arcdata postgres	Gérer le serveur PostgreSQL avec l’interface CLI
azdata migrate *	az datamigration	Migrer à l’aide de l’interface CLI
azdata extension *	az extension *	Vue d’ensemble des extensions Azure CLI
azdata login	az login	az login
azdata sql shell / azdata sql query	Aucun équivalent Azure CLI (utilisation sqlcmd, SSMS ou d’autres outils SQL)	Utilitaire sqlcmd SQL Server Management Studio

Pour les nouveaux scénarios d’automatisation et de gestion, préférez Azure CLI (az), les extensions Azure CLI et les expériences du portail Azure Arc.

L’article suivant fournit des informations de référence sur les commandes sql dans l’outil azdata. Pour plus d’informations sur les commandes azdata, consultez azdata reference

Commandes

Command	Description
azdata context list	Répertorie les contextes disponibles dans le profil utilisateur.
azdata context delete	Supprime le contexte avec l’espace de noms donné du profil utilisateur.
azdata context set	Définit le contexte avec l’espace de noms donné comme contexte actif dans le profil utilisateur.

azdata context list

Vous pouvez définir ou supprimer l’un de ces éléments avec azdata context set ou azdata context delete. Pour vous connecter à un nouveau contexte, utilisez azdata login.

azdata context list [--active -a] 
                    

Exemples

Répertorie tous les contextes disponibles dans le profil utilisateur.

azdata context list

Répertorie le contexte actif dans le profil utilisateur.

azdata context list --active

Paramètres facultatifs

--active -a

Répertorier uniquement le contexte actif.

Arguments globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--output -o

Format de sortie. Valeurs autorisées : json, jsonc, table, tsv. Valeur par défaut : json.

--query -q

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

azdata context delete

Si le contexte supprimé est actif, l’utilisateur doit définir un nouveau contexte actif. Pour afficher les contextes disponibles pour définir ou supprimer azdata context list. Lorsqu’un espace de noms est fourni qui correspond à plusieurs espaces de noms de contexte, vous devez fournir tout [--namespace --username --endpoint] pour l’unicité afin de supprimer ce contexte.

azdata context delete --namespace -ns 
                      [--endpoint -e]  
                      
[--username -u]

Exemples

Supprime le contexte dans le profil utilisateur en fonction d’un espace de noms unique.

azdata context delete --namespace contextNamespace

Supprime le contexte dans le profil utilisateur en fonction de l’espace de noms, du nom d’utilisateur et du point de terminaison du contrôleur.

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080

Paramètres requis

--namespace -ns

Espace de noms du contexte que vous souhaitez supprimer.

Paramètres facultatifs

--endpoint -e

Point de terminaison du contrôleur de cluster « https://host:port".

--username -u

Utilisateur du compte.

Arguments globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--output -o

Format de sortie. Valeurs autorisées : json, jsonc, table, tsv. Valeur par défaut : json.

--query -q

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

azdata context set

Pour afficher les contextes disponibles pour définir azdata context list. Si aucun contexte n’est répertorié, vous devez vous connecter pour créer un contexte dans votre profil azdata loginutilisateur. Ce à quoi vous vous connectez deviendra votre contexte actif. Si vous vous connectez à plusieurs entités, vous pouvez basculer entre des contextes actifs avec cette commande. Pour afficher votre contexte azdata context list --activeactif actuellement. Lorsqu’un espace de noms est fourni qui correspond à plusieurs espaces de noms de contexte, vous devez fournir tous les [--namespace --username --endpoint] pour l’unicité afin de définir le contexte actif.

azdata context set --namespace -ns 
                   [--endpoint -e]  
                   
[--username -u]

Exemples

Définit le contexte actif dans le profil utilisateur en fonction d’un espace de noms unique.

azdata context set --namespace contextNamespace

Définit le contexte actif dans le profil utilisateur en fonction de l’espace de noms, du nom d’utilisateur et du point de terminaison du contrôleur.

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080     

Paramètres requis

--namespace -ns

Espace de noms du contexte que vous souhaitez définir.

Paramètres facultatifs

--endpoint -e

Point de terminaison du contrôleur de cluster « https://host:port".

--username -u

Utilisateur du compte.

Arguments globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

--help -h

Affichez ce message d’aide et quittez.

--output -o

Format de sortie. Valeurs autorisées : json, jsonc, table, tsv. Valeur par défaut : json.

--query -q

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Étapes suivantes

Pour plus d’informations sur les autres commandes azdata, consultez azdata reference.

Pour plus d’informations sur l’installation de l’outil azdata, consultez Installer azdata.