azdata sql

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 sql shell	L’interface CLI SQL permet à l’utilisateur d’interagir avec SQL Server et Azure SQL via T-SQL.
azdata sql query	L’interface CLI SQL permet à l’utilisateur d’interagir avec SQL Server et Azure SQL via T-SQL.

azdata sql shell

L’interface CLI SQL permet à l’utilisateur d’interagir avec SQL Server et Azure SQL via T-SQL.

azdata sql shell [--username -u] 
                 [--database -d]  
                 
[--server -s]  
                 
[--integrated -e]  
                 
[--mssqlclirc]  
                 
[--row-limit]  
                 
[--less-chatty]  
                 
[--auto-vertical-output]  
                 
[--encrypt -n]  
                 
[--trust-server-certificate -c]  
                 
[--connect-timeout -l]  
                 
[--application-intent -k]  
                 
[--multi-subnet-failover -m]  
                 
[--packet-size]  
                 
[--dac-connection -a]  
                 
[--input-file -i]  
                 
[--output-file]  
                 
[--enable-sqltoolsservice-logging]  
                 
[--prompt]

Exemples

Exemple de ligne de commande pour démarrer l’expérience interactive.

azdata sql shell

Exemple de ligne de commande à l’aide d’un serveur, d’un utilisateur et d’une base de données fournis

azdata sql shell --server localhost --username sa --database master         

Paramètres facultatifs

--username -u

Nom d’utilisateur pour se connecter à la base de données.

--database -d

Nom de la base de données auquel se connecter.

--server -s

Nom ou adresse de l’instance SQL Server.

--integrated -e

Utilisez l’authentification intégrée sur Windows.

--mssqlclirc

Emplacement du fichier de configuration mssqlclirc.

--row-limit

Définissez le seuil de l’invite de limite de lignes. Utilisez 0 pour désactiver l’invite.

--less-chatty

Ignorez l’introduction au démarrage et au revoir à la sortie.

--auto-vertical-output

Basculez automatiquement vers le mode de sortie vertical si le résultat est plus large que la largeur du terminal.

--encrypt -n

SQL Server utilise le chiffrement SSL pour toutes les données si le serveur a un certificat installé.

--trust-server-certificate -c

Le canal sera chiffré tout en contournant la marche à pas de la chaîne de certificats pour valider l’approbation.

--connect-timeout -l

Durée en secondes d’attente d’une connexion au serveur avant la fin de la demande.

--application-intent -k

Déclare le type de charge de travail d’application lors de la connexion à une base de données dans un groupe de disponibilité SQL Server.

--multi-subnet-failover -m

Si l’application se connecte à Always On AG sur différents sous-réseaux, la définition de ce paramètre permet de détecter et de connecter plus rapidement le serveur actif.

--packet-size

Taille en octets des paquets réseau utilisés pour communiquer avec SQL Server.

--dac-connection -a

Connectez-vous à SQL Server à l’aide de la connexion administrateur dédiée.

--input-file -i

Spécifie le fichier qui contient un lot d’instructions SQL pour le traitement.

--output-file

Spécifie le fichier qui reçoit la sortie d’une requête.

--enable-sqltoolsservice-logging

Active la journalisation des diagnostics pour SqlToolsService.

--prompt

Format d’invite (valeur par défaut : \d>

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 sql query

L’interface CLI SQL permet à l’utilisateur d’interagir avec SQL Server et Azure SQL via T-SQL.

azdata sql query -q 
                 [--database -d]  
                 
[--username -u]  
                 
[--server -s]  
                 
[--integrated -e]

Exemples

Exemple de ligne de commande pour sélectionner la liste des noms de tables.

azdata sql query --server localhost --username sa --database master -q "SELECT name FROM SYS.TABLES"

Paramètres requis

-q

Requête T-SQL à exécuter.

Paramètres facultatifs

--database -d

Nom de la base de données auquel se connecter. master

--username -u

Nom d’utilisateur pour se connecter à la base de données.

--server -s

Nom ou adresse de l’instance SQL Server.

--integrated -e

Utilisez l’authentification intégrée sur Windows.

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.