Partager via


Comment : définir des variables pour les projets de base de données

Vous pouvez déployer votre projet de base de données dans plusieurs environnements en définissant des variables SQLCMD et en les intégrant à vos scripts de post-déploiement et prédéploiement. Par exemple, vous pouvez définir des variables SQLCMD pour un Service Broker ou un certificat de service.

Si vous définissez une variable SQLCMD en tant que variable MSBuild, vous pouvez lui attribuer une valeur spécifique à une configuration de build. Vous pouvez également substituer la variable MSBuild, depuis une invite de commandes, lorsque vous générez le projet de base de données. Vous ne pouvez pas définir une variable SQLCMD en tant qu'autre variable SQLCMD. Pour plus d'informations sur les variables MSBuild, consultez Propriétés MSBuild.

Notes

Vous pouvez combiner des variables SQLCMD et MSBuild dans le même script. Toutefois, vous ne devez pas donner à une variable SQLCMD le même nom qu'une variable MSBuild, car la variable MSBuild serait prioritaire.

La liste de variables et de leurs valeurs est stockée dans le dossier des propriétés du projet de base de données. Lorsque vous créez un projet, le fichier Database.sqlcmdvars est automatiquement créé. Vous pouvez définir plusieurs fichiers et les associer à différentes configurations de build si vous souhaitez fournir des valeurs différentes dans chaque configuration. Pour plus d'informations, consultez Comment : configurer les paramètres de déploiement pour des projets de base de données et serveur.

Notes

Visual Studio définit trois variables que vous pouvez utiliser dans vos définitions d'objet et vos scripts. Les valeurs de ces variables sont définies lorsque vous déployez le projet. La première variable est $ (DatabaseName) ; elle contient le nom de la base de données cible dans laquelle vous déployez le projet. La deuxième variable est $ (DefaultDataPath) ; elle contient le chemin d'accès dans lequel les fichiers destinés à la base de données sont stockés sur le serveur cible. La troisième variable est $(DefaultLogPath) ; elle contient le chemin d'accès dans lequel le fichier journal de la base de données est stocké sur le serveur cible.

Pour afficher les variables SQLCMD associées à un projet de base de données

  • Dans l'Explorateur de solutions, développez le projet de base de données pour lequel vous souhaitez afficher les variables SQLCMD, développez le dossier Propriétés, puis double-cliquez sur le fichier .sqlcmdvars à modifier.

    La liste des variables SQLCMD et de leurs valeurs s'affiche.

Pour ajouter une variable SQLCMD à un fichier .sqlcmdvars

  1. Affichez la liste dans laquelle vous souhaitez ajouter une variable SQLCMD.

    Pour plus d'informations, consultez la première procédure de cette rubrique.

  2. Dans la colonne Variable Name, cliquez dans la dernière ligne et tapez le nom de la variable que vous souhaitez ajouter.

  3. Dans la colonne Variable Value, cliquez dans la ligne dans laquelle vous venez d'ajouter un nom de variable et entrez une valeur pour la variable.

  4. Dans le menu Fichier, cliquez sur Enregistrer tout.

Pour modifier une variable SQLCMD dans un fichier .sqlcmdvars

  1. Affichez la liste qui contient la variable SQLCMD à modifier.

    Pour plus d'informations, consultez la première procédure de cette rubrique.

  2. Dans la colonne Variable Value, cliquez sur la ligne de la variable dont vous souhaitez modifier la valeur et entrez-en une nouvelle.

  3. Dans le menu Fichier, cliquez sur Enregistrer tout.

Pour supprimer une variable SQLCMD d'un fichier .sqlcmdvars

  1. Affichez la liste qui contient les variables SQLCMD à supprimer.

    Pour plus d'informations, consultez la première procédure de cette rubrique.

  2. Dans la colonne Nom de la variable, cliquez avec le bouton droit sur la ligne correspondant à la variable à supprimer et cliquez sur Supprimer.

  3. Dans le menu Fichier, cliquez sur Enregistrer tout.

Voir aussi

Tâches

Comment : ajouter des fichiers et des groupes de fichiers

Concepts

Vue d'ensemble de la génération et du déploiement d'une base de données

Vue d'ensemble des fichiers et des groupes de fichiers