Partager via


Comment : renommer les références à un serveur ou une base de données

Vous pouvez utiliser la refactorisation de base de données pour mettre à jour automatiquement les noms des serveurs, les bases de données ou les variables SETVAR dans les références entre bases de données dans l'ensemble de votre projet de base de données. Pour plus d'informations, consultez Utilisation de références dans les projets de base de données.

Name Matching

Si vous spécifiez à la fois un nom (ou une variable) pour un serveur, et un nom (ou une variable) pour une base de données, l'opération de changement de nom ne mettra à jour que les références qui pointent sur cette base de données et ce serveur spécifiques. Si vous spécifiez un nom (ou une variable) pour un serveur mais pas pour une base de données, l'opération de changement de nom mettra à jour toutes les références qui incluent le nom du serveur (ou la variable) que vous avez spécifié, quelle que soit la base de données sur laquelle pointe la référence. Si vous spécifiez un nom (ou une variable) pour une base de données mais pas pour un serveur, l'opération de changement de nom mettra à jour toutes les références qui incluent le nom de la base de données (ou la variable), quel que soit le serveur sur lequel pointe la référence. Vous devez passer en revue les modifications dans la boîte de dialogue Aperçu des modifications avant de les appliquer.

Notes

Pour que vous puissiez suivre cette procédure, il faut qu'au moins une référence figure dans les propriétés du projet de base de données.

Renommer les références à un serveur ou une base de données

  1. Ouvrez la solution qui contient le projet de base de données dans lequel vous souhaitez renommer des références. Pour plus d'informations, consultez Comment : ouvrir un projet de base de données ou serveur.

  2. Dans l'Explorateur de solutions ou la vue Schéma, cliquez sur le projet de base de données dans lequel vous souhaitez renommer des références.

  3. Dans le menu Données, pointez sur Refactoriser, puis cliquez sur Renommer les références à un serveur/une base de données.

    Notes

    Vous pouvez également cliquer avec le bouton droit sur le projet de base de données dans l'Explorateur de solutions ou la vue Schéma, pointer sur Refactoriseret cliquer sur Renommer les références à un serveur/une base de données.

    La boîte de dialogue Renommer les références à un serveur/une base de données apparaît.

  4. Pour remplacer le nom d'un serveur ou une variable serveur :

    1. Activez la case à cocher Remplacer le nom d'un serveur ou d'une variable serveur si ce n'est déjà fait.

    2. Dans Ancien nom, tapez le nom du serveur ou la variable serveur que vous souhaitez remplacer.

    3. Dans Nouveau nom, tapez le nom à utiliser au lieu de celui que vous souhaitez remplacer.

  5. Pour remplacer le nom d'une base de données ou une variable de base de données :

    1. Activez la case à cocher Remplacer le nom d'une base de données ou d'une variable de base de données si ce n'est déjà fait.

    2. Dans Ancien nom, tapez le nom de la base de données ou de la variable de base de données que vous souhaitez remplacer.

    3. Dans Nouveau nom, tapez le nom à utiliser au lieu de celui que vous souhaitez remplacer.

  6. (Facultatif) Activez la case à cocher Aperçu des modifications.

    Notes

    Pour plus d'informations sur la façon d'avoir un aperçu des modifications avant de les appliquer, consultez la procédure suivante.

  7. (Facultatif) Activez la case à cocher Générer un journal de refactorisation.

    Les journaux de refactorisation se trouvent à l'emplacement suivant : CheminDeVotreProjet\Journaux de refactorisation.

    Notes

    Vous pouvez renommer une référence même si votre projet contient des erreurs de build. L'opération d'attribution d'un nouveau nom met à jour autant de références à cet objet que possible, mais certaines références risque de ne pas être mises à jour. Dans la mesure du possible, corrigez les erreurs de build en premier, puis procédez à l'attribution de nouveau nom. Pour plus d'informations, consultez Considérations à prendre en compte avant de renommer des objets de base de données.

  8. Cliquez sur OK.

    Si vous n'avez pas activé la case à cocher Aperçu des modifications, les références aux noms ou variables de serveur ou de base de données sont mises à jour.

    Si vous avez activé la case à cocher Aperçu des modifications, la boîte de dialogue Aperçu des modifications, qui comprend un volet supérieur et un volet inférieur, apparaît. Le volet supérieur affiche une arborescence répertoriant les objets qui seront modifiés, et le volet inférieur affiche le script qui sera généré pour apporter les modifications. L'ancien nom apparaît dans le volet supérieur, et le nouveau nom dans le volet inférieur.

Pour afficher un aperçu des modifications avant de les appliquer

  1. Dans le volet supérieur de la boîte de dialogue Aperçu des modifications, développez le nœud Scripts.

    Un nœud .sql pour l'objet de schéma que vous renommez (ou l'objet qui le contient) s'affiche, ainsi que les nœuds .sql pour tous les objets de schéma qui font référence à l'objet que vous renommez.

  2. Cliquez sur l'un des nœuds .sql.

    Le volet inférieur affiche le code Transact-SQL avec le nouveau nom en surbrillance.

  3. Cliquez sur Appliquer.

    Le nom de l'objet est mis à jour, et le nouveau nom apparaît dans la vue Schéma.

Voir aussi

Tâches

Comment : ajouter des références à des projets de base de données

Concepts

Renommer les références à un serveur ou une base de données

Utilisation de références dans les projets de base de données