⌂ Entity Framework
Fiche 8 sur 8

Relier deux tables

Un film a un genre, une séance a une salle : les relations entre tables.

Après cette fiche, vous saurez :

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.

Genre IdGenre Libelle Film IdFilm IdGenre (FK) Seance IdSeance IdFilm (FK) IdSalle (FK) Salle IdSalle Capacite Ticket IdTicket IdSeance (FK) 1N 1N 1N 1N FK = clé étrangère Elle est toujours dans la table du côté « N » (le « plusieurs »). 1 genre → N films

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 IdGenreLa clé étrangère : un simple nombre, qui sera une colonne de la table Films.
Genre? GenreLa 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 :

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 » :

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

1Relier les films aux genresRecopier

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.

2Où va la clé étrangère ?Modifier

Pour chaque phrase, dites dans quelle classe se place la clé étrangère :

  1. Une salle accueille plusieurs séances.
  2. Un film a plusieurs séances.
  3. Un ticket concerne une seule séance, et une séance a plusieurs tickets.

Solution

  1. Dans Seance (IdSalle) : la séance est du côté « plusieurs ».
  2. Dans Seance (IdFilm).
  3. 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à.

3Une relation pour le club de sportCréer

Dans le club de sport, un Cours se donne dans une salle de sport.

  1. Écrivez la classe SalleSport (un identifiant, un nom).
  2. Ajoutez à Cours la relation vers SalleSport.
  3. 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

Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.

← Fiche 7