Partager via


Comment : renommer des objets de base de données

Cette rubrique explique comment renommer un objet de base de données dans Visual Studio Premium. Lorsque vous renommez un objet de base de données, les autres objets qui référencent l'objet renommé sont automatiquement mis à jour avec le nouveau nom. Par exemple, si vous renommez une colonne d'une table, toutes les procédures stockées qui référencent cette colonne sont automatiquement mises à jour avec le nouveau nom. Pour plus d'informations, consultez Renommer toutes les références à un objet de base de données.

Pour renommer un objet de base de données

  1. 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.

    Notes

    Dans Visual Studio Premium, vous refactorisez des objets de base de données à l'aide de la vue Schéma. Vous ne pouvez pas refactoriser des objets de base de données dans une fenêtre de code.

  2. 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.

    Notes

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

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

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

    Notes

    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 appliquer ces modifications.

  5. (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.

  6. (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.

    Notes

    Si vous renommez un objet de base de données lorsque vous avez des erreurs de build 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 build, l'objet est renommé et autant de références que possible sont mises à jour. Vous pouvez également corriger d'abord les erreurs de build, 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.

  7. 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.

    Notes

    Vous pouvez annuler les modifications. Pour plus d'informations, consultez Comment : annuler une opération de refactorisation de base de données.

    En plus des fichiers journaux facultatifs mentionnés à l'étape 6, à chaque fois que vous déplacez un objet de base de données vers un autre schéma, les entrées sont écrites dans le fichier NomProjet.refactorlog. Ce fichier fait partie de votre projet de base de données et est utilisé lorsque vous déployez le projet de base de données. Vous devez l'archiver dans le contrôle de version et gérer le fichier comme vous le feriez pour toute autre ressource de projet partagée. Pour plus d'informations, consultez Déplacer un objet de base de données vers un autre schéma.

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, puis cliquez sur OK.

    La boîte de dialogue Aperçu des modifications s'affiche. Elle comprend un volet supérieur et un volet 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 Transact-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.

    Notes

    Vous pouvez annuler les modifications. Pour plus d'informations, consultez Comment : annuler une opération de refactorisation de base de données.

Voir aussi

Tâches

Procédure pas à pas : appliquer des techniques de refactorisation de base de données

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

Concepts

Renommer toutes les références à un objet de base de données