Procédure pas à pas : modification d'objets de base de données

Article
08/21/2008

Mise à jour : novembre 2007

Dans cette procédure pas à pas, vous utilisez l'éditeur Transact-SQL (T-SQL) pour modifier les définitions de plusieurs objets de base de données dans votre projet de base de données. Ce processus se compose des étapes suivantes :

Ouvrez une solution qui contient un projet de base de données.
Ajoutez une colonne à une table. Votre client veut suivre l'année où les produits ont été introduits. Pour exécuter cette étape, vous ajoutez une colonne DateAdded à la table Products.
Ajoutez une table, ShipperRating, afin de suivre la façon dont les clients estiment la qualité de service fournie par les expéditeurs qui s'occupent de leurs commandes. Vous ajoutez également des relations de clé étrangère et un index.

Composants requis

Cette procédure pas à pas suppose que vous avez effectué la Procédure pas à pas : placement d'un schéma de base de données existant sous contrôle de version. Suite à cette procédure pas à pas, vous avez une solution qui contient un projet de base de données nommé MyNorthwind.

Pour ouvrir la solution MyNorthwind

Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Projet/Solution.

La boîte de dialogue Ouvrir un projet s'affiche.
Ouvrez le dossier MyNorthwind, puis double-cliquez sur MyNorthwind.sln.

La solution MyNorthwind ouvre et s'affiche dans l'Explorateur de solutions.
Dans le menu Affichage, cliquez sur Vue Schéma.

La vue Schéma s'affiche si elle n'était pas déjà visible. Elle présente tous les objets qui sont définis dans le projet de base de données.
Développez le nœud de projet de base de données dans la vue Schéma s'il ne l'est pas déjà.

Ensuite, vous modifiez une définition de la table pour ajouter une colonne à une table.

Pour ajouter une colonne DateAdded à la table Products

Dans la vue Schéma, cliquez avec le bouton droit sur la table Products, puis cliquez sur Ouvrir. Vous pouvez également double-cliquer sur la table Products.

L'éditeur T-SQL s'ouvre et affiche la définition pour la table Products.

Dans l'éditeur T-SQL, modifiez la définition afin d'ajouter la colonne DateAdded comme le montre l'exemple suivant :

CREATE TABLE [dbo].[Products]
(
[ProductID] [int] NOT NULL IDENTITY(1, 1),
[ProductName] [nvarchar] (40) COLLATE SQL_Latin1_General_CP1_CS_AS NOT NULL,
[SupplierID] [int] NULL,
[CategoryID] [int] NULL,
[QuantityPerUnit] [nvarchar] (20) COLLATE SQL_Latin1_General_CP1_CS_AS NULL,
[UnitPrice] [money] NULL CONSTRAINT [DF_Products_UnitPrice] DEFAULT (0),
[UnitsInStock] [smallint] NULL CONSTRAINT [DF_Products_UnitsInStock] DEFAULT (0),
[UnitsOnOrder] [smallint] NULL CONSTRAINT [DF_Products_UnitsOnOrder] DEFAULT (0),
[ReorderLevel] [smallint] NULL CONSTRAINT [DF_Products_ReorderLevel] DEFAULT (0),
[Discontinued] [bit] NOT NULL CONSTRAINT [DF_Products_Discontinued] DEFAULT (0),
[DateAdded] [datetime] NULL
) ON [PRIMARY]

Dans le menu Fichier, cliquez sur Enregistrer dbo.Products afin d'enregistrer les modifications apportées.

Par défaut, le fichier est automatiquement extrait du contrôle de code source. Si vous avez modifié vos paramètres de contrôle de code source, vous êtes invité à extraire le fichier.

Ensuite, vous ajoutez une table nommée ShipperRating au projet de base de données.

Pour ajouter la table ShipperRating

Dans la vue Schéma, cliquez sur le dossier Tables.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément. Vous pouvez également cliquer avec le bouton droit sur le dossier Tables, pointer sur Ajouter, puis cliquer sur Table.

La boîte de dialogue Ajouter un nouvel élément s'affiche alors.
Dans la liste Modèles, cliquez sur Table.
Dans la zone Nom, tapez ShipperRating, puis cliquez sur Ajouter.

La table ShipperRating est ajoutée au projet de base de données et au contrôle de code source. L'éditeur T-SQL s'affiche afin que vous puissiez modifier la définition de cette table.

Dans l'éditeur T-SQL, modifiez la définition de la table afin qu'elle corresponde à l'exemple suivant :

-- =============================================
-- Create table definition for ShipperRating 
--Contains a rating of a shipper by
--a customer, on a particular date.
--Ratings are from 1-100.
-- =============================================
CREATE TABLE [dbo].[ShipperRating]
(
[ShipperID] [int] NOT NULL,
[CustomerID] [nchar] (5) COLLATE SQL_Latin1_General_CP1_CS_AS NOT NULL,
[RatingDate] [datetime] NULL,
[Rating] [int] NOT NULL
) ON [PRIMARY]

Dans le menu Fichier, cliquez sur Enregistrer dbo.ShipperRating afin d'enregistrer les modifications apportées.

Ensuite, vous ajoutez une clé étrangère à la table ShipperRating.

Pour ajouter la clé étrangère à la table ShipperRating

Dans la vue Schéma, cliquez avec le bouton droit sur la table ShipperRating, pointez sur Ajouter, puis cliquez sur Clé étrangère.

La boîte de dialogue Ajouter un nouvel élément s'affiche avec le modèle Clé étrangère déjà mis en surbrillance.

Dans la zone Nom, tapez FK_ShipperRating_Shippers, puis cliquez sur Ajouter.

La clé étrangère FK_ShipperRating_Shippers est ajoutée à la table ShipperRating de votre projet. L'éditeur T-SQL s'affiche afin que vous puissiez modifier la définition des clés étrangères.

Remarque :
La définition par défaut de la clé étrangère référence colonne_1 dans nomtable au lieu d'une table et d'une colonne réelles. Par conséquent, l'icône de FK_ShipperRating_Shippers dans la vue Schéma affiche l'icône d'erreur (un cercle rouge qui contient un « x » blanc). De plus, une erreur s'affiche dans la fenêtre Liste d'erreurs pour indiquer que vous avez une définition d'objet de base de données non valide. Ce comportement est prévu. Dans l'Explorateur de solutions, le fichier qui contient la définition d'objet n'affiche pas d'icône d'erreur.

La définition par défaut de la clé étrangère référence colonne_1 dans nomtable au lieu d'une table et d'une colonne réelles. Par conséquent, l'icône de FK_ShipperRating_Shippers dans la vue Schéma affiche l'icône d'erreur (un cercle rouge qui contient un « x » blanc). De plus, une erreur s'affiche dans la fenêtre Liste d'erreurs pour indiquer que vous avez une définition d'objet de base de données non valide. Ce comportement est prévu. Dans l'Explorateur de solutions, le fichier qui contient la définition d'objet n'affiche pas d'icône d'erreur.

Dans l'éditeur T-SQL, modifiez la définition de la clé étrangère afin qu'elle corresponde à l'exemple suivant :

ALTER TABLE [dbo].[ShipperRating]
ADD CONSTRAINT [FK_ShipperRating_Shippers] 
FOREIGN KEY ([ShipperID])
REFERENCES [dbo].[Shippers] ([ShipperID])

Dans le menu Fichier, cliquez sur Enregistrer dbo.FK_ShipperRating_Shippers afin d'enregistrer les modifications apportées. L'icône d'erreur est remplacée par l'icône normale pour une contrainte de clé étrangère parce que la définition est à présent valide.

Dans la dernière étape, vous ajoutez un index à la table ShipperRating.

Pour ajouter un index à la table ShipperRating

Dans la vue Schéma, cliquez sur le dossier Index.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément. Vous pouvez également cliquer avec le bouton droit sur le dossier Index, pointer sur Ajouter, puis cliquer sur Index.
Dans la liste Modèles, cliquez sur Index s'il n'est pas déjà en surbrillance.

Dans la zone Nom, tapez ShipperRatingDate, puis cliquez sur Ajouter.

L'index ShipperRatingDate est ajouté à la table ShipperRating dans votre projet. L'éditeur T-SQL s'affiche afin que vous puissiez modifier la définition de l'index.

Remarque :
La définition par défaut de l'index référence colonne_1 au lieu d'un nom de colonne réel. Par conséquent, l'icône de ShipperRatingDate dans l'Explorateur de solutions affiche l'icône d'erreur (un cercle rouge qui contient un « x » blanc). De plus, une erreur s'affiche dans la fenêtre Liste d'erreurs pour indiquer que vous avez une définition d'objet de base de données non valide. Ce comportement est prévu.

La définition par défaut de l'index référence colonne_1 au lieu d'un nom de colonne réel. Par conséquent, l'icône de ShipperRatingDate dans l'Explorateur de solutions affiche l'icône d'erreur (un cercle rouge qui contient un « x » blanc). De plus, une erreur s'affiche dans la fenêtre Liste d'erreurs pour indiquer que vous avez une définition d'objet de base de données non valide. Ce comportement est prévu.

Dans l'éditeur T-SQL, modifiez la définition de l'index afin qu'elle corresponde à l'exemple suivant :
```
-- =============================================
-- Create index on RatingDate column in 
--the ShipperRating table.
-- =============================================
CREATE INDEX [ShipperRatingDate]
ON [dbo].[ShipperRating]
(RatingDate)
```
Dans le menu Fichier, cliquez sur Enregistrer ShipperRatingDate afin d'enregistrer les modifications apportées. L'icône d'erreur est remplacée par l'icône normale pour un index car la définition est à présent valide.

Pour archiver les modifications apportées dans le contrôle de version

Dans l'Explorateur de solutions, cliquez sur la base de données MyNorthwind.
Dans le menu Fichier, pointez sur Contrôle de code source, puis cliquez sur Archiver.
Archivez vos fichiers en suivant les procédures applicables à votre plug-in de contrôle de code source. Pour plus d'informations, consultez Utilisation du contrôle de version Team Foundation.

Les modifications de projet de base de données ont maintenant été archivées et sont à présent disponibles pour d'autres membres de l'équipe.

Étapes suivantes

Après avoir modifié la représentation hors connexion de cette base de données, vous devez générer et déployer ces modifications chez le serveur de base de données. Pour générer et déployer les modifications apportées, consultez Procédure pas à pas : déploiement de modifications vers une base de données sous contrôle de version existante.

Voir aussi

Partager via