Procédure pas à pas : création et déploiement d'un projet de base de données qui utilise un objet CLR SQL

Article
08/10/2011

Pour créer et déployer une base de données qui utilise un assembly CLR SQL (Common Language Run-time SQL Server), créez un projet de base de données et un projet CLR SQL. Lorsque vous générez et déployez le projet de base de données, vous déployez automatiquement et simultanément l'assembly CLR SQL qu'il référence.

Dans cette procédure pas à pas, vous exécuterez les tâches suivantes :

Créer un projet de base de données simple.
Créer un projet CLR SQL et définir un nouveau type de données.
Utiliser le type que vous avez défini dans l'assembly CLR SQL.
Générer et déployer le projet de base de données.

Composants requis

Visual Studio 2010 Premium doit être installé pour pouvoir effectuer cette procédure. Vous devez avoir accès à une instance de SQL Server 2005 ou de SQL Server 2008. Vous devez avoir installé les exemples de code pour SQL Server à partir du site Web de CodePlex. Vous devez disposer des autorisations suivantes pour déployer une base de données sur votre serveur de base de données.

Créer un projet de base de données

Pour créer un projet de base de données

Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

La boîte de dialogue Nouveau projet s'affiche.
Sous Modèles installés, développez le nœud Base de données, puis cliquez sur le nœud SQL Server.

Notes

Si vous utilisez Visual Studio 2010 Professional, vous devez également développer le nœud Avancé avant de cliquer sur SQL Server.
Dans la liste des modèles, cliquez sur Projet de base de données SQL Server 2008.
Dans la zone Nom, tapez SQLClrDatabaseSandbox.

Important

Dans les zones Emplacement et Nom de solution, ne modifiez pas les valeurs par défaut.
Activez la case à cocher Créer le répertoire pour la solution si elle ne l'est pas déjà.
Désactivez la case à cocher Ajouter au contrôle de code source si elle ne l'est pas déjà, puis cliquez sur OK.

Le projet de base de données vide s'affiche dans l'Explorateur de solutions.

Ensuite, créez un projet pour l'assembly CLR SQL.

Créer un projet CLR SQL

Pour créer un projet CLR SQL

Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Projet.

La boîte de dialogue Nouveau projet s'affiche.
Dans Types de projets, développez le nœud Base de données et cliquez sur SQL Server.
Dans la liste Modèles, cliquez sur Projet serveur de projet de base de données CLR SQL Visual Basic ou Projet de base de données CLR SQL Visual C#.
Dans la zone Nom, tapez SupportingSQLClrObjects.
Cliquez sur OK pour accepter l'emplacement par défaut, fermer la boîte de dialogue et créer le projet.

Le projet de base de données vide s'affiche dans l'Explorateur de solutions.
Dans la boîte de dialogue Ajouter une référence de base de données, cliquez sur Annuler.

En cliquant sur Annuler, vous autorisez le projet de base de données à déterminer à quel emplacement l'assembly sera déployé.

Ensuite, créez un type de données personnalisé dans l'assembly CLR SQL.

Pour définir un type de données CLR SQL personnalisé

Dans le menu Projet, cliquez sur Ajouter un type défini par l'utilisateur.

La boîte de dialogue Ajouter un nouvel élément s'affiche.
Dans la zone Nom, tapez MyCustomType.cs.

L'éditeur de code s'ouvre et affiche le contenu de MyCustomType.cs.

Notes

À ce stade, vous devez modifier le type défini par l'utilisateur par défaut pour fournir une implémentation qui réponde à vos exigences. Pour cette procédure pas à pas, vous accepterez l'implémentation par défaut. Pour plus d'informations sur la définition de types personnalisés et d'autres objets CLR SQL, consultez la rubrique suivante sur le site Web Microsoft : Utilisation de l'intégration CLR dans SQL Server 2005.
Dans le menu Fichier, cliquez sur Enregistrer MyCustomType.cs.

Pour configurer et générer l'assembly CLR SQL

Dans le menu Générer, cliquez sur Gestionnaire de configurations.

La boîte de dialogue Gestionnaire de configurations s'affiche.
Dans Contextes des projets, désactivez la case à cocher Déployer sur la ligne de l'assembly SupportingSQLClrObjects.

En désactivant la case à cocher, vous empêchez le déploiement de l'assembly lorsque vous déployez la solution. Étant donné que l'assembly sera déployé avec le projet de base de données, vous ne voulez pas déployer l'assembly à deux reprises.
Cliquez sur Fermer.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet SupportingSQLClrObjects, puis cliquez sur Générer.

L'assembly est généré sans erreur.

Ensuite, référencez le nouvel assembly et utilisez le type que vous avez défini dans cet assembly.

Utiliser le type défini dans l'assembly CLR SQL

Pour utiliser le type que vous avez défini dans l'assembly SQCLR, vous devez ajouter une référence de votre projet de base de données à cet assembly. Définissez ensuite le nouveau type de données dans votre projet de base de données afin que vous puissiez utiliser l'utiliser dans les définitions d'objet.

Pour ajouter une référence à un assembly CLR SQL

Dans l'Explorateur de solutions, développez le projet SQLClrDatabaseSandbox, cliquez avec le bouton droit sur le nœud Références, puis cliquez sur Ajouter une référence.

Notes

Vous pouvez également cliquer sur le projet SQLClrDatabaseSandbox dans l'Explorateur de solutions, ouvrir le menu Projet et cliquer sur Ajouter une référence.

La boîte de dialogue Ajouter une référence s'ouvre.
Sous l'onglet Projets, vérifiez que le projet SupportingSQLClrObjects est mis en surbrillance, puis cliquez sur OK.

Une référence au projet CLR SQL est ajoutée à votre projet de base de données.
Dans l'Explorateur de solutions, développez le nœud Références, cliquez sur le nœud SupportingSQLClrObjects et appuyez sur F4.

Les propriétés de la référence apparaissent.
Vérifiez que Copie locale a la valeur True et que le Niveau d'autorisation a la valeur Sécurisé.
Dans la propriété Nom de l'assembly, remplacez SqlClassLibrary par SupportingSQLClrObjects.
Dans la propriété Propriétaire, tapez dbo.

Vous pouvez spécifier un autre propriétaire.
Dans le menu Fichier, cliquez sur Enregistrer tout.

Les propriétés que vous avez spécifiées contrôlent l'instruction CREATE ASSEMBLY créée lorsque vous générez le projet.

Ensuite, définissez un type de données qui utilise l'assembly produit par le projet CLR SQL.

Pour définir le nouveau type de données

Dans le menu Affichage, cliquez sur Liste d'erreurs et Vue Schéma de base de données.
Développez le nœud SQLClrDatabaseSandbox, développez le nœud Schémas, développez le nœud dbo, puis développez le nœud Programmabilité.
Cliquez avec le bouton droit sur le nœud Types, pointez sur Ajouter, puis cliquez sur Type défini par l'utilisateur (CLR).

La boîte de dialogue Ajouter un nouvel élément s'affiche.
Dans la liste Modèles, vérifiez que Type défini par l'utilisateur (CLR) est mis en surbrillance.
Dans la zone Nom, tapez MyCustomType et cliquez sur Ajouter.

L'éditeur Transact-SQL apparaît et affiche la définition du type. Dans la fenêtre Liste d'erreurs, l'erreur suivante apparaît :

SR0029 : Microsoft.Validation : User Defined Type: [dbo].[MyCustomType] has an unresolved reference to Assembly [assembly_name]

Dans l'éditeur Transact-SQL, mettez à jour le code comme suit :

CREATE TYPE [dbo].[MyCustomType]
EXTERNAL NAME [SupportingSQLClrObjects].[MyCustomType]

Dans le menu Fichier, cliquez sur Enregistrer MyCustomType.udtclr.sql.

Dans la fenêtre Liste d'erreurs, l'erreur disparaît car vous avez mis à jour la définition de type pour faire référence à un assembly et une classe valides.

Ensuite, définissez une table simple qui utilise le nouveau type de données.

Pour utiliser le nouveau type de données dans une définition de table

Dans Vue Schéma, ouvrez le nœud Schémas et ouvrez le nœud dbo.
Cliquez avec le bouton droit sur le nœud Tables, pointez sur Ajouter, puis cliquez sur Table.

La boîte de dialogue Ajouter un nouvel élément s'affiche.
Dans la liste Modèles, vérifiez que Table est mis en surbrillance.
Dans la zone Nom, tapez SimpleTable et cliquez sur Ajouter.

L'éditeur Transact-SQL apparaît et affiche la définition de la table.

Dans l'éditeur Transact-SQL, mettez à jour le code comme suit :

CREATE TABLE [dbo].[SimpleTable]
(
column_1 int NOT NULL, 
column_2 [dbo].[MyCustomType] NULL
)

Dans le menu Fichier, cliquez sur Enregistrer dbo.SimpleTable.table.sql.

Ensuite, configurez le projet de base de données, puis déployez-le dans un environnement de développement isolé.

Générer et déployer le projet de base de données

Pour configurer les paramètres de génération

Dans l'Explorateur de solutions, cliquez sur SQLClrDatabaseSandbox.
Dans le menu Projet, cliquez sur Propriétés de SQLClrDatabaseSandbox.
Cliquez sur l'onglet Générer et passez en revue les paramètres par défaut.

Dans cette procédure pas à pas, vous pouvez utiliser les paramètres par défaut.

Ensuite, configurez les paramètres de déploiement.

Pour configurer les paramètres de déploiement

Cliquez sur l'onglet Déployer.
Dans la liste Déployer une action, cliquez sur Créer un script de déploiement (.sql) et le déployer vers la base de données.
Dans la liste Configurer les paramètres de déploiement pour, cliquez sur Mon environnement de développement isolé.

En spécifiant ce paramètre, vous configurez les valeurs qui affectent uniquement votre environnement de développement isolé. Vous ne changerez pas les paramètres pour le projet de base de données.
Dans Nom du script de déploiement, acceptez la valeur par défaut.
Dans Paramètres de la base de données cible, cliquez sur Modifier pour spécifier une connexion cible.
Dans la boîte de dialogue Propriétés de connexion, spécifiez une connexion au serveur et à la base de données dans lesquels vous souhaitez déployer le projet de base de données, puis cliquez sur OK.
Dans Nom de la base de données cible, acceptez la valeur par défaut.
Dans la liste Fichier de configuration de déploiement, cliquez sur Properties\Database.deploymentconfig.

Par défaut, votre environnement de développement isolé n'est pas associé à un jeu de paramètres de déploiement détaillés. Lorsque vous spécifiez ce fichier, vous utilisez les paramètres de déploiement associés au projet de base de données. Vous pouvez également créer un fichier de configuration distinct et modifier les paramètres pour votre environnement de développement isolé.
Dans la liste Fichier de variables de la commande SQL, cliquez sur Properties\Database.sqlcmdvars.
Dans le menu Fichier, cliquez sur Enregistrer tout.

Ensuite, vous générez le projet de base de données.

Pour générer et déployer le projet de base de données

Dans le menu Générer, cliquez sur Générer la solution.

Le projet de base de données et le projet d'assembly CLR SQL sont correctement générés.
Dans le menu Générer, cliquez sur Déployer la solution.

Le projet de base de données et l'assembly CLR SQL sont déployés sur le serveur cible et dans la base de données que vous avez spécifiés dans les paramètres de déploiement. Dans la fenêtre Sortie, le message suivant apparaît :

========== Déploiement : 1 a réussi, 0 a échoué, 1 a été ignoré ==========

Le projet de base de données a été déployé avec succès. Lorsque vous avez déployé le projet de base de données, vous avez également déployé l'assembly CLR SQL. L'assembly CLR SQL ne devait pas être déployé distinctement, c'est pourquoi il a été ignoré lorsque vous avez déployé la solution.

Mettre le projet à disposition de l'équipe (facultatif)

Pour ajouter votre projet au contrôle de version

Dans l'Explorateur de solutions, cliquez sur le nœud SQLClrDatabaseSandbox.
Dans le menu Fichier, pointez sur Contrôle de code source, puis cliquez sur Ajouter la solution au contrôle de code source.

À ce stade, vous interagissez avec le logiciel de contrôle de version installé. Cette procédure pas à pas fournit des étapes permettant d'ajouter votre projet à Visual Studio Team Foundation Server. Si vous voulez utiliser un autre logiciel de contrôle de version, substituez les étapes équivalentes. Si vous utilisez Team Foundation Server, la boîte de dialogue Se connecter à Team Foundation Server s'affiche.
Dans Se connecter à Team Foundation Server, cliquez sur le serveur qui héberge le projet d'équipe auquel vous voulez ajouter votre solution.

Notes

Si vous n'avez pas de projet d'équipe auquel vous pouvez ajouter le projet de base de données, consultez Planification et suivi de projets.
Dans Projets d'équipe, cliquez sur le projet d'équipe auquel vous voulez ajouter le projet de base de données, puis cliquez sur OK.

La boîte de dialogue Ajouter la solution SQLClrDatabaseSandbox au contrôle de code source s'affiche.
Cliquez sur OK pour accepter les valeurs par défaut.

Votre projet de base de données et les fichiers qu'il contient sont placés sous contrôle de version. Initialement, ils sont encore extraits. Vous devez les archiver pour que d'autres membres de l'équipe puissent y accéder.
Dans le menu Affichage, pointez sur Autres fenêtres, puis cliquez sur Modifications en attente.

La fenêtre Modifications en attente s'affiche.
Dans le champ Commentaire, tapez Création de projet de base de données initial.
Dans la fenêtre Modifications en attente, cliquez sur Archiver dans la barre d'outils.

La boîte de dialogue Progression de l'archivage s'affiche pendant l'archivage du projet de base de données et des fichiers qu'il contient. Dans l'Explorateur de solutions, les icônes changent pour montrer que les fichiers sont archivés dans le contrôle de version.

Étapes suivantes

Vous pouvez ensuite créer des tests unitaires de base de données et un plan de génération de données pour tester l'assembly. Pour plus d'informations, consultez Configuration de projets de base de données et réalisation d'un déploiement de tests.