Créer la base avec EnsureCreated
Une seule ligne de C#, et PostgreSQL contient la base et ses tables.
Après cette fiche, vous saurez :
- écrire le programme complet qui crée la base
- expliquer ce que fait EnsureCreated() et ce qu'il ne fait pas
- vérifier le résultat dans pgAdmin
- repartir de zéro avec EnsureDeleted()
1Le modèle complet, sans relations
Avant de créer la base, rassemblons les cinq classes du cinéma. Les relations entre elles viendront à la fiche suivante : pour l'instant, chaque table est seule.
Rangez-les dans le dossier Model, une classe par fichier.
using System.ComponentModel.DataAnnotations; using Microsoft.EntityFrameworkCore; namespace Demo_Cinema.Model { [Index(nameof(Libelle), IsUnique = true)] public class Genre { [Key] public int IdGenre { get; set; } [Required] [MaxLength(30)] public required string Libelle { get; set; } } }
using System.ComponentModel.DataAnnotations; using Microsoft.EntityFrameworkCore; namespace Demo_Cinema.Model { [Index(nameof(NumeroSalle), IsUnique = true)] public class Salle { [Key] public int IdSalle { get; set; } public int NumeroSalle { get; set; } public int Capacite { get; set; } public bool Est3d { get; set; } } }
using System.ComponentModel.DataAnnotations; namespace Demo_Cinema.Model { public class Film { [Key] public int IdFilm { get; set; } [Required] [MaxLength(60)] public required string Titre { get; set; } [MaxLength(40)] public required string Realisateur { get; set; } public int Annee { get; set; } public int DureeMinutes { get; set; } public string? Synopsis { get; set; } } }
using System.ComponentModel.DataAnnotations; namespace Demo_Cinema.Model { public class Seance { [Key] public int IdSeance { get; set; } public DateOnly DateSeance { get; set; } public int HeureSeance { get; set; } public int MinuteSeance { get; set; } public double PrixBase { get; set; } public string? Remarques { get; set; } } }
using System.ComponentModel.DataAnnotations; using Microsoft.EntityFrameworkCore; namespace Demo_Cinema.Model { [Index(nameof(NumTicket), IsUnique = true)] public class Ticket { [Key] public int IdTicket { get; set; } [Required] [MaxLength(20)] public required string NumTicket { get; set; } public int NumeroPlace { get; set; } public required string Tarif { get; set; } public double PrixPaye { get; set; } public DateOnly DateAchat { get; set; } public bool EstUtilise { get; set; } } }
Et le AppDbContext de la fiche 6, avec ses cinq DbSet, dans le
dossier Context.
2Le programme complet
Voici le fichier Program.cs :
using Demo_Cinema.Context; using Microsoft.EntityFrameworkCore; var options = new DbContextOptionsBuilder<AppDbContext>() .UseNpgsql("Host=localhost;Database=db_cinema;Username=postgres;Password=VotreMotDePasse") .Options; using var db = new AppDbContext(options); bool creee = db.Database.EnsureCreated(); Console.WriteLine(creee ? "La base vient d'être créée." : "La base existait déjà : rien n'a été fait.");
La ligne qui fait tout le travail est db.Database.EnsureCreated(). Son nom
veut dire « assure-toi que la base est créée ». Elle renvoie true
si elle vient de créer quelque chose, et false si la base était déjà là.
Lancez le programme avec dotnet run (ou le bouton ▶ de Visual Studio) :
La base vient d'être créée.
La base existait déjà : rien n'a été fait.
Au deuxième lancement, rien ne s'est passé : c'est normal, et utile, comme nous allons le voir.
3Ce que fait EnsureCreated, et ce qu'il ne fait pas
Selon ce qu'il trouve dans PostgreSQL, il agit ainsi :
| Situation | Ce qu'il fait |
|---|---|
| La base n'existe pas | Crée la base et toutes les tables. |
| La base existe mais n'a aucune table | Crée les tables. |
| La base a déjà des tables | Ne fait rien, même si vos classes ont changé depuis. |
Attention
EnsureCreated() ne met jamais une table à jour.
Si vous ajoutez une propriété à Film après avoir créé la base, la table
Films ne reçoit pas la nouvelle colonne. Entity Framework ne compare pas vos
classes avec les tables : il constate que des tables existent, et s'arrête.
Il existe un outil pour faire évoluer une base sans la perdre, les migrations. Nous ne les utilisons pas dans ce cours.
4Vérifier dans pgAdmin
- Ouvrir pgAdmin Connectez-vous au serveur avec votre mot de passe.
- Actualiser la liste
Clic droit sur Databases, puis Refresh. La base
db_cinemaapparaît. - Descendre jusqu'aux tables Dépliez db_cinema, puis Schemas, public, Tables.
Servers > PostgreSQL 18 > Databases > db_cinema > Schemas > public > Tables
Vous devez y voir vos cinq tables : Films, Genres,
Salles, Seances et Tickets.
Pour regarder le contenu d'une table (vide pour l'instant), clic droit sur elle puis View/Edit Data, All Rows. Vous pouvez aussi écrire une requête dans le Query Tool :
SELECT * FROM "Films";Attention
Les guillemets sont obligatoires.
Dans le cours de bases de données, nous avions pris l'habitude de noms en minuscules.
Entity Framework, lui, crée des noms avec des majuscules (Films,
IdFilm), et PostgreSQL exige alors des guillemets doubles autour du nom.
Sans eux : SELECT * FROM Films donne une erreur.
5Voir le SQL sans créer la base
Curieux de savoir ce qu'Entity Framework va envoyer à PostgreSQL ? Cette ligne affiche le SQL sans toucher à la base :
Console.WriteLine(db.Database.GenerateCreateScript());CREATE TABLE "Films" (
"IdFilm" integer GENERATED BY DEFAULT AS IDENTITY,
"Titre" character varying(60) NOT NULL,
"Realisateur" character varying(40) NOT NULL,
"Annee" integer NOT NULL,
"DureeMinutes" integer NOT NULL,
"Synopsis" text,
CONSTRAINT "PK_Films" PRIMARY KEY ("IdFilm")
);
CREATE TABLE "Genres" (
"IdGenre" integer GENERATED BY DEFAULT AS IDENTITY,
"Libelle" character varying(30) NOT NULL,
CONSTRAINT "PK_Genres" PRIMARY KEY ("IdGenre")
);
...C'est le même SQL que vous auriez écrit à la main dans le cours de bases de données. C'est aussi un excellent moyen de vérifier une annotation avant de créer la base.
6Repartir de zéro
Vous avez changé une classe ? Puisque EnsureCreated() ne met rien à
jour, il faut supprimer la base puis la recréer.
db.Database.EnsureDeleted(); // supprime la base ET toutes ses données db.Database.EnsureCreated(); // la recrée à partir des classes actuelles
Attention
EnsureDeleted() efface tout, sans demander.
Toutes les données de la base disparaissent. C'est acceptable pendant l'apprentissage, tant que la base ne contient que des données d'essai. Ne l'utilisez jamais sur une base qui contient de vraies données.
Si PostgreSQL refuse de supprimer la base parce qu'elle est utilisée, fermez la connexion de pgAdmin à cette base (clic droit sur la base, Disconnect Database) et recommencez.
Vous pouvez aussi simplement supprimer la base dans pgAdmin (clic droit sur
db_cinema, Delete) puis relancer le programme.
7Quand ça ne marche pas
| Début du message | Cause probable |
|---|---|
password authentication failed for user "postgres" | Mot de passe incorrect dans la chaîne de connexion. |
Failed to connect to ...:5432 | PostgreSQL n'est pas démarré, ou le port n'est pas 5432. |
requires a primary key to be defined | Il manque un [Key] sur une classe (fiche 5). |
Dans les trois cas, lisez la première ligne du message : elle donne presque toujours la cause.
À retenir
db.Database.EnsureCreated() crée la base et ses tables si elles n'existent pas.
Il ne modifie jamais une table existante. Pour reprendre de zéro :
EnsureDeleted() puis EnsureCreated() (toutes les données sont perdues).
→Exercices
Recopiez les cinq classes et le Program.cs de cette fiche, avec votre
mot de passe PostgreSQL. Lancez le programme deux fois de suite.
- Qu'affiche-t-il à chaque lancement ?
- Dans pgAdmin, combien de tables voyez-vous dans
public→Tables?
Solution
- Au premier :
La base vient d'être créée.Au deuxième :La base existait déjà : rien n'a été fait. - 5 tables : Films, Genres, Salles, Seances et Tickets. Si la liste est vide, faites un clic droit sur Tables puis Refresh.
- Dans la classe
Film, ajoutez la propriétépublic string? Langue { get; set; }. - Relancez le programme. Regardez la table
Filmsdans pgAdmin. La colonneLangueest-elle là ? - Faites-la apparaître.
Solution
2. Non. Le programme affiche « La base existait déjà » : des tables
existaient, donc EnsureCreated() n'a rien changé.
3. Il faut supprimer la base puis la recréer :
db.Database.EnsureDeleted();
bool creee = db.Database.EnsureCreated();Relancez, puis actualisez pgAdmin : la colonne Langue existe, et elle
accepte le NULL à cause du ?. N'oubliez pas de retirer la ligne
EnsureDeleted() ensuite, sinon la base est effacée à chaque lancement.
Avec les classes Membre et Cours de la fiche 1 :
- Ajoutez les annotations nécessaires (clé, texte obligatoire, longueur).
- Écrivez le
Program.csqui crée la basedb_club. - Vérifiez les deux tables dans pgAdmin.
Solution
Il n'y a pas une seule solution. Les éléments indispensables :
- un
[Key]sur chaque identifiant ; - un
DbSetpar classe dans leClubDbContext; - une chaîne de connexion avec
Database=db_club; - l'appel
db.Database.EnsureCreated().
Dans pgAdmin, vous devez voir Membres et Cours.
Je sais faire
- Je sais lancer EnsureCreated() et lire son résultat.
- Je sais retrouver mes tables dans pgAdmin.
- Je sais qu'EnsureCreated() ne modifie pas une table qui existe déjà.
- Je sais supprimer et recréer la base quand j'ai changé mes classes.
Une case qui coince ? Relisez la partie concernée avant de passer à la fiche suivante.