Num�ro d'article: 325003 - Derni�re mise � jour: vendredi 23 mars 2007 - Version: 2.1

Comment faire pour g�rer SQL Server Desktop Engine (MSDE�2000) ou SQL Server�2005 Express Edition � l'aide de utilitaire osql

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

Voir les produits auxquels s'applique cet article

A noterCet article s'applique � un syst�me d'exploitation diff�rent de celui que vous utilisez. Le contenu de l'article qui ne vous concerne peut-�tre pas est d�sactiv�.

SQL�Server�Desktop�Engine (�galement appel� MSDE�2000) ne poss�de pas d'interface utilisateur propre parce qu'il est principalement con�u pour �tre ex�cut� en arri�re-plan. Les utilisateurs peuvent interagir avec MSDE�2000 par le biais du programme dans lequel il est incorpor�. Le seul outil fourni avec MSDE�2000 est l'utilitaire osql. Le fichier ex�cutable, Sql.exe, se trouve dans le dossier MSSQL\Binn pour une instance par d�faut de MSDE�2000. Cet article explique comment g�rer MSDE�2000 � l'aide de l'utilitaire osql.

Si vous utilisez SQL Server�2005, vous pouvez �galement utiliser l'utilitaire osql pour g�rer SQL Server�2005 Express Edition. Toutefois, cette fonctionnalit� va �tre supprim�e dans une version future de Microsoft SQL Server�2005. Nous vous conseillons donc de ne pas utiliser cette fonctionnalit� dans un nouveau travail de d�veloppement et de pr�voir de modifier les applications qui utilisent actuellement cette fonctinnalit�. Utilisez � la place l'utilitaire Sqlcmd. Pour plus d'informations sur la fa�on d'utiliser l'utilitaire Sqlcmd, reportez-vous au site Web de Microsoft Developper Network (MSDN) � l'adresse suivante :

http://msdn2.microsoft.com/fr-fr/library/ms170207.aspx (http://msdn2.microsoft.com/fr-fr/library/ms170207.aspx)

Retour au d�but

Qu'est-ce que Osql�?

L'utilitaire osql est un utilitaire d'invite de commandes Microsoft�Windows 32�bits que vous pouvez utiliser pour ex�cuter des instructions Transact-SQL et des fichiers de script. L'utilitaire osql utilise l'interface de programmation d'application (API, Application Programming Interface) d'une base de donn�es ODBC pour communiquer avec le serveur.

Retour au d�but

Comment utiliser Osql�?

En g�n�ral, vous utilisez l'utilitaire osql comme suit�:

Les utilisateurs entrent interactivement des instructions Transact-SQL comme ils le feraient � partir d'une invite de commandes.
Les utilisateurs envoient un travail osql en utilisant l'une des m�thodes suivantes�:
- en sp�cifiant une instruction Transact-SQL unique � ex�cuter. -�ou�-
- en pointant l'utilitaire vers un fichier de script contenant les instructions Transact-SQL � ex�cuter.

Saisie interactive d'instructions Transact-SQL

Pour afficher une liste des options de l'utilitaire osql (celles-ci respectent la casse), tapez la commande suivante � l'invite de commandes, puis appuyez sur ENTR�E�:

osql -?

Pour plus d'informations sur chacune des options de l'utilitaire osql, reportez-vous � la rubrique "osql Utility" (Utilitaire osql) dans la documentation en ligne de SQL�Server.

Pour entrer interactivement des instructions Transact-SQL, proc�dez comme suit�:

V�rifiez que MSDE�2000 est en cours d'ex�cution.
Connectez-vous � MSDE�2000. Pour plus d'informations, reportez-vous � la section "Connexion � SQL�Server�Desktop�Engine (MSDE�2000)".
� l'invite osql, tapez les instructions Transact-SQL, puis appuyez sur ENTR�E. Lorsque vous appuyez sur ENTR�E � la fin de chaque ligne, osql met en cache les instructions de cette ligne.
- Pour ex�cuter les instructions actuellement mises en cache, tapez "Go", puis appuyez sur ENTR�E.
- Pour ex�cuter un lot d'instructions Transact-SQL, entrez chaque commande Transact-SQL sur des lignes s�par�es. Tapez ensuite "Go" � la derni�re ligne pour signaler la fin du lot et ex�cuter les instructions actuellement mises en cache.
Les r�sultats s'affichent dans la fen�tre de la console.
Pour quitter osql, tapez QUIT ou EXIT, puis appuyez sur ENTR�E.

Envoi d'un travail Osql

En g�n�ral, vous pouvez envoyer un travail osql de deux mani�res diff�rentes. Vous pouvez�:

sp�cifier une instruction Transact-SQL unique.

-�ou�-
pointer l'utilitaire vers un fichier de script.

Vous trouverez ci-apr�s plus d'informations sur chaque m�thode.

Sp�cification d'une instruction Transact-SQL unique

Pour ex�cuter une instruction Transact-SQL en fonction de l'instance locale par d�faut de MSDE�2000, tapez une commande semblable � celle-ci�:

osql -E -q "instruction Transact-SQL"

o�

-E utilise l'authentification Microsoft Windows�NT.

-�et�-
-q ex�cute l'instruction Transact-SQL, mais ne ferme pas osql une fois la requ�te termin�e.

Pour ex�cuter l'instruction Transact-SQL et quitter osql, utilisez l'argument�-Q � la place de�-q.

Pointage de l'utilitaire vers un fichier de script

Pour pointer l'utilitaire vers un fichier de script, proc�dez comme suit�:

Cr�ez un fichier de script contenant un lot d'instructions Transact-SQL (tel que myQueries.sql).
Ouvrez une invite de commandes, tapez une commande semblable � la suivante, puis appuyez sur ENTR�E�:

osql -E -i fichier_entr�e

o�

fichier_entr�e est le chemin d'acc�s complet du fichier de script. Par exemple, si le fichier de script myQueries.sql se trouve dans le dossier C:\Queries, remplacez le param�tre fichier_entr�e par C:\Queries\myQueries.sql.

Les r�sultats du fichier de script s'affichent dans la fen�tre de la console. Pour diriger les r�sultats vers un fichier, ajoutez l'argument�-ofichier_sortie � la commande indiqu�e plus haut. Par exemple�:

osql -E -i fichier_entr�e -o fichier_sortie

o�

fichier_sortie est le chemin d'acc�s complet du fichier de sortie.

Pour supprimer la num�rotation et les symboles d'invite dans la sortie, ajoutez l'option�-n � la commande indiqu�e plus haut. Par exemple�:

osql -E -i fichier_entr�e -o fichier_sortie -n

Retour au d�but

Connexion � SQL�Server�Desktop�Engine (MSDE�2000)

Pour vous connecter � MSDE�2000, proc�dez comme suit�:

V�rifiez que MSDE�2000 est en cours d'ex�cution.
Ouvrez une invite de commandes sur l'ordinateur qui h�berge l'instance de MSDE�2000 � laquelle vous souhaitez vous connecter.
Tapez la commande suivante, puis appuyez sur ENTR�E�:

osql -E

Ceci vous connecte � l'instance locale par d�faut de MSDE�2000 en utilisant l'authentification Windows.

Pour vous connecter � une instance nomm�e de MSDE�2000, tapez la commande suivante�:

osql -E -S nom_serveur\nom_instance

Si le message d'erreur suivant s'affiche, il se peut que MSDE�2000 ne soit pas en cours d'ex�cution ou que vous ayez entr� un nom incorrect pour l'instance nomm�e de MSDE�2000 qui est install�e�:
[M�moire partag�e]Ce serveur SQL n'existe pas ou son acc�s est refus�.
[M�moire partag�e]ConnectionOpen (Connect()).
Si vous �tes correctement connect� au serveur, l'invite suivante s'affiche�:
```
   1&gt;
						
```
Cette invite indique que osql est d�marr�. Vous pouvez d�sormais entrer interactivement des instructions Transact-SQL et les r�sultats s'afficheront sur la ligne d'invite de commandes.

Retour au d�but

Gestion de MSDE�2000

Les sections restantes de cet article d�crivent bri�vement les commandes Transact-SQL les plus couramment utilis�es pour g�rer MSDE�2000.

Cr�ation d'une connexion

Pour se connecter � SQL�Server, un utilisateur doit fournir une ID de connexion valide. La proc�dure stock�e sp_grantlogin permet d'autoriser l'utilisation d'un compte r�seau Microsoft�Windows (compte de groupe ou compte d'utilisateur) en tant que connexion SQL�Server pour se connecter � une instance de SQL�Server � l'aide de l'authentification Windows. L'exemple suivant permet � un utilisateur Windows�NT nomm� Corporate\Test de se connecter � une instance de SQL�Server�:

EXEC sp_grantlogin 'Corporate\Test'

Seuls les membres des r�les de serveur fix�s sysadmin ou securityadmin peuvent ex�cuter la proc�dure stock�e sp_grantlogin. Pour plus d'informations sur ces r�les, reportez-vous � la rubrique "Roles, SQL�Server Architecture" (R�les, Architecture de SQL�Server) dans la documentation en ligne de SQL�Server.

Pour plus d'informations sur la proc�dure stock�e sp_grantlogin, reportez-vous � la rubrique "sp_grantlogin, Transact-SQL Reference" (sp_grantlogin, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Vous utilisez la proc�dure stock�e sp_addlogin pour cr�er un nouveau compte de connexion pour les connexions SQL�Server � l'aide de l'authentification SQL�Server. L'exemple suivant cr�e une connexion SQL�Server pour un utilisateur nomm� "test" avec le mot de passe "hello"�:

EXEC sp_addlogin 'test','hello'

Seuls les membres des r�les de serveur fix�s sysadmin et securityadmin peuvent ex�cuter la proc�dure stock�e sp_addlogin. Pour plus d'informations sur la proc�dure stock�e sp_addlogin, reportez-vous � la rubrique "sp_addlogin, Transact-SQL Reference" (sp_addlogin, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Acc�s � une base de donn�es

Apr�s s'�tre connect� � une instance de SQL�Server, un utilisateur ne peut pas ex�cuter d'activit�s dans une base de donn�es tant que dbo ne lui accorde pas l'acc�s � la base de donn�es. Vous pouvez utiliser la proc�dure stock�e sp_grantdbaccess pour ajouter un compte de s�curit� pour un nouvel utilisateur � la base de donn�es active. L'exemple suivant ajoute un compte pour un utilisateur Microsoft Windows�NT nomm� Corporate\BobJ � la base de donn�es active et le nomme "Bob"�:

EXEC sp_grantdbaccess 'Corporate\BobJ', 'Bob'

La proc�dure stock�e sp_adduser ex�cute la m�me fonction que la proc�dure stock�e sp_grantdbaccess. �tant donn� que la proc�dure stock�e sp_adduser est incluse pour des raisons de compatibilit� ascendante, Microsoft vous recommande d'utiliser la proc�dure stock�e sp_grantdbacess.

Seuls les membres du r�le de serveur fix� sysadmin et des r�les de base de donn�es fix�s db_accessadmin et db_owner peuvent ex�cuter la proc�dure stock�e sp_grantdbaccess. Pour plus d'informations sur la proc�dure stock�e sp_grantdbaccess, reportez-vous � la rubrique "sp_grantdbaccess, Transact-SQL Reference" (sp_grantdbaccess, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Modification du mot de passe d'une connexion

Pour modifier le mot de passe d'une connexion, utilisez la proc�dure stock�e sp_password. Dans l'exemple suivant, le mot de passe "ok" de la connexion "test" est remplac� par "hello"�:

EXEC sp_password 'ok', 'hello','test'

Les autorisations d'ex�cution s�lectionnent par d�faut le r�le public pour un utilisateur qui modifie le mot de passe pour sa propre connexion. Seuls les membres du r�le sysadmin peuvent modifier le mot de passe pour la connexion d'un autre utilisateur. Pour plus d'informations sur la proc�dure stock�e sp_password, reportez-vous � la rubrique "sp_password, Transact-SQL Reference" (sp_password, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Cr�ation d'une base de donn�es

Une base de donn�es MSDE�2000 comprend une collection de tables contenant des donn�es et d'autres objets, tels que des affichages, des index, des proc�dures stock�es et des d�clencheurs, qui sont d�finis pour prendre en charge des activit�s effectu�es avec les donn�es. Pour cr�er une base de donn�es MSDE�2000, utilisez la commande Transact-SQL "CREATE DATABASE". Pour plus d'informations sur la cr�ation d'une base de donn�es, reportez-vous � la rubrique "Creating a Database" (Cr�ation d'une base de donn�es) dans la documentation en ligne de SQL�Server.

L'exemple suivant cr�e une base de donn�es nomm�e Test. Aucun param�tre suppl�mentaire n'�tant ajout� � la commande, la base de donn�es Test aura la m�me taille que la base de donn�es mod�le�:

CREATE DATABASE Test

L'autorisation de CREATE DATABASE va par d�faut aux membres des r�les de serveur fix�s sysadmin et dbcreator. Pour plus d'informations sur la commande "CREATE DATABASE", reportez-vous � la rubrique "CREATE DATABASE, Transact-SQL Reference" (CREATE DATABASE, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Pour cr�er un objet de base de donn�es, utilisez la commande Transact-SQL CREATE. Par exemple, pour cr�er une nouvelle table, utilisez la commande Transact-SQL "CREATE TABLE". Pour plus d'informations, reportez-vous � la documentation en ligne de SQL�Server.

Sauvegarde et restauration de bases de donn�es

Le composant de sauvegarde et de restauration de SQL�Server est un moyen de pr�caution important pour prot�ger les donn�es critiques qui sont enregistr�es dans les bases de donn�es SQL�Server.

Avec une bonne organisation, vous pouvez r�cup�rer apr�s de nombreuses d�faillances, notamment�:

une d�faillance de m�dia.
des erreurs des utilisateurs.
la perte permanente d'un serveur.

Par ailleurs, les op�rations de sauvegarde et de restauration de bases de donn�es peuvent �tre utilis�es � d'autres fins, par exemple pour copier une base de donn�es d'un serveur � un autre. En sauvegardant une base de donn�es d'un ordinateur et en la restaurant sur un autre, vous pouvez effectuer rapidement et facilement une copie d'une base de donn�es.

Pour plus d'informations sur les op�rations de sauvegarde et de restauration de bases de donn�es, reportez-vous � la rubrique "Backing Up and Restoring Databases" (Sauvegarde et restauration de bases de donn�es) dans la documentation en ligne de SQL�Server.

L'exemple suivant effectue une sauvegarde de base de donn�es compl�te pour une base de donn�es nomm�e mydb, nomme la sauvegarde Mydb.bak, puis l'enregistre dans le dossier C:\Msde\Backup�:

BACKUP DATABASE mydb TO DISK = 'C:\MSDE\Backup\mydb.bak'

L'exemple suivant effectue une sauvegarde du journal pour une base de donn�es nomm�e mydb, nomme la sauvegarde Mydb_log.bak, puis l'enregistre dans le dossier C:\Msde\Backup�:

BACKUP LOG mydb TO DISK = 'C:\MSDE\Backup\mydb_log.bak'

Les autorisations de BACKUP DATABASE et BACKUP LOG vont par d�faut aux membres du r�le de serveur fix� sysadmin et des r�les de base de donn�es fix�s db_owner et db_backupoperator. Pour plus d'informations sur l'instruction BACKUP, reportez-vous � la rubrique "BACKUP, Transact-SQL Reference" (BACKUP, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

MSDE inclut le service Agent SQL�Server pour g�rer les travaux planifi�s. Par exemple, vous pouvez cr�er et planifier un travail de sauvegarde Transact-SQL. Le service Agent SQL�Server g�re la planification des travaux. Pour obtenir un exemple de code sur la fa�on d'utiliser les diff�rentes proc�dures stock�es avec MSDE�2000 pour effectuer et planifier une sauvegarde, consultez l'article suivant dans la Base de connaissances Microsoft�:

241397� (http://support.microsoft.com/kb/241397/ ) Comment faire pour sauvegarder une base de donn�es Microsoft Data Engine � l'aide de Transact-SQL

Pour plus d'informations sur le service Agent SQL�Server, reportez-vous � la rubrique "SQL�Server Agent Service" (Service Agent SQL�Server) dans la documentation en ligne de SQL�Server.

La sauvegarde d'une base de donn�es ne constitue que la moiti� du processus. Il est tout aussi important de savoir comment restaurer la base de donn�es � partir d'une sauvegarde. L'exemple suivant restaure une base de donn�es nomm�e mydb � partir du fichier de sauvegarde C:\Msde\Backup\Mydb.bak�:

RESTORE DATABASE mydb FROM DISK ='C:\MSDE\Backup\mydb.bak'

Si la base de donn�es qui est restaur�e n'existe pas, l'utilisateur doit disposer des autorisations CREATE DATABASE pour ex�cuter l'instruction RESTORE. Si la base de donn�es existe, les autorisations de RESTORE vont par d�faut aux membres des r�les de serveur fix�s sysadmin et dbcreator et le propri�taire (dbo) de la base de donn�es. Pour plus d'informations sur l'instruction RESTORE, reportez-vous � la rubrique "RESTORE, Transact-SQL Reference" (RESTORE, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Attachement et d�tachement d'une base de donn�es

Les donn�es et les fichiers du journal des transactions d'une base de donn�es peuvent �tre d�tach�s puis rattach�s � un autre serveur, voire au m�me serveur. Le d�tachement d'une base de donn�es supprime la base de donn�es de SQL�Server, mais laisse la base de donn�es intacte dans les donn�es et les fichiers du journal des transactions qui composent la base de donn�es. Vous pouvez ensuite utiliser ces donn�es et fichiers du journal des transactions pour attacher la base de donn�es � toute instance de SQL�Server, y compris le serveur � partir duquel la base de donn�es a �t� d�tach�e. La base de donn�es est alors disponible dans le m�me �tat qu'au moment du d�tachement. Pour plus d'informations, reportez-vous � la rubrique "Attaching and Detaching a Database" (Attachement et d�tachement d'une base de donn�es) dans la documentation en ligne de SQL�Server.

L'exemple suivant d�tache une base de donn�es nomm�e mydb de l'instance active de SQL�Server�:

EXEC sp_detach_db 'mydb'

Seuls les membres du r�le de serveur fix� sysadmin peuvent ex�cuter la proc�dure stock�e sp_detach_db. Pour plus d'informations sur la proc�dure stock�e sp_detach_db, reportez-vous � la rubrique "sp_detach_db, Transact-SQL Reference" (sp_detach_db, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

L'exemple suivant attache deux fichiers d'une base de donn�es nomm�e mydb � l'instance active de SQL�Server�:

EXEC sp_attach_db @dbname = N'mydb', 
   @filename1 = N'C:\MSDE\Backup\mydb.mdf', 
   @filename2 = N'C:\MSDE\Backup\mydb.ldf'

La lettre majuscule�N est utilis�e pour pr�fixer une constante de cha�ne Unicode. Le pr�fixe�"N" signifie "National Language" dans la norme SQL-92. Pour plus d'informations, consultez l'article suivant dans la Base de connaissances Microsoft�:

239530� (http://support.microsoft.com/kb/239530/ ) INF�: Les constantes de cha�ne Unicode dans SQL�Server n�cessitent le pr�fixe�N

Seuls les membres des r�les de serveur fix�s sysadmin et dbcreator peuvent ex�cuter cette proc�dure. Pour plus d'informations sur la proc�dure stock�e sp_attach_db, reportez-vous � la rubrique "sp_attach_db, Transact-SQL Reference" (sp_attach_db, R�f�rence Transact-SQL) dans la documentation en ligne de SQL�Server.

Les informations suivantes sur l'utilisation de l'utilitaire osql s'appliquent �galement � toutes les �ditions de Microsoft�SQL Server�2000.

Retour au d�but

R�f�rences

Pour t�l�charger une version mise � jour de la documentation en ligne de SQL�Server, reportez-vous au site Web de Microsoft � l'adresse suivante�(en anglais) :

http://www.microsoft.com/sql/techinfo/books.mspx (http://www.microsoft.com/sql/techinfo/books.mspx)

Pour t�l�charger la version SQL�Server�7.0 de la documentation en ligne de SQL�Server, reportez-vous au site Web de Microsoft � l'adresse suivante�:

http://download.microsoft.com/download/SQL70/File/2/Win98/En-US/SQLBOL.exe (http://download.microsoft.com/download/sql70/file/2/win98/en-us/sqlbol.exe)

Pour plus d'informations sur MSDE�2000, consultez les articles suivants dans la Base de connaissances Microsoft�:

319930� (http://support.microsoft.com/kb/319930/ ) Comment faire pour se connecter � Microsoft Desktop Engine

241397� (http://support.microsoft.com/kb/241397/ ) Comment faire pour sauvegarder une base de donn�es Microsoft Desktop Engine � l'aide de Transact-SQL

Retour au d�but

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft SQL Server 2000 Desktop Engine (Windows)
Microsoft SQL Server 2000 Desktop Engine (MSDE) SP3a

Retour au d�but

kbdownload kbhowtomaster KB325003

Retour au d�but

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

Cet article concerne des produits pour lesquels Microsoft n'offre plus de support. Il est par cons�quent fourni � en l'�tat � et ne sera plus mis � jour.

Retour au d�but

This site in other countries/regions:

Comment faire pour g�rer SQL Server Desktop Engine (MSDE�2000) ou SQL Server�2005 Express Edition � l'aide de utilitaire osql

Sommaire

R�sum�

Qu'est-ce que Osql�?

Comment utiliser Osql�?

Saisie interactive d'instructions Transact-SQL

Envoi d'un travail Osql

Connexion � SQL�Server�Desktop�Engine (MSDE�2000)

Gestion de MSDE�2000

Cr�ation d'une connexion

Acc�s � une base de donn�es

Modification du mot de passe d'une connexion

Cr�ation d'une base de donn�es

Sauvegarde et restauration de bases de donn�es

Attachement et d�tachement d'une base de donn�es

R�f�rences

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Mots-cl�s :�

Envoyez-nous vos commentaires sur les informations de cette page

Autres sites d'aide

Communaut�s

Traductions disponibles