Source Control : gérer vos procédures stockées SQL Serveur comme du simple code dans VS.NET

Article Rédigé pour

09/10/2003
Par Elise Dupont

niveau : facile
durée : de 10 à 20 minutes

Version PDF à télécharger

Droit de diffusion:
L'ensemble ou partie de ce document ainsi que le code mis à disposition, ne peut être diffusé sur d'autres sites Web sans l'autorisation au préalable de son créateur.

Avant Propos :
Que vous travaillez en équipe ou que vous vouliez tout simplement conserver une version de votre code étape par étape, nombreux sont les gens qui utilisent Source Safe avec VS.Net pour leur développement. S’il vous est en plus déjà arrivé de devoir créer des procédures stockées sous SQL Serveur, cet article est pour vous. En effet, il serait vraiment pratique de pouvoir gérer votre procédures stockées comme n’importe quel autre code.
A priori, le but de cet article semble très simple, mais si vous faites partie des nombreux développeurs qui ont le serveur SQL sur une machine séparée de leur machine de développement (ce qui est fréquent dès que l’on fait de gros projets de développement en équipe), la tache peut s’avérer plus complexe que prévu, et la documentation sur le sujet est bien maigre. Une piste est donnée sur le site MSDN pour Visual Studio 6, mais ce n’est qu’une partie de la piste…
Nous allons exposer étape par étape comment réussir a intégrer l’édition et la manipulation de procédures stockées sous source control, et ceci sous VS.Net.

Sommaire:

1. Les outils
2. Configurer le Serveur SQL
3. Configurer la machine de développement
4. Gérer les procédures stockées (check-in, check-out, édition, test, debug pas à pas)
5. Avantages et limitations
6. Sources additionnelles

1. Les outils

Pour commencer, il vous faut les fichiers d’installation de SourceSafe et de Vs.Net 2003, car même si vous avez déjà installé VS.Net, il vous faudra peut-être modifier des options d’installation. De plus, nous allons installer une partie de VS.Net sur le serveur SQL.

2. Configurer le Serveur SQL

Il faut installer Source Safe sur la même machine que SQL Serveur.

Vous créez une base Source Safe dessus, ainsi que des droits d’accès etc… (l’administration de Source Safe n’est pas le sujet de cet article, pour ca rendez-vous au chapitre 6 )

Assurez-vous que la machine soit sous un compte qui a été ajouté dans Source Safe. Lancez ensuite l’installation de VS.Net, en décochant toutes les options sauf « Server components/VS 6 Stored Procedure Version Control »

C’est tout pour la partie configuration du Serveur :-)

3. Configurer la machine de développement

Si vous avez déjà installé VS.Net sur votre machine assurez vous que certaines options d’installation ont été cochées, sinon rajoutez les :

Lancez l’Install de VS.Net

Assurez vous que sous le nœud « Composants Serveurs » vous ayez coché l’option « Server components/VS 6 Stored Procedure Version Control » et tant qu’a faire cochez aussi l’option « Remote Debugger », cela peut etre très utile comme je l'explique plus tard.

Ensuite installez Source Safe sur votre machine de développement (si ce n'est pas déja fait).

Ouvrez VS.Net et assurez-vous que l’option «enable version control» a été cochée sous le menu «Tools | Options | Database tools»

4. Gérer les procédures stockées (check-in, check-out, édition, debug pas à pas)

A présent vous avez tout ce qu’il vous faut pour rajouter les procédures stockées d’une base de donnée (ou en créer) dans Source Safe, puis les éditer directement dans VS.Net.

D’abord, créez une connexion a votre Base SQL Serveur. Ensuite dans la base qui apparaît, allez sur le nœud « stored procedures » et cliquez droit : sélectionnez « add to source control »

Un message de sécurité peut apparaître, cliquez sur oui et continuez

Une fenêtre vous demandant les paramètres de Source Safe va apparaître, il vous faut renseigner le chemin vers le fichier srcsafe.ini qui a été crée lorsque vous avez crée une nouvelle base Source Safe sur le serveur. Dans notre exemple le chemin « c:\SS\srcsafe.ini » fait référence au répertoire "SS" sous le disque C: de notre serveur SQL, pas de la machine de développement.

Ensuite on vous demande un compte pour vous identifier sous Source Safe (le compte dont je parle plus haut)

Voilà, vous pouvez à présent manipuler les procédures stockées. Si vous les ajoutez a Source Safe, un icône en forme cadenas apparaîtra devant les procédures stockées.

Vous pouvez à présent les Check out, les éditer, et les Check in à nouveau dans Source Safe. Vous pouvez même les exécuter en mode debug pas à pas.

Pour cela il vous suffit (dans l’éditeur) de cliquer droit sur le code et de sélectionner «Step into procedure » et comme vous le montre la capture d’écran suivante, le code s’exécute pas à pas, vous pouvez observer le contenu de vos variables etc…

5. Avantages et limitations

L’avantage est évident : vous pouvez gérer votre procédures stockées de la même façon que le reste de vos codes. Le petit soucis d’utilisation (qui n’en est pas un très sérieux) est que vous ne pouvez effectuer aucune opération de Source Control sur vos procédures stockées tant que celles-ci sont ouvertes dans l’éditeur de VS.Net. C’est à dire qu’il vous faudra fermer le code avant de pouvoir effectuer les opérations Check out et Check in.

6. Sources additionnelles

C’est justement parce que la documentation est quasi inexistante que j’ai écris cet article :)
Vous trouverez un debut de piste ici : Versioning Stored Procedures with Visual Studio 6.0 and SQL Server 7.0 et la : Enable Source Control Dialog Box (les deux liens sont en anglais) bien que la documentation fasse référence a Visual Studio 6 et pas VS.Net.
Pour plus d’informations sur comment utiliser Source Safe vous pouvez jeter un œil ici : Microsoft Source Safe (en français)