Relier deux tables
Un film a un genre, une séance a une salle : les relations entre tables.
Après cette fiche, vous saurez :
- expliquer ce qu'est une clé étrangère
- écrire une relation avec une propriété de navigation
- utiliser [ForeignKey] pour éviter une colonne en trop
- relire les relations dans pgAdmin
1Le problème
Dans le cinéma, un film appartient à un genre, une séance projette un film dans une salle, un ticket est pour une séance. Nos cinq tables sont pour l'instant des îles séparées.
Dans le cours de bases de données, vous avez vu la solution : la clé étrangère.
Une table garde, dans une colonne, l'identifiant de la ligne d'une autre table. Par exemple,
la table Films garde l'IdGenre du genre du film.
Une règle à retenir : la clé étrangère est toujours du côté du « plusieurs ».
Un genre a plusieurs films : c'est donc Film qui contient IdGenre.
2Écrire une relation en C#
Dans la classe Film, on ajoute deux propriétés :
[ForeignKey(nameof(Genre))] public int IdGenre { get; set; } public Genre? Genre { get; set; }
| Propriété | Rôle |
|---|---|
int IdGenre | La clé étrangère : un simple nombre, qui sera une colonne de la table Films. |
Genre? Genre | La propriété de navigation : elle permet, dans le code, d'aller de film vers son genre (film.Genre.Libelle). Ce n'est pas une colonne. |
[ForeignKey(nameof(Genre))] | Une annotation qui dit à Entity Framework : « ce nombre est la clé étrangère de la propriété Genre ». |
Il faut un nouveau using en haut du fichier :
using System.ComponentModel.DataAnnotations.Schema;
Attention
Sans [ForeignKey], Entity Framework crée une colonne en trop.
Il cherche une clé étrangère qui s'appelle GenreIdGenre (le nom de la
navigation suivi du nom de la clé). Il ne reconnaît pas IdGenre, et il
invente une deuxième colonne :
CREATE TABLE "Films" ( ... "IdGenre" integer NOT NULL, "GenreIdGenre" integer NOT NULL, -- la colonne en trop CONSTRAINT "FK_Films_Genres_GenreIdGenre" FOREIGN KEY ("GenreIdGenre") ... );
Avec [ForeignKey(nameof(Genre))], il n'y a plus qu'une colonne, la
bonne.
3Les trois autres relations
On répète le même schéma pour les autres liens. Voici les classes modifiées.
public class Seance { // ... propriétés de la fiche 7 ... [ForeignKey(nameof(Film))] public int IdFilm { get; set; } public Film? Film { get; set; } [ForeignKey(nameof(Salle))] public int IdSalle { get; set; } public Salle? Salle { get; set; } }
public class Ticket { // ... propriétés de la fiche 7 ... [ForeignKey(nameof(Seance))] public int IdSeance { get; set; } public Seance? Seance { get; set; } }
Une séance a deux relations (un film et une salle), donc deux paires de
propriétés. Le AppDbContext ne change pas.
4Le SQL que produit Entity Framework
Voici la table Tickets, avec la clé étrangère :
CREATE TABLE "Tickets" ( "IdTicket" integer GENERATED BY DEFAULT AS IDENTITY, "NumTicket" character varying(20) NOT NULL, ... "IdSeance" integer NOT NULL, CONSTRAINT "PK_Tickets" PRIMARY KEY ("IdTicket"), CONSTRAINT "FK_Tickets_Seances_IdSeance" FOREIGN KEY ("IdSeance") REFERENCES "Seances" ("IdSeance") ON DELETE CASCADE ); CREATE INDEX "IX_Tickets_IdSeance" ON "Tickets" ("IdSeance");
Trois choses à remarquer :
FOREIGN KEY ... REFERENCES: c'est la clé étrangère, comme dans le cours de bases de données.NOT NULL: un ticket doit avoir une séance. C'est le typeintdeIdSeancequi décide, comme à la fiche 4.ON DELETE CASCADE: si on supprime une séance, tous ses tickets sont supprimés avec elle. C'est le comportement par défaut d'une relation obligatoire.
Entity Framework a aussi créé un index sur la clé étrangère, pour retrouver vite les tickets d'une séance. Vous n'avez rien eu à demander.
5Recréer la base
Vos tables existent déjà sans clés étrangères. Comme EnsureCreated() ne met
rien à jour (fiche 7), on supprime et on recrée :
db.Database.EnsureDeleted(); db.Database.EnsureCreated();
Ensuite, dans pgAdmin, ouvrez la table Tickets puis le dossier
Constraints : vous y trouvez FK_Tickets_Seances_IdSeance. La colonne
IdSeance apparaît dans la liste des colonnes, avec NOT NULL.
À retenir
Pour relier deux tables, on écrit dans la classe du côté « plusieurs » :
- une clé étrangère :
public int IdGenre; - une propriété de navigation :
public Genre? Genre; [ForeignKey(nameof(Genre))]au-dessus de la clé étrangère.
Puis on recrée la base avec EnsureDeleted() et EnsureCreated().
Bravo : vous savez maintenant fabriquer une base PostgreSQL complète, avec ses relations, sans avoir écrit une ligne de SQL.
→Exercices
Dans votre projet, ajoutez à la classe Film la clé étrangère et la
propriété de navigation vers Genre, avec l'annotation. Recréez la base et
regardez, dans pgAdmin, les colonnes de Films.
Solution
La classe Film reçoit :
[ForeignKey(nameof(Genre))] public int IdGenre { get; set; } public Genre? Genre { get; set; }
N'oubliez pas using System.ComponentModel.DataAnnotations.Schema;. Dans
pgAdmin, la table Films a maintenant une colonne IdGenre
(une seule !) et une contrainte FK_Films_Genres_IdGenre.
Pour chaque phrase, dites dans quelle classe se place la clé étrangère :
- Une salle accueille plusieurs séances.
- Un film a plusieurs séances.
- Un ticket concerne une seule séance, et une séance a plusieurs tickets.
Solution
- Dans
Seance(IdSalle) : la séance est du côté « plusieurs ». - Dans
Seance(IdFilm). - Dans
Ticket(IdSeance) : le ticket est du côté « plusieurs ».
Règle : on regarde laquelle des deux tables a « plusieurs » lignes pour une seule ligne de l'autre. La clé étrangère va dans celle-là.
Dans le club de sport, un Cours se donne dans une salle de sport.
- Écrivez la classe
SalleSport(un identifiant, un nom). - Ajoutez à
Coursla relation versSalleSport. - Dans quelle table se trouve la clé étrangère ?
Solution
public class SalleSport { [Key] public int IdSalleSport { get; set; } [MaxLength(30)] public required string Nom { get; set; } }
public class Cours { // ... autres propriétés ... [ForeignKey(nameof(SalleSport))] public int IdSalleSport { get; set; } public SalleSport? SalleSport { get; set; } }
3. Dans la table Cours : plusieurs cours peuvent avoir lieu dans
la même salle, donc Cours est du côté « plusieurs ». N'oubliez pas
d'ajouter DbSet<SalleSport> au DbContext, puis de recréer
la base.
Je sais faire
- Je sais qu'une clé étrangère se place du côté du « plusieurs ».
- Je sais écrire un IdGenre accompagné de sa propriété Genre.
- Je sais utiliser [ForeignKey(nameof(...))].
- Je sais retrouver mes clés étrangères dans pgAdmin.
Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.