Comment : renommer des objets de base de données

Mise à jour : novembre 2007

Lorsque vous renommez un objet de schéma dans Visual Studio Team System Database Edition, vous pouvez utiliser la refactorisation pour mettre à jour automatiquement d'autres objets qui y font référence afin qu'ils utilisent le nouveau nom. Par exemple, si vous renommez une colonne dans une table, vos pouvez mettre à jour automatiquement les procédures stockées qui y font référence afin qu'elles utilisent le nouveau nom. Pour plus d'informations, consultez Vue d'ensemble de la refactorisation de changement de nom.

Pour renommer un objet de base de données

1. Dans l'Explorateur de solutions, ouvrez votre projet de base de données.

2. Dans le menu Affichage, cliquez sur Vue Schéma de base de données.

3. Dans la vue Schéma, cliquez sur l'objet que vous souhaitez renommer. Par exemple, pour renommer une colonne, développez le sous-dossier Tables, la table, le dossier Colonnes, puis cliquez sur l'objet que vous souhaitez renommer.

   Remarque :
   Dans Database Edition, vous refactorisez des objets de schéma à l'aide de la vue Schéma. Vous ne pouvez pas refactoriser des objets de schéma à partir d'une fenêtre de code.

4. Dans le menu Données, pointez sur Refactoriser, puis cliquez sur Renommer. Vous pouvez également cliquer avec le bouton droit sur l'objet dans la vue Schéma, pointer sur Refactoriser, puis cliquer sur Renommer.

   La boîte de dialogue Renommer s'affiche.

   Remarque :
   Vous ne pouvez pas renommer un objet de base de données si l'objet que vous essayez de renommer contient des erreurs de génération. Dans ce cas, l'option de menu est désactivée.

5. Dans Nouveau nom, tapez le nouveau nom de l'objet.

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

   Remarque :
   Pour plus d'informations sur la façon de prévisualiser les modifications avant de les apporter, consultez la procédure suivante. Par défaut, les références dans les tests unitaires et les scripts ne sont pas mises à jour automatiquement. Vous devez utiliser la boîte de dialogue Aperçu des modifications pour choisir d'appliquer ces modifications.

7. (Facultatif) Activez la case à cocher Prendre le schéma de projet par défaut dbo pour les références de script non qualifié et les tests unitaires.

   Si la case à cocher est désactivée et que vous ne spécifiez pas de noms qualifiés complets dans les scripts et tests unitaires, ces références sont introuvables. Si la case à cocher est activée et que vous ne spécifiez pas de noms qualifiés complets dans les scripts et tests unitaires, il est supposé que le schéma par défaut pour ces objets est le même que celui du projet.

8. (Facultatif) Activez la case à cocher Mettre à jour les références dans les objets de schéma contenant des avertissements ou erreurs.

   Si la case à cocher est désactivée, les références dans les objets dont les définitions provoquent des avertissements ou des erreurs ne seront pas incluses dans l'opération de refactorisation. Si la case à cocher est activée, toutes les références seront mises à jour, même si la définition de l'objet contenant comprend des avertissements ou des erreurs.

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

   Vous pouvez trouver les journaux de refactorisation à l'emplacement suivant : <CHEMIN D'ACCÈS À VOTRE PROJET>\Journaux de refactorisation.

   Remarque :

   Si vous renommez un objet de base de données lorsque vous avez des erreurs de génération dans votre projet, cet objet peut néanmoins être renommé correctement. Toutefois, les références à cet objet peuvent ne pas être toutes mises à jour correctement. Si votre projet contient des erreurs de génération, l'objet est renommé et autant de références que possible sont mises à jour. Vous pouvez également corriger d'abord les erreurs de génération, puis effectuer le changement de nom. Pour plus d'informations, consultez Considérations à prendre en compte avant de renommer des objets de base de données.

10. Cliquez sur OK.

    Si vous avez activé la case à cocher Aperçu des modifications, la boîte de dialogue Aperçu des modifications apparaît. Sinon, les modifications sont apportées. Le nom de l'objet est mis à jour, et le nouveau nom apparaît dans la vue Schéma.

    Remarque :
    Vous pouvez annuler les modifications. Pour plus d'informations, consultez Comment : annuler le changement de nom d'un objet de base de données.

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

1. Dans la boîte de dialogue Renommer, tapez le nouveau nom de l'objet.

2. Activez la case à cocher Aperçu des modifications et cliquez sur OK.

   La boîte de dialogue Aperçu des modifications apparaît et contient des volets supérieur et inférieur. Le volet supérieur contient une arborescence qui répertorie les objets qui seront modifiés et le volet inférieur affiche le script qui sera généré pour apporter les modifications. Le volet supérieur affiche l'ancien nom et le volet inférieur affiche le nouveau nom.

3. Dans le volet supérieur, développez Objets de schéma.

   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 référencent l'objet renommé.

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

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

5. Cliquez sur Appliquer.

   Les modifications sont apportées. Le nom de l'objet est mis à jour et vous pouvez afficher le nouveau nom dans la vue Schéma.

   Remarque :
   Vous pouvez annuler les modifications. Pour plus d'informations, consultez Comment : annuler le changement de nom d'un objet de base de données.

Voir aussi

Tâches

Comment : déployer des modifications de refactorisation d'une base de données

Procédure pas à pas : déploiement des modifications de refactorisation d'une base de données

Autres ressources

Procédure pas à pas : changement du nom d'une colonne de base de données

Changement du nom des objets de base de données