...
Eroare ASP.NET Core · Entity Framework Core

System.InvalidOperationException: Relational-specific methods can only be used when the context is using a relational database provider.

Pe scurt

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

Greșit
C#
db.Database.Migrate();
Corect
C#
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

Greșit
C#
db.Database.ExecuteSqlRaw("UPDATE Produse SET Stoc = 0");
Corect
C#
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

Greșit
C#
o.UseInMemoryDatabase("teste");
Corect
C#
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ă tu

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.

Codul care dă eroarea
C#
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ă" });
    }
}
După reparație, programul afișează
GET /materii → 200 OK
["Matematică","Informatică"]
Indiciu

Pentru providerul InMemory, schema și datele din HasData se creează cu o altă metodă a lui Database.

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 și Migrate pe aceeași bază reală: EnsureCreated nu 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

← Toate erorile ASP.NET Core

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.