azdata

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 autres commandes azdata, consultez azdata reference.

Commandes

Command	Description
azdata arc	Commandes pour l’utilisation d’Azure Arc pour les services de données Azure.
azdata sql	L’interface CLI de base de données SQL permet à l’utilisateur d’interagir avec SQL Server via T-SQL.
azdata login	Connectez-vous au point de terminaison du contrôleur du cluster et définissez son espace de noms comme contexte actif. Pour utiliser un mot de passe lors de la connexion, vous devez définir la variable d’environnement AZDATA_PASSWORD.
azdata logout	Déconnectez-vous du cluster.
azdata context	Commandes de gestion du contexte.
azdata bdc	Sélectionnez, gérez et exploitez des clusters Big Data SQL Server.
azdata extension	Gérez et mettez à jour les extensions CLI.
azdata app	Créez, supprimez, exécutez et gérez des applications.
azdata postgres	Exécuteur de requêtes Postgres et interpréteur de commandes interactif.
azdata notebook	Commandes pour l’affichage, l’exécution et la gestion des notebooks à partir d’un terminal.

azdata login

Lorsque votre cluster est déployé, il répertorie le point de terminaison du contrôleur pendant le déploiement, que vous devez utiliser pour vous connecter. Si vous ne connaissez pas le point de terminaison du contrôleur, vous pouvez vous connecter en ayant la configuration kube de votre cluster sur votre système à l’emplacement par défaut de <l’utilisateur home>/.kube/config ou en utilisant l’env var KUBECONFIG, c’est-à-dire exporter KUBECONFIG=path/to/.kube/config. Lorsque vous vous connectez, l’espace de noms de ce cluster est défini sur votre contexte actif.

azdata login [--auth] 
             [--endpoint -e]  
             
[--accept-eula -a]  
             
[--namespace -ns]  
             
[--username -u]  
             
[--principal -p]

Exemples

Connectez-vous à l’aide de l’authentification de base.

azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080

Connectez-vous à l’aide d’Active Directory.

azdata login --auth ad --endpoint https://<ip or domain name>:30080                

Connectez-vous à l’aide d’Active Directory avec un principal explicite.

azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080

Se connecter de façon interactive. Le nom du cluster est toujours invité à indiquer s’il n’est pas spécifié en tant qu’argument. Si vous disposez des AZDATA_USERNAME, AZDATA_PASSWORD et ACCEPT_EULA variables env définies sur votre système, celles-ci ne sont pas requises. Si vous disposez de la configuration kube sur votre système ou que vous utilisez l’env KUBECONFIG pour spécifier le chemin d’accès à la configuration, l’expérience interactive essaie d’abord d’utiliser la configuration, puis vous invite à savoir si la configuration échoue.

azdata login

Connectez-vous (de manière non interactive). Connectez-vous avec le nom du cluster, le nom d’utilisateur du contrôleur, le point de terminaison du contrôleur et l’acceptation du CLUF définis comme arguments. La variable d’environnement AZDATA_PASSWORD doit être définie. Si vous ne souhaitez pas spécifier le point de terminaison du contrôleur, disposez de la configuration kube sur votre ordinateur à l’emplacement par défaut de <l’utilisateur home>/.kube/config ou utilisez l’env var KUBECONFIG, c’est-à-dire exporter KUBECONFIG=path/to/.kube/config.

azdata login --namespace ClusterName --username johndoe@contoso.com  --endpoint https://<ip or domain name>:30080 --accept-eula yes

Connectez-vous avec la configuration kube sur la machine et env var set pour AZDATA_USERNAME, AZDATA_PASSWORD et ACCEPT_EULA.

azdata login -n ClusterName

Paramètres facultatifs

--auth

Stratégie d’authentification. Authentification de base ou Active Directory. La valeur par défaut est l’authentification « de base ».

--endpoint -e

Point de terminaison du contrôleur de cluster « https://host:port". Si vous ne souhaitez pas utiliser cet argument, vous pouvez utiliser la configuration kube sur votre ordinateur. Vérifiez que la configuration se trouve à l’emplacement par défaut de <l’utilisateur home>/.kube/config ou utilisez l’environnement KUBECONFIG env var.

--accept-eula -a

Acceptez-vous les termes du contrat de licence ? [oui/non]. Si vous ne souhaitez pas utiliser cet argument, vous pouvez définir la variable d’environnement ACCEPT_EULA sur « oui ». Les termes du contrat de licence de ce produit peuvent être consultés à l’adresse https://aka.ms/eula-azdata-en.

--namespace -ns

Espace de noms du plan de contrôle du cluster.

--username -u

Utilisateur du compte. Si vous ne souhaitez pas utiliser cet argument, vous pouvez définir la variable d’environnement AZDATA_USERNAME.

--principal -p

Votre domaine Kerberos. Dans la plupart des cas, votre domaine Kerberos est votre nom de domaine, en majuscules.

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 logout

Déconnectez-vous du cluster.

azdata logout 

Exemples

Déconnectez-vous de cet utilisateur.

azdata logout

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.