Comment : ajouter des références à des projets de base de données
Vous pouvez ajouter plusieurs types de références aux projets de base de données pour gérer des situations différentes. Par exemple, vous pouvez faire référence à d'autres projets dans la même solution, ou vous pouvez faire référence à la sortie d'autres solutions. Vous suivez des procédures légèrement différentes pour ajouter des types différents de références. Par exemple, pour utiliser une référence entre bases de données, vous devez non seulement ajouter la référence mais également définir une variable et une valeur associée pour la base de données, le serveur, ou les deux. Pour plus d'informations sur les types de références et lorsque vous pouvez utiliser chacun d'eux, consultez Utilisation de références dans les projets de base de données.
Pour faire référence aux objets définis dans un projet de base de données dans la même solution
Ouvrez la solution qui contient le projet de base de données auquel vous souhaitez ajouter une référence.
Dans le menu Projet, cliquez sur Ajouter une référence de base de données.
La boîte de dialogue Ajouter une référence de base de données s'affiche.
Pour ajouter une référence à un projet de base de données, exécutez les étapes suivantes :
Cliquez sur Projets de base de données de la solution actuelle.
Dans la liste, cliquez sur le projet de base de données auquel vous souhaitez ajouter une référence.
Pour définir une variable SETVAR pour un serveur, exécutez les étapes suivantes :
Cliquez sur Définir la variable serveur.
Dans la zone Nom, tapez le nom de la variable qui représente le serveur.
Dans la zone Valeur, tapez le nom du serveur que la variable représente.
Notes
Vous n'avez pas besoin de définir une variable de serveur si vous faites référence à un objet dans une base de données qui réside sur le même serveur que la base de données à laquelle vous ajoutez la référence.
Pour spécifier une variable SETVAR pour la base de données à laquelle vous souhaitez faire référence, suivez ces étapes :
Activez la case à cocher Définir la variable de base de données.
Désactivez la case à cocher Littéral si elle a été sélectionnée.
Dans la zone Nom, tapez un nom pour la variable qui représente la base de données.
Dans la zone Valeur, tapez le nom de la base de données que la variable représente.
Important
Si votre projet de base de données contient des objets qui explicitement font référence aux objets dans une autre base de données, vous devez mettre à jour ces références pour utiliser les variables que vous venez de définir. Si vous avez importé des objets à partir d'une base de données qui contient des référence entre bases de données, vous devez mettre à jour les références pour résoudre les avertissements que ces références entre bases de données explicites entraînent.
Pour spécifier une valeur littérale pour la base de données à laquelle vous souhaitez faire référence, suivez ces étapes :
Activez la case à cocher Définir la variable de base de données.
Activez la case à cocher Littéral.
Dans la zone Valeur, tapez le nom de la base de données à laquelle vous voulez faire référence.
Notes
Vous pouvez spécifier un littéral au lieu d'une paire de variable et de valeur si le nom de la base de données est toujours le même dans votre environnement de déploiement cible. Par exemple, vous pourriez utiliser un littéral avec la valeur « MASTER » pour les objets définis dans la base de données « MASTER ».
Si le projet référencé peut référencer un autre projet, vous pouvez activer la case à cocher Supprimer les erreurs causées par des références non résolues dans le projet référencé. Les erreurs dans le projet référencé ne sont pas susceptibles de provoquer des erreurs dans votre projet actuel. Par conséquent, vous pouvez décider de les ignorer.
Si vous ne voulez pas mettre à jour les objets et les scripts, désactivez la case à cocher Mettre à jour les scripts et définitions d'objets de schéma existants pour utiliser les variables de référence de la base de données, puis cliquez sur OK.
La référence est ajoutée au projet de base de données, et vous n'avez pas besoin d'exécuter d'autres étapes dans cette procédure.
Si vous voulez mettre à jour les objets et les scripts, activez la case à cocher Mettre à jour les scripts et définitions d'objets de schéma existants pour utiliser les variables de référence de la base de données, puis cliquez sur OK.
La boîte de dialogue Afficher les modifications - Renommer le serveur ou la base de données apparaît.
(Facultatif) Désactivez la case à cocher en regard de l'une ou de plusieurs des modifications dans la liste si vous ne souhaitez pas que cette modification soit appliquée.
(Facultatif) Cliquez sur n'importe quelle modification pour en afficher les détails dans le volet Aperçu des modifications.
Cliquez sur Appliquer pour mettre à jour les objets et les scripts que vous avez spécifiés.
La référence est ajoutée au projet de base de données, et les objets et les scripts que vous avez spécifiés sont modifiés pour utiliser les variables SETVAR à la place des noms de serveurs et bases de données.
Pour faire référence aux objets définis dans la sortie compilée (fichier .dbschema) d'un autre projet de base de données
Ouvrez la solution qui contient le projet de base de données auquel vous souhaitez ajouter une référence.
Dans le menu Projet, cliquez sur Ajouter une référence de base de données.
La boîte de dialogue Ajouter une référence de base de données s'affiche.
Pour ajouter une référence pour un métafichier, exécutez les étapes suivantes :
Cliquez sur Métafichier (.dbmeta) ou schéma (.dbschema) de projet de base de données.
Dans la zone, tapez le chemin d'accès et le nom du fichier de schéma ou cliquez sur Parcourir pour spécifier le fichier de schéma pour lequel vous souhaitez ajouter une référence.
Pour définir une variable SETVAR pour un serveur, exécutez les étapes suivantes :
Cliquez sur Définir la variable serveur.
Dans la zone Nom, tapez le nom de la variable qui représente le serveur.
Dans la zone Valeur, tapez le nom du serveur que la variable représente.
Notes
Vous n'avez pas besoin de définir une variable de serveur si vous faites référence à un objet dans une base de données qui réside sur le même serveur que la base de données à laquelle vous ajoutez la référence.
Pour spécifier une variable SETVAR pour la base de données à laquelle vous souhaitez faire référence, suivez ces étapes :
Activez la case à cocher Définir la variable de base de données.
Désactivez la case à cocher Littéral si elle a été sélectionnée.
Dans la zone Nom, tapez un nom pour la variable qui représente la base de données.
Dans la zone Valeur, tapez le nom de la base de données que la variable représente.
Important
Si votre projet de base de données contient des objets qui explicitement font référence aux objets dans une autre base de données, vous devez mettre à jour ces références pour utiliser les variables que vous venez de définir. Si vous avez importé des objets à partir d'une base de données qui contient des référence entre bases de données, vous devez mettre à jour les références pour résoudre les avertissements que ces références entre bases de données explicites entraînent.
Pour spécifier une valeur littérale pour la base de données à laquelle vous souhaitez faire référence, suivez ces étapes :
Activez la case à cocher Définir la variable de base de données.
Activez la case à cocher Littéral.
Dans la zone Valeur, tapez le nom de la base de données à laquelle vous voulez faire référence.
Notes
Vous pouvez spécifier un littéral au lieu d'une paire de variable et de valeur si le nom de la base de données est toujours le même dans votre environnement de déploiement cible. Par exemple, vous pourriez utiliser un littéral avec la valeur « MASTER » pour les objets définis dans la base de données « MASTER ».
Si le projet référencé peut référencer un autre projet, vous pouvez activer la case à cocher Supprimer les erreurs causées par des références non résolues dans le projet référencé. Les erreurs dans le projet référencé ne sont pas susceptibles de provoquer des erreurs dans votre projet actuel. Par conséquent, vous pouvez décider de les ignorer.
Si vous ne voulez pas mettre à jour les objets et les scripts, désactivez la case à cocher Mettre à jour les scripts et définitions d'objets de schéma existants pour utiliser les variables de référence de la base de données, puis cliquez sur OK.
La référence est ajoutée au projet de base de données, et vous n'avez pas besoin d'exécuter d'autres étapes dans cette procédure.
Si vous voulez mettre à jour les objets et les scripts, activez la case à cocher Mettre à jour les scripts et définitions d'objets de schéma existants pour utiliser les variables de référence de la base de données, puis cliquez sur OK.
La boîte de dialogue Afficher les modifications - Renommer le serveur ou la base de données apparaît.
(Facultatif) Désactivez la case à cocher en regard de l'une ou de plusieurs des modifications dans la liste si vous ne souhaitez pas que cette modification soit appliquée.
(Facultatif) Vous pouvez cliquer sur n'importe quelle modification pour en afficher les détails dans le volet Aperçu des modifications.
Cliquez sur Appliquer pour mettre à jour les objets de schéma et scripts que vous avez spécifiés.
La référence est ajoutée au projet de base de données, et les objets et scripts que vous avez spécifiés sont modifiés pour utiliser les variables SETVAR à la place des noms de serveurs et bases de données.
Pour inclure le contenu d'un projet de base de données dans la solution actuelle dans le cadre du projet de référence
Ouvrez la solution qui contient le projet de base de données auquel vous souhaitez ajouter une référence.
Dans le menu Projet, cliquez sur Ajouter une référence de base de données.
La boîte de dialogue Ajouter une référence de base de données s'affiche.
Cliquez sur Projets de base de données de la solution actuelle, cliquez ensuite sur le projet de base de données auquel vous souhaitez ajouter une référence, puis sur OK.
La référence est ajoutée au projet de base de données. Lorsque vous déployez le projet auquel vous avez ajouté la référence, le projet que vous avez spécifié dans la référence est traité dans le cadre du projet que vous déployez.
Pour ajouter une référence à un projet SQLCLR dans la solution actuelle
Ouvrez la solution qui contient le projet de base de données auquel vous souhaitez ajouter une référence.
Dans le menu Projet, cliquez sur Ajouter une référence.
La boîte de dialogue Ajouter une référence s'affiche.
Cliquez sur l'onglet Projets s'il n'est pas déjà actif.
Cliquez sur le nom du projet CLR (Common Language Runtime) SQL auquel vous souhaitez faire référence, puis sur OK.
La référence est ajoutée au projet de base de données.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la référence, puis sur Propriétés.
La fenêtre Propriétés s'affiche.
Mettez à jour les propriétés de la référence pour spécifier les détails de l'instruction CREATE ASSEMBLY générée lorsque vous créez le projet de base de données.
Dans le menu Fichier, cliquez sur Enregistrer tout.
Pour ajouter une référence à une assembly SQLCLR
Ouvrez la solution qui contient le projet de base de données auquel vous souhaitez ajouter une référence.
Dans le menu Projet, cliquez sur Ajouter une référence.
La boîte de dialogue Ajouter une référence s'affiche.
Cliquez sur l'onglet Parcourir s'il n'est pas déjà actif.
Spécifiez l'assembly (.dll) auquel vous souhaitez faire référence, puis cliquez sur OK.
La référence est ajoutée au projet de base de données.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la référence, puis sur Propriétés.
La fenêtre Propriétés s'affiche.
Mettez à jour les propriétés de la référence pour spécifier les détails de l'instruction CREATE ASSEMBLY générée lorsque vous créez le projet de base de données.
Dans le menu Fichier, cliquez sur Enregistrer tout.
Voir aussi
Concepts
Utilisation de références dans les projets de base de données
Démarrage du développement en équipe de bases de données faisant référence à des objets SQLCLR