Onglet Package/publication SQL, Propriétés du projet

L'onglet Empaquetez/publication SQL sur la page Propriétés est une méthode héritée pour spécifier les paramètres de déploiement de base de données SQL Server.

Cette rubrique s'applique aux produits suivants :

Lorsque vous configurez la base de données de publication sous l'onglet Empaquetez/publication SQL , seul le déploiement initial d'une base de données est automatisé, et vous devez configurer le déploiement incrémentiel des mises à jour de base de données manuellement en créant des scripts personnalisés SQL. Lorsque vous configurez le déploiement de base de données dans le profil de publication à la place, les mises à jour de base de données incrémentielles ainsi que le déploiement initial de base de données sont automatisés. Pour plus d'informations, consultez Vue d'ensemble sur le déploiement de projet d'application Web pour Visual Studio et ASP.NET.

L'onglet Empaquetez/publication SQL doit être utilisé uniquement lorsqu'il a déjà configuré dans les projets hérités ou lorsque vous ne pouvez pas configurer le déploiement de base de données dans le profil de publication. Par exemple, si vous utilisez Windows XP ou Windows Server 2003 et votre application n'utilise pas transferts de code Entity Framework les premiers, vous ne pouvez pas configurer la base de données de publication dans le profil de publication. Dans ce cas, utilisez Empaquetez/publication SQL tableau.

Lorsque vous créez un profil de publication dans un projet qui a des paramètres de déploiement de base de données configurées sous l'onglet Empaquetez/publication SQL , l'assistant publiez le Web affiche un message d'avertissement.

Publish_Web_Settings_tab_with_Package_Publish_

Si vous souhaitez utiliser les paramètres de l'onglet Empaquetez/publication SQL , ne cliquez pas sur activez la base de données de publication des améliorations de paramètres. Si vous cliquez sur activez la base de données de publication des améliorations de paramètres, les paramètres de profil de publication auront la priorité et les paramètres Empaquetez/publication SQL sont ignorées. (Si vous cliquez sur activez la base de données de publication des améliorations de paramètres et décidez une fois que vous souhaitez utiliser les paramètres Empaquetez/publication SQL , vous devez créer un profil.)

Pour accéder à cet onglet sur la page des propriétés

  1. Dans Visual Studio, ouvrez un projet d'application Web.

  2. Cliquez avec le bouton droit sur le nom du projet dans l'Explorateur de solutions et sélectionnez Propriétés (C#) ou MonProjet (Visual Basic) pour afficher la page Propriétés.

  3. Cliquez sur l'onglet Package/Publication SQL.

    Onglet Package/Publication SQL des Propriétés du projet

    Si vous avez installé l'assistant publiez le Web , et si aucune configuration du projet n'a été écrite mais sous l'onglet Empaquetez/publication SQL , l'interface utilisateur normal pour cet onglet est remplacé par un avertissement indiquant que cet onglet ne doit pas être utilisé pour la modification avec rupture. Si vous devez configurer le déploiement de base de données sur l'onglet Empaquetez/publication SQL , cliquez sur activez cette page pour afficher l'interface utilisateur affichée dans l'illustration.

Éléments d'interface

  • Configuration
    Spécifie le type de configuration auquel s'appliquent les paramètres de l'onglet. Par exemple, vous pouvez spécifier des paramètres de package pour une configuration de débogage (Débogage) qui diffèrent des paramètres d'une configuration de production (Version finale). Lorsque vous sélectionnez un type de configuration, les paramètres que vous spécifiez sont stockés avec ce type de configuration. Si vous voulez les mêmes paramètres pour toutes les configurations, sélectionnez Toutes les configurations. Vous pouvez créer des types de configuration personnalisée en sélectionnant Gestionnaire de configurations dans le menu Générer.

  • Plateforme
    Spécifie le type du système d'exploitation auquel les paramètres s'appliquent.

  • Entrées de la base de données
    Spécifie une liste de bases de données à déployer. La grille de cette section contient une entrée pour chaque base de données à déployer. La section Détails des entrées de la base de données vous permet de spécifier des paramètres pour la base de données sélectionnée.

  • Colonne Déployer du tableau Entrées de la base de données
    Spécifie si la base de données sélectionnée doit être déployée. Cette option est utile lorsque vous voulez déployer une base de données uniquement la première fois où vous déployez un projet Web. Dans ce cas, après avoir déployé l'application la première fois, vous pouvez désactiver cette case à cocher et la base de données n'est pas incluse lorsque vous redéployez le même projet.

  • Colonne Nom du tableau Entrées de la base de données
    Spécifie un nom qui identifie une base de données que vous voulez déployer. Si la base de données est représentée par une chaîne de connexion dans le fichier Web.config, cette valeur est en général le nom de la chaîne de connexion avec un suffixe tel que « -Deployment » ou « -Web.config ».

    Le suffixe « -Web.config », (par exemple, « ConnectionStringName-Web.config ») spécifie que la valeur de chaîne de connexion du fichier Web.config doit être utilisée pour le déploiement. Pour plus d'informations, consultez Chaîne de connexion pour la base de données de destination plus loin dans ce document.

  • Boutons Flèche Haut ou Flèche Bas
    Permet de spécifier l'ordre dans lequel les bases de données sont déployées.

  • Importer à partir de Web.config
    Recherche les chaînes de connexion dans le fichier Web.config et entre leurs noms dans la grille Entrées de la base de données en ajoutant le suffixe « -Deployment ».

    Vous pouvez changer le suffixe « -Deployment » en « -Web.config » (par exemple, modifier « ConnectionStringName-Deployment » en « ConnectionStringName-Web.config ») pour spécifier que la valeur de chaîne de connexion du fichier Web.config doit être utilisée pour le déploiement. Pour plus d'informations, consultez Chaîne de connexion pour la base de données de destination plus loin dans ce document.

  • Ajouter
    Ajoute une ligne à la grille Entrées de la base de données.

  • Supprimer
    Supprime une ligne de la grille Entrées de la base de données.

  • Chaîne de connexion pour la base de données de destination
    Spécifie la chaîne de connexion à utiliser pour se connecter à la base de données de destination pendant le déploiement.

    Cette chaîne de connexion est utilisée uniquement pendant le déploiement, et non pour le fichier Web.config de l'application Web déployée, avec l'exception suivante. Si la valeur Nom pour cette base de données se termine par « - chaîne de connexion du fichier Web.config » (par exemple, « chaîne de connexion de ConnectionStringName-Web.config »), et si la partie du nom qui vient avant que le suffixe « - la chaîne de connexion du fichier Web.config » existe comme nom de chaîne de connexion dans le fichier Web.config de l'application, les règles suivantes s'appliquent :

    • Si vous laissez le champ vide, la valeur de chaîne de connexion dans le fichier Web.config est utilisée pour le déploiement. Si vous spécifiez une transformation pour la chaîne de connexion, la chaîne de connexion transformée est utilisée pour le déploiement.

    • Si vous entrez une valeur dans ce champ, la valeur que vous entrez est utilisée pour le déploiement et le fichier Web.config de destination est mis à jour pour contenir cette valeur.

      Notes

      Si vous spécifiez un nom de la base de données qui se termine par « - la chaîne de connexion du fichier Web.config » et vous spécifiez une transformation pour la même chaîne de connexion, la transformation n'est pas utilisée.La valeur que vous entrez dans ce champ est utilisée dans le fichier Web.config de destination.

  • Extraire les données et/ou le schéma d'une base de données existante
    Spécifie si le processus de déploiement doit générer des scripts (fichiers .sql) qui incluent les commandes qui peuvent recréer le schéma de la base de données source dans la base de données source, et éventuellement les données.

  • Chaîne de connexion pour la base de données source.
    Spécifie la chaîne de connexion à utiliser pour la base de données source.

  • Options de script de base de données
    Spécifie si seul le schéma de la base de données, seulement les données, ou le schéma et les données doivent être déployés sur la base de données de destination.

    Les scripts générés pour déployer le schéma incluent le schéma de la base de données complet. Il n'y a aucune option pour générer automatiquement des scripts qui reflètent uniquement les modifications de schéma après un déploiement initial. La même remarque s'applique aux données. Les scripts générés pour déployer les données incluent toutes les données de la base de données. Il n'y a aucune option pour générer automatiquement des scripts qui reflètent uniquement les modifications des données effectuées après un déploiement initial.

    Par défaut, lorsque les scripts s'exécutent pendant le déploiement, ils s'exécutent dans une transaction.

  • Tableau Scripts de base de données
    Spécifie les scripts qui s'exécutent dans la base de données de destination dans le cadre du processus de déploiement.

    Par défaut, les scripts personnalisés que vous ajoutez ici ne s'exécutent pas automatiquement dans une transaction. Si vous voulez les exécuter dans une transaction, spécifiez-le dans les scripts eux-mêmes. Pour plus d'informations sur la définition de l'attribut d' Transacted pour un script, consultez Comment : Paramètres de déploiement de modification du fichier projet.

  • Colonne Inclure du tableau Scripts de base de données
    Spécifie si le script indiqué dans la colonne Chemin d'accès au script doit s'exécuter lorsque le projet Web est déployé. Cette option est utile lorsque vous voulez exécuter des scripts uniquement la première fois où un projet est déployé.

  • Colonne Chemin d'accès au script du tableau Scripts de base de données
    Spécifie le chemin d'accès d'un script qui doit s'exécuter dans la base de données de destination pour déployer les modifications du schéma ou les données. (Dans le cas de scripts générés automatiquement, il n'y a aucun chemin d'accès pour le script. Une description du script est affichée à la place.)

  • Boutons Flèche Haut ou Flèche Bas
    Permet de spécifier l'ordre dans lequel les scripts s'exécutent pendant le déploiement.

  • Ajouter un script
    Permet d'ajouter un script personnalisé. Le script SQL et le script SqlCmd sont tous deux pris en charge. Les scripts personnalisés sont analysés pour rechercher les variables SqlCmd, et celles-ci sont converties automatiquement en paramètres d'installation dans le Outil de déploiement WebIIS. Pour plus d'informations sur les scripts SqlCmd, consultez sqlcmd Utility.

  • Supprimer le script
    Permet de supprimer un script.

  • Notes sur le déploiement de bases de données
    Fournit un emplacement pour que vous entriez vos remarques au format libre sur le déploiement. Ce texte n'est pas utilisé pour les fonctions automatisées.

Voir aussi

Concepts

Organigramme des informations relatives au déploiement Web pour Visual Studio et ASP.NET