System.InvalidOperationException: Relational-specific methods can only be used when the context is using a relational database provider.
Ai apelat o metodă care există doar pentru baze relaționale (Migrate, ExecuteSqlRaw, GetDbConnection, FromSql...) pe un context configurat cu UseInMemoryDatabase. Pe InMemory folosește EnsureCreated și LINQ, sau testează cu SQLite în memorie.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Unele metode ale EF Core au sens doar când în spate e o bază de date SQL: aplicarea migrărilor (Database.Migrate()), comenzi SQL brute (ExecuteSqlRaw, FromSqlRaw), accesul la conexiune (GetDbConnection()), tranzacții pe conexiune, GetMigrations(). Ele sunt metode de extensie din pachetul relațional și verifică la rulare ce provider folosește contextul.
Providerul InMemory nu e relațional: nu are tabele, SQL sau migrări, doar colecții în memorie. Când una dintre aceste metode rulează pe el, primești exact acest mesaj.
Situația tipică: aplicația apelează Migrate() la pornire (corect în producție, cu SQL Server sau PostgreSQL), iar în teste sau în mediul de dezvoltare contextul e înlocuit cu UseInMemoryDatabase. Codul de pornire trebuie să țină cont de provider, de exemplu cu db.Database.IsRelational().
De ce apare: cauzele frecvente
1Migrate pe InMemory
db.Database.Migrate();if (db.Database.IsRelational())
db.Database.Migrate();
else
db.Database.EnsureCreated();EnsureCreated creează schema (și aplică HasData) pe orice provider; Migrate doar pe cele relaționale.
2SQL brut în cod testat cu InMemory
db.Database.ExecuteSqlRaw("UPDATE Produse SET Stoc = 0");db.Produse.ExecuteUpdate(s => s.SetProperty(p => p.Stoc, 0));Operațiile LINQ sunt independente de provider; SQL-ul brut leagă codul de o bază relațională.
3Teste care au nevoie de comportament relațional
o.UseInMemoryDatabase("teste");var con = new SqliteConnection("Data Source=:memory:");
con.Open();
o.UseSqlite(con);SQLite în memorie e relațional: suportă migrări, SQL, tranzacții și constrângeri, și rămâne rapid pentru teste.
Repară eroarea, direct în pagină
Aplicația nu pornește: Relational-specific methods can only be used when the context is using a relational database provider. Contextul folosește baza în memorie; înlocuiește apelul de la pornire cu cel potrivit pentru acest provider, ca GET /materii să întoarcă materiile din HasData.
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Catalog>(o => o.UseInMemoryDatabase("catalog"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<Catalog>();
db.Database.Migrate();
}
app.MapGet("/materii", (Catalog db) => db.Materii.OrderBy(m => m.Id).Select(m => m.Nume).ToList());
app.Run();
public class Materie
{
public int Id { get; set; }
public string Nume { get; set; } = "";
}
public class Catalog(DbContextOptions<Catalog> options) : DbContext(options)
{
public DbSet<Materie> Materii => Set<Materie>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Materie>().HasData(
new Materie { Id = 1, Nume = "Matematică" },
new Materie { Id = 2, Nume = "Informatică" });
}
}GET /materii → 200 OK ["Matematică","Informatică"]
Indiciu
Pentru providerul InMemory, schema și datele din HasData se creează cu o altă metodă a lui Database.
Reparația
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Catalog>(o => o.UseInMemoryDatabase("catalog"));
var app = builder.Build();
using (var scope = app.Services.CreateScope())
{
var db = scope.ServiceProvider.GetRequiredService<Catalog>();
db.Database.EnsureCreated();
}
app.MapGet("/materii", (Catalog db) => db.Materii.OrderBy(m => m.Id).Select(m => m.Nume).ToList());
app.Run();
public class Materie
{
public int Id { get; set; }
public string Nume { get; set; } = "";
}
public class Catalog(DbContextOptions<Catalog> options) : DbContext(options)
{
public DbSet<Materie> Materii => Set<Materie>();
protected override void OnModelCreating(ModelBuilder m)
{
m.Entity<Materie>().HasData(
new Materie { Id = 1, Nume = "Matematică" },
new Materie { Id = 2, Nume = "Informatică" });
}
}De ce merge
Migrate() aplică migrările SQL și există doar pentru baze relaționale; pe InMemory aruncă excepția la pornire. EnsureCreated() creează structura pentru orice provider și inserează datele declarate cu HasData, deci endpoint-ul găsește cele două materii. Într-o aplicație cu SQL Server ai păstra Migrate() și ai folosi EnsureCreated() doar în teste.
Cum o eviți pe viitor
- Apelează metodele relaționale doar când
db.Database.IsRelational()e adevărat. - Pentru teste care ating SQL, migrări sau constrângeri, folosește SQLite în memorie sau un container cu baza reală.
- Nu amesteca
EnsureCreatedșiMigratepe aceeași bază reală:EnsureCreatednu creează istoricul migrărilor.
Întrebări frecvente
De ce să nu folosesc EnsureCreated și în producție?
EnsureCreated creează schema o singură dată și nu știe să o actualizeze. Migrările păstrează istoricul schimbărilor și le aplică incremental, fără să piardă date.
Microsoft recomandă providerul InMemory pentru teste?
Documentația EF Core îl descurajează pentru testarea codului de acces la date, tocmai pentru că nu se comportă ca o bază relațională. E acceptabil pentru teste simple de logică.
Erori înrudite
System.InvalidOperationException: Warning as error exception for warning 'Microsoft.EntityFrameworkCore.Database.Transaction.TransactionIgnoredWarning': Transactions are not supported by the in-memory store. See https://go.microsoft.com/fwlink/?LinkId=800142 This exception can be suppressed or logged by passing event ID 'InMemoryEventId.TransactionIgnoredWarning' to the 'ConfigureWarnings' method in 'DbContext.OnConfiguring' or 'AddDbContext'. Ai pornit o tranzacție (BeginTransaction) pe providerul InMemory, care nu are tranzacții. Pentru o singură salvare nu-ți trebuie: SaveChanges e deja atomic. Dacă tranzacția e necesară, testează cu SQLite sau ignoră avertismentul cu ConfigureWarnings, conștient că nu există rollback. System.InvalidOperationException: The seed entity for entity type 'Carte' cannot be added because a non-zero value is required for property 'Id'. Consider providing a negative value to avoid collisions with non-seed data. Datele din HasData trebuie să aibă cheia primară setată explicit, chiar dacă în rest baza o generează automat. Dă fiecărui obiect din HasData un Id fix (1, 2, 3...), ca migrările să poată recunoaște rândurile între versiuni. Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție
Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
