Utilitaire osql

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

L'utilitaire osql permet de spécifier des instructions Transact-SQL, des procédures système, ainsi que des fichiers de script. Pour communiquer avec le serveur, cet utilitaire fait appel à ODBC.

Syntaxe

  
osql  
[-?] |  
[-L] |  
[  
  {  
     {-Ulogin_id [-Ppassword]} | -E }  
     [-Sserver_name[\instance_name]] [-Hwksta_name] [-ddb_name]  
     [-ltime_out] [-ttime_out] [-hheaders]  
     [-scol_separator] [-wcolumn_width] [-apacket_size]  
     [-e] [-I] [-D data_source_name]  
     [-ccmd_end] [-q "query"] [-Q"query"]  
     [-n] [-merror_level] [-r {0 | 1}]  
     [-iinput_file] [-ooutput_file] [-p]  
     [-b] [-u] [-R] [-O]  
]  

Arguments

-?
Affiche un résumé de la syntaxe des commutateurs osql .

-L
Répertorie tous les serveurs configurés localement et les noms des serveurs émettant sur le réseau.

-U login_id
ID de connexion de l'utilisateur. Les ID de connexion respectent la casse.

-P password
Spécifie le mot de passe pour l'utilisateur. Si l’option -P n’est pas utilisée, osql invite à entrer un mot de passe. Si l’option -P est utilisée à la fin de la ligne de commande sans spécifier de mot de passe, osql emploie le mot de passe par défaut (NULL).

Les mots de passe respectent la casse.

La variable d'environnement OSQLPASSWORD permet de définir un mot de passe par défaut pour la session en cours. Par conséquent, il est inutile de programmer spécifiquement le mot de passe dans des fichiers de commandes.

Si vous ne spécifiez pas de mot de passe avec l’option -P , osql commence par rechercher la variable OSQLPASSWORD. Si aucune valeur n'est définie, osql utilise le mot de passe par défaut (NULL). L'exemple suivant définit la variable OSQLPASSWORD dans une invite de commandes et accède ensuite à l'utilitaire osql :

C:\>SET OSQLPASSWORD=abracadabra  
C:\>osql   

-E
Utilise une connexion approuvée au lieu de demander un mot de passe.

-S server_name[\instance_name]
Spécifie l'instance de SQL Server à laquelle établir une connexion. Spécifiez server_name pour vous connecter à l’instance par défaut du SQL Server sur ce serveur. Spécifiez server_name\instance_name pour vous connecter à une instance nommée de SQL Server sur ce serveur. Si aucun serveur n'est spécifié, osql se connecte à l'instance par défaut de SQL Server sur l'ordinateur local. Cette option est indispensable lorsque vous exécutez osql à partir d'un ordinateur distant connecté au réseau.

-H wksta_name
Nom d'une station de travail. Le nom de la station de travail est stocké dans sysprocesses.hostname et est affiché par sp_who. Si cette option n'est pas spécifiée, le nom d'ordinateur en cours est utilisé par défaut.

-d db_name
Émet une instruction USE db_name au démarrage d’ osql.

-l time_out
Spécifie le nombre de secondes avant expiration du délai de connexion à osql . Le délai d’attente par défaut pour la connexion à osql est de huit secondes.

-t time_out
Spécifie le nombre de secondes accordées pour l'exécution d'une commande. Si aucune valeur time_out n’est spécifiée, les commandes n’ont pas de délai d’expiration.

-h headers
Spécifie le nombre de lignes à imprimer entre les en-têtes de colonne. Par défaut, les en-têtes ne sont imprimés qu'une fois pour chaque jeu de résultats d'une requête. Utilisez -1 pour indiquer qu'aucun titre ne sera imprimé. Si vous utilisez -1, ne laissez aucun espace entre le paramètre et sa valeur ( -h-1, et non -h -1).

-s col_separator
Spécification du caractère de séparation des colonnes, qui est par défaut un espace. Pour utiliser des caractères qui présentent une signification particulière pour le système d'exploitation (par exemple, | ; <>), mettez-les entre guillemets doubles (").

-w column_width
Permet à l'utilisateur de définir la largeur d'écran des sorties. La valeur par défaut est de 80 caractères. Lorsqu'une ligne de sortie a atteint la largeur d'écran maximale, elle est scindée en plusieurs lignes.

-a packet_size
Spécifie le taille des paquets. Les valeurs correctes pour packet_size sont comprises entre 512 et 65535. La valeur osql par défaut est la valeur par défaut du serveur. Une plus grande taille de paquet permet d'améliorer les performances lors de l'exécution de scripts plus volumineux, où la quantité d'instructions SQL entre les commandes GO est substantielle. Microsoft indiquent que la valeur 8192 représente généralement le réglage le plus rapide pour les opérations de copie en bloc. Une taille de paquet supérieure peut être demandée, mais osql prend la valeur par défaut du serveur si la requête ne peut pas être satisfaite.

-e
Retourne les données d'entrée.

-I
Active l'option de connexion QUOTED_IDENTIFIER.

-D data_source_name
Établit la connexion à une source de données ODBC définie à l'aide du pilote ODBC de SQL Server. La connexion osql utilise les options spécifiées dans la source de données.

-c cmd_end
Spécifie l'indicateur de fin de commande. Par défaut, il faut entrer la commande GO sur une ligne isolée pour terminer une commande et la soumettre à SQL Server . Si vous changez d'indicateur de fin de commande, n'utilisez ni les mots réservés Transact-SQL ni les caractères ayant une signification particulière pour le système d'exploitation, qu'ils soient ou non précédés d'une barre oblique inverse.

-q " query "
Exécute une requête au démarrage d’ osql , mais ne quitte pas osql à l’issue de la requête. (Notez que la requête ne doit pas comporter d'instruction GO). Si vous exécutez une requête à partir d'un fichier de commandes, vous pouvez utiliser %variable ou %variable d'environnement%. Par exemple :

SET table=sys.objects  
osql -E -q "select name, object_id from %table%"  

Placez le nom de la requête entre guillemets doubles et tout élément imbriqué dans la requête entre guillemets simples.

-Q" query "
Exécute une requête, puis quitte immédiatement osql. Placez le nom de la requête entre guillemets doubles et tout élément imbriqué dans la requête entre guillemets simples.

-n
Supprime la numérotation et le symbole de ligne de commande (>) des lignes d'entrée.

-m error_level
Personnalise l'affichage des messages d'erreur. Le numéro du message, son état et son niveau d'erreur sont affichés pour les erreurs atteignant ou dépassant le niveau de gravité indiqué. Aucune information n'est affichée pour les erreurs d'une gravité inférieure au niveau indiqué. Utilisez -1 pour afficher tous les en-têtes retournés avec les messages, même s’il s’agit de messages d’information. Si vous utilisez -1, ne laissez aucun espace entre le paramètre et sa valeur ( -m-1, et non -m -1).

-r { 0| 1}
Redirige la sortie des messages à l’écran (stderr). Si vous n'indiquez aucun paramètre ou si vous spécifiez la valeur 0, seuls les messages d'erreur de gravité égale ou supérieure à 11 sont redirigés. Si vous indiquez la valeur 1, tous les messages émis (y compris les messages d’impression) sont redirigés.

-i input_file
Identifie le fichier contenant un traitement d'instructions SQL ou des procédures stockées. L’opérateur de comparaison inférieur à ( < ) peut être utilisé à la place de -i.

-o output_file
Identifie le fichier recevant une sortie de osql. L’opérateur de comparaison supérieur à ( > ) peut être utilisé à la place de -o.

Si input_file n’est pas au format Unicode et si -u n’est pas spécifié, output_file est enregistré au format OEM. Si input_file est au format Unicode ou si -u est spécifié, output_file est stocké au format Unicode.

-p
Affiche les statistiques sur les performances.

-b
Spécifie que osql prend fin et retourne une valeur DOS ERRORLEVEL quand une erreur se produit. La valeur retournée à la variable DOS ERRORLEVEL est 1 lorsque le message d'erreur de SQL Server possède une gravité égale ou supérieure à 11, sinon la valeur retournée est 0. Microsoft Les fichiers de commande MS-DOS peuvent tester la valeur de DOS ERRORLEVEL et traiter l’erreur d’une manière appropriée.

-u
Spécifie qu’ output_file est stocké au format Unicode, quel que soit le format d’ input_file.

-R
Spécifie l’utilisation par le pilote ODBC de SQL Server des paramètres du client pour convertir monnaie, date et heure en données caractères.

-O
Spécifie que certaines fonctionnalités d’ osql sont désactivées pour assurer la continuité avec des versions antérieures d’ isql. Les fonctionnalités suivantes sont désactivées :

• Traitement de lot EOF

• Mise à l'échelle automatique de la largeur de la console

• Messages larges

Il attribue aussi la valeur par défaut -1 à DOS ERRORLEVEL.

Notes

L’utilitaire osql doit être exécuté directement à partir du système d’exploitation à l’aide des options respectant la casse énumérées ici. Une fois osqldémarré, il accepte les instructions SQL et les envoie de manière interactive à SQL Server . Les résultats sont mis en forme et affichés à l’écran (stdout). Pour quitter osql, utilisez QUIT ou EXIT.

Si vous ne spécifiez pas de nom d’utilisateur quand vous démarrez osql, SQL Server vérifie les variables d’environnement et les utilise, par exemple, osqluser=(user) ou osqlserver=(server) . Si aucune variable d'environnement n'est définie, le nom d'utilisateur du poste de travail est utilisé. Si vous n'indiquez pas de serveur, le nom du poste de travail est utilisé.

Si aucune des options -U et -P n’est utilisée, SQL Server tente de se connecter à l’aide du mode d’authentification Microsoft Windows. L'authentification est basée sur le compte Microsoft Windows de l'utilisateur exécutant osql.

L'utilitaire osql utilise l'API ODBC. Cet utilitaire emploie les paramètres par défaut du pilote ODBC SQL Server pour les options de connexion ISO de SQL Server . Pour plus d'informations, consultez « Effets des options ANSI ».

Commandes OSQL

En plus des instructions Transact-SQL dans osql, les commandes ci-dessous sont également disponibles.

Les indicateurs de fin de commande, GO (par défaut), RESET EXIT, QUIT et CTRL+C ne sont reconnus que s’ils apparaissent au début d’une ligne immédiatement après l’invite osql .

GO indique la fin d'un traitement et l'exécution des instructions Transact-SQL placées dans le cache. Quand vous appuyez sur ENTRÉE à la fin d'une ligne d'entrée, osql place les instructions de cette ligne dans le cache. Lorsque vous appuyez sur ENTRÉE après avoir tapé GO, toutes les instructions en cache sont envoyées en tant que traitement à SQL Server.

L'utilitaire osql actuel fonctionne comme si une instruction GO implicite terminait chaque script exécuté, de sorte que toutes les instructions du script sont exécutées.

Pour terminer une commande, tapez une ligne commençant par un indicateur de fin de commande. Vous pouvez faire suivre cet indicateur de fin de commande d'un nombre entier pour indiquer le nombre d'exécutions de la commande. Par exemple, pour exécuter cette commande 100 fois, entrez :

SELECT x = 1  
GO 100  

Les résultats sont imprimés une fois à la fin de l'exécution. osql n'accepte pas plus de 1 000 caractères par ligne. Les instructions de grande taille doivent être scindées en plusieurs lignes.

La fonction de rappel de commande de Windows peut servir à rappeler et à modifier des instructions osql . Le tampon de requête en cours peut être vidé en tapant RESET.

Lors de l'exécution de procédures stockées, osql imprime une ligne vide entre chaque jeu de résultats d'un lot. En outre, le message « 0 ligne affectée » ne s'affiche pas lorsqu'il ne concerne pas l'instruction exécutée.

Utilisation interactive de osql

Pour utiliser osql en mode interactif, entrez la commande osql (et les options désirées) après l’invite de commandes du système d’exploitation.

Vous pouvez exécuter dans osql la requête contenue dans un fichier (tel que Stores.qry) en entrant une commande de ce type :

osql -E -i stores.qry  

Vous pouvez lire un fichier contenant une requête (tel que Titles.qry) et rediriger les résultats vers un autre fichier en entrant une commande de ce type :

osql -E -i titles.qry -o titles.res  

Quand vous utilisez osql en mode interactif, vous pouvez consulter un fichier du système d’exploitation dans la mémoire tampon de commande en entrant :rnom_fichier. Cette opération adresse le script SQL qui se trouve dans nom_fichier directement au serveur en un seul traitement.

Insertion de commentaires

Vous pouvez inclure des commentaires dans une instruction Transact-SQL soumise à SQL Server par osql. Deux styles de commentaires sont autorisés : -- et /*...*/.

Utilisation d'EXIT pour retourner des résultats dans osql

Vous pouvez utiliser le résultat d'une instruction SELECT comme valeur retournée par osql. S'il est numérique, la dernière colonne de la dernière ligne de résultats est convertie en entier de 4 octets (entier long). MS-DOS transmet l'octet de poids faible au processus parent ou au niveau erreur du système d'exploitation. Windows transmet la totalité de l'entier de 4 octets. La syntaxe est :

EXIT ( < query > )  

Par exemple :

EXIT(SELECT @@ROWCOUNT)  

Vous pouvez également inclure le paramètre EXIT dans un fichier de commandes. Par exemple :

osql -E -Q "EXIT(SELECT COUNT(*) FROM '%1')"  

L’utilitaire osql transmet au serveur toutes les informations placées entre parenthèses () telles qu’elles ont été entrées. Si une procédure système stockée sélectionne un ensemble et retourne une valeur, seule la sélection est retournée. L’instruction EXIT**()** sans information entre parenthèses exécute toutes les commandes qui la précèdent dans le traitement, puis quitte l’utilitaire sans retourner de valeur.

Il existe quatre formats de sortie :

• EXIT

• EXIT**()**

• EXIT**(query)**

• RAISERROR avec une gravité de 127

RAISERROR(50001, 10, 127)  

Cette erreur entraîne l'arrêt de l'exécution du script osql et envoie le message 50001 au client.

Les valeurs retournées comprises entre -1 et -99 sont réservées à SQL Server. osql définit les valeurs suivantes :

• -100

  Erreur rencontrée avant la sélection d'une valeur retournée.

• -101

  Aucune ligne trouvée lors de la sélection d'une valeur retournée.

• -102

  Erreur de conversion survenue lors de la sélection d'une valeur retournée.

Affichage des types de données money et smallmoney

osql affiche les types de données money et smallmoney avec deux décimales, bien que SQL Server les stocke en interne avec quatre décimales. Prenons cet exemple :

SELECT CAST(CAST(10.3496 AS money) AS decimal(6, 4))  
GO  

Cette instruction produit le résultat 10.3496, ce qui indique que la valeur est bien stockée avec toutes ses décimales.

Voir aussi

Commentaire (MDX)
-- (Commentaire) (MDX)
CAST et CONVERT (Transact-SQL)
RAISERROR (Transact-SQL)