Software Engineer Encyclopedia
0%
Domain 04 · Database Engineering & Data Management · Topic 4.3

Entity Framework Core من الـ DbContext لحد الأداء والتزامن

Entity Framework Core — Deep Practical Guide

مرجع EF Core متكامل: DbContext lifetime، mapping، relationships، tracking، LINQ translation، loading، transactions، migrations، concurrency، performance والاختبارات.

  • Intermediate
  • ~21 min read
  • 16 sections
  • 30 code examples
  • 1 diagrams
  • 5 questions
  • Priority L1 · Essential
  • EF Core 10 · .NET 10 · C# 14

المتطلبات قبل ما تبدأ

C# وأساسيات ASP.NET Core. معرفة سابقة بـ SQL مفيدة لكن مش شرط.

مستوى التعمق المطلوب

DEEPTracking, relationships, query translation, loading strategies, transactions, and concurrency.

01

EF Core بيعمل إيه فعلًا؟

ORM, mapping and unit-of-work behavior
Deep dive

EF Core هو ORM بيربط C#‎ objects بجداول relational database. هو مش مجرد بديل لكتابة SQL؛ هو كمان بيحتفظ بـ model metadata، يترجم LINQ إلى SQL، يتابع تغييرات entities، وينسق SaveChanges داخل transaction عند الحاجة. افهم SQL اللي بيتولد؛ abstraction لا تعني اختفاء قاعدة البيانات.

LINQ expressionIQueryableEF translatorprovider + modelSQL commandparametersDatabaserows → objects
مسار LINQ query من كود C#‎ لحد database rows

DbContext يمثل Session قصيرة مع قاعدة البيانات وبيحتوي DbSet<T> كنقطة استعلام/إضافة للـ entity type. الـ Context مش thread-safe؛ ما تستخدمش نفس instance في عمليتين متوازيتين، وما تحتفظش بيه كـ Singleton.

02

DbContext و DbSet و Dependency Injection

Lifetime and ownership
Deep dive

في ASP.NET Core، التسجيل المعتاد AddDbContext بيكون Scoped: instance لكل request scope. ده مناسب لو request واحدة بتنفذ use case واحدة. Background worker لازم ينشئ scope أو يستخدم IDbContextFactory بدل الاحتفاظ بـ scoped context طول عمر الـ worker.

C#Program.cs
var connectionString = builder.Configuration
    .GetConnectionString("DefaultConnection")!;

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(connectionString));

// For parallel/background operations, consider a factory:
builder.Services.AddDbContextFactory<AppDbContext>(options =>
    options.UseSqlServer(connectionString));
C#DbContext.cs
public sealed class AppDbContext(DbContextOptions<AppDbContext> options)
    : DbContext(options)
{
    public DbSet<Product> Products => Set<Product>();
    public DbSet<Category> Categories => Set<Category>();
    public DbSet<Order> Orders => Set<Order>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(
            typeof(AppDbContext).Assembly);
    }
}

DbSet property مش لازم تكون auto-property؛ Set<T>() بيرجع set من الـ Context. متعملش new AppDbContext() داخل repository؛ خلي DI يدير lifetime. وماتعملش dispose للـ Context المحقون في service؛ الـ container مسؤول عن disposal.

03

Entity Configuration: Data Annotations ولا Fluent API؟

Model metadata and schema mapping
Deep dive

Data Annotations بسيطة وقريبة من الـ entity: [Required] و [MaxLength] و [Key]. Fluent API في OnModelCreating أو IEntityTypeConfiguration<T> أقوى، وبتفصل persistence mapping عن Domain model. خلي القواعد المعقدة والعلاقات والـ indexes في configuration classes.

C#ProductConfiguration.cs
public sealed class ProductConfiguration
    : IEntityTypeConfiguration<Product>
{
    public void Configure(EntityTypeBuilder<Product> builder)
    {
        builder.ToTable("Products");
        builder.HasKey(x => x.Id);
        builder.Property(x => x.Name)
            .HasMaxLength(160)
            .IsRequired();
        builder.Property(x => x.Price)
            .HasPrecision(12, 2);
        builder.HasIndex(x => x.Sku).IsUnique();
        builder.Property(x => x.RowVersion).IsRowVersion();
    }
}

EF conventions تقدر تستنتج حاجات كتير من naming، لكن ما تعتمدش على convention في قرار حساس زي delete behavior أو decimal precision. راجع migration الناتجة قبل تطبيقها على production.

Value converters تحول قيمة CLR لتخزين مختلف (مثل enum إلى string)، Owned types تمثل value object مرتبطًا بمالك، و keyless entity types مناسبة لنتائج views أو SQL queries غير القابلة للتحديث. Inheritance mapping له TPH (جدول واحد مع discriminator)، TPT (جدول لكل نوع)، و TPC (جدول لكل concrete type) ولكل اختيار trade-offs في joins والتكرار والقيود.

C#Enum conversion and owned value object
modelBuilder.Entity<Order>()
    .Property(x => x.Status)
    .HasConversion<string>()
    .HasMaxLength(30);

modelBuilder.Entity<Customer>().OwnsOne(x => x.Address, address =>
{
    address.Property(x => x.City).HasMaxLength(100);
    address.Property(x => x.PostalCode).HasMaxLength(20);
});
04

Relationships و Delete Behaviors

One-to-one, one-to-many and many-to-many
Deep dive

العلاقة one-to-many غالبًا FK في dependent table. EF ممكن يكتشف العلاقة بالـ navigation و FK convention، لكن explicit configuration تخلي التصميم أوضح. اختار delete behavior حسب business meaning: Cascade قد يكون منطقيًا لصفوف owned detail، لكن حذف Customer لا ينبغي تلقائيًا حذف Orders تاريخية في كثير من الأنظمة.

C#One-to-many configuration
modelBuilder.Entity<Order>(builder =>
{
    builder.HasOne(x => x.Customer)
        .WithMany(x => x.Orders)
        .HasForeignKey(x => x.CustomerId)
        .OnDelete(DeleteBehavior.Restrict);
});

modelBuilder.Entity<OrderItem>(builder =>
{
    builder.HasOne(x => x.Order)
        .WithMany(x => x.Items)
        .HasForeignKey(x => x.OrderId)
        .OnDelete(DeleteBehavior.Cascade);
});

Navigation property بتسمح بالتنقل في object graph، لكنها مش دليل إن البيانات اتحملت من DB. Collection navigation ممكن تكون فاضية لأن مفيش rows أو لأنها لم تُحمّل. لا تخلط بين null navigation وغياب العلاقة في database.

05

Change Tracking و AsNoTracking

Entity states and identity resolution
Deep dive

Change Tracker بيراقب entities اللي جابها Context أو أضفتها له. الحالات الأساسية: Added و Unchanged و Modified و Deleted و Detached. عند SaveChanges، EF يقارن snapshot أو يستخدم notifications حسب configuration، ويولد أوامر SQL المناسبة.

C#Tracked update
var product = await db.Products
    .SingleAsync(x => x.Id == id, cancellationToken);

product.Price = 199.50m;
// EF detects the changed property and persists it.
await db.SaveChangesAsync(cancellationToken);

للقراءة فقط استخدم AsNoTracking() لتقليل tracking overhead. لو محتاج entities بدون tracking لكن نفس المفتاح يرجع نفس object reference داخل النتيجة، استخدم AsNoTrackingWithIdentityResolution() عند الحاجة. لا تستخدم no-tracking ثم تعدل entity وتتوقع SaveChanges يحفظها تلقائيًا.

C#Read-only projection
var products = await db.Products
    .AsNoTracking()
    .Where(x => x.IsActive)
    .Select(x => new ProductListItem(x.Id, x.Name, x.Price))
    .ToListAsync(cancellationToken);

Change Tracker: ماذا يحدث عند SaveChanges؟

لو جبت Product بـ tracking، EF يسجل original values والحالة Unchanged. لما تغير property، DetectChanges يلاحظ الفرق وتتحول الحالة إلى Modified. SaveChanges يولد UPDATE للأعمدة المتغيرة (حسب strategy) ويضيف PK و concurrency token إلى WHERE. بعد نجاح الحفظ يرجع entity غالبًا Unchanged وتُحدّث original values.

OperationStateTypical SQL
Add(entity)AddedINSERT
Query tracked + no editsUnchangedلا UPDATE
Modify tracked propertyModifiedUPDATE
Remove(tracked entity)DeletedDELETE
Attach(detached entity)Unchanged غالبًالا شيء حتى تغيير الحالة

احذر من Update(detachedGraph) على object graph كبير؛ قد يعلّم كيانات كثيرة Modified حتى لو لم تتغير، وقد يؤدي إلى كتابة قيم default أو null لو الـ DTO ناقص. الأفضل تحميل entity المطلوبة ثم تطبيق التغييرات المسموح بها، أو استخدام attach/entry state بدقة في سيناريوهات محسوبة.

Change Tracker: Entity States و Identity Resolution

كل tracked entity لها state: Detached، Unchanged، Added، Modified أو Deleted. EF Core يتتبع key identity داخل DbContext؛ لو حاولت attach instance ثانية بنفس key قد يظهر conflict لأن context لا يدير نسختين لنفس entity key. ده سبب شائع عند mapping DTO إلى entity جديدة ثم Attach بينما نفس entity محملة بالفعل.

Update(entity) غالبًا يضع graph في Modified state بشكل واسع، وقد يرسل updates لحقول لم تتغير. الأفضل load tracked entity ثم تعديل properties المسموحة، أو attach entity وتحديد properties Modified بدقة في disconnected scenarios. لا تقبل client DTO كاملًا وتعمل Update مباشرة؛ ده mass assignment risk وقد يسمح بتغيير fields غير مصرح بها.

C#Safe update of allowed fields
var product = await db.Products.SingleAsync(x => x.Id == id, ct);
product.ChangeDescription(request.Description);
product.ChangePrice(request.Price);
await db.SaveChangesAsync(ct);

في read-only query استخدم AsNoTracking أو projection. لو احتجت no tracking مع identity resolution استخدم AsNoTrackingWithIdentityResolution عند فائدة حقيقية. لا تستخدم DbContext نفسه في parallel tasks؛ DbContext غير thread-safe، واستخدم factory/contexts منفصلة للعمليات المتوازية.

06

SaveChanges و Migrations و Data Seeding

Persisting and evolving the schema
Deep dive

SaveChangesAsync بيجمع التغييرات المتتبعة ويرسل أوامرها، وغالبًا ينفذها داخل transaction واحدة لو provider يدعم ذلك. لو مفيش تغييرات، مش هيبعت update عشوائي لكل entity. لا تستدعِ SaveChanges بعد كل property؛ احفظ عند حد use case المناسب.

Migrations بتسجل تغييرات model في ملفات versioned. افحص migration وملف SQL الناتج قبل production. تجنب تشغيل Database.Migrate() من كل نسخة API عند startup في بيئة متعددة replicas؛ الأفضل deployment step مخصص أو migration bundle مع صلاحيات منفصلة.

BashEF Core CLI
dotnet ef migrations add AddProductSku \
  --project MyShop.Infrastructure \
  --startup-project Mini_Ecomerce_Project

dotnet ef migrations script --idempotent \
  --project MyShop.Infrastructure \
  --startup-project Mini_Ecomerce_Project

Seeding للبيانات الثابتة المرجعية ممكن يكون عبر HasData، لكن للبيانات المعتمدة على environment أو منطق إنشاء معقد استخدم initializer/deployment process. انتبه إن HasData يتطلب مفاتيح ثابتة ويولد insert/update/delete داخل migrations.

Migrations في CI/CD بدون مخاطرة Startup Race

في production، لا تجعل كل API replica تحاول تطبيق migrations عند startup. ممكن نسختان تبدأان معًا وتحاولان تعديل schema في نفس الوقت، أو التطبيق الجديد يبدأ قبل اكتمال migration، أو حساب تشغيل التطبيق يمتلك صلاحيات DDL أوسع من اللازم. الأفضل migration job منفصل بصلاحيات محددة، مع backup وخطة rollback/forward-fix.

استخدم expand-and-contract: أضف العمود الجديد nullable أو default آمن؛ انشر كودًا يقرأ/يكتب التمثيلين عند الحاجة؛ املأ البيانات تدريجيًا؛ انقل القراءة؛ ثم احذف القديم في release لاحق بعد التأكد من عدم وجود clients قديمة. ده مهم مع zero-downtime deployment.

Migrations و Seed Data و Production Deployment

Migration تمثل schema transition، وليست مجرد أمر محلي. راجع SQL الناتج قبل production؛ قد يولد migration عملية table rebuild أو lock طويل. لا تشغل Database.Migrate() من كل replica عند startup. استخدم migration bundle أو controlled job/step واحدة، ونسقها مع expand-contract compatibility. Seed data يجب أن تكون deterministic ومناسبة للبيئة؛ لا تضع production user passwords أو secrets في migration.

في فريق متعدد developers، migration branches قد تتعارض؛ اجمعها عبر merge migration وراجع model snapshot. لا تعدّل migration مطبقة في production؛ أنشئ migration جديدة. اختبر upgrade من schema واقعية و rollback/forward-fix strategy. Snapshot database في CI لا يغني عن provider integration tests.

07

LINQ Translation و Client vs Server Evaluation

IQueryable is not IEnumerable
Deep dive

قبل ToListAsync، أنت غالبًا بتبني expression tree على IQueryable، و EF يحاول يترجم التعبيرات إلى SQL. بعد materialization، LINQ to Objects يشتغل داخل الذاكرة. استدعاء AsEnumerable أو ToList بدري ممكن ينقل filtering/processing للعميل ويحمّل بيانات أكبر بكثير.

C#Keep filtering on the server
// Good: WHERE and SELECT are translated to SQL.
var result = await db.Products
    .Where(p => p.Price >= minimumPrice)
    .OrderBy(p => p.Name)
    .Select(p => new ProductListItem(p.Id, p.Name, p.Price))
    .ToListAsync(cancellationToken);

// Risky: materializes all rows before filtering.
var allProducts = await db.Products.ToListAsync(cancellationToken);
var filtered = allProducts.Where(p => CustomRule(p));

EF Core يسمح بترجمة client evaluation في top-level projection في حالات معينة، لكنه يرمي exception لو expression غير قابلة للترجمة داخل filter في إصدارات حديثة بدل سحب كل الصفوف بصمت. استخدم SQL logging لمعرفة الاستعلام الحقيقي.

تتبّع Query من LINQ إلى SQL

مثال مهم: لما تكتب var query = db.Products.Where(...) غالبًا لم يتم إرسال SQL بعد. أنت بتكوّن expression tree. التنفيذ الفعلي يحصل عند terminal operator مثل ToListAsync أو SingleAsync أو enumeration. لذلك تقدر تضيف Where و OrderBy و Select على مراحل قبل التنفيذ، لكن تنفيذ نفس IQueryable مرتين قد يرسل query مرتين.

C#Build first, execute once
IQueryable<Product> query = db.Products
    .Where(p => p.IsActive);

if (request.CategoryId is not null)
    query = query.Where(p => p.CategoryId == request.CategoryId);

query = query.OrderBy(p => p.Name)
    .Select(p => new Product(/* map only needed values */));

var rows = await query.ToListAsync(cancellationToken);

الـ projection في المثال التوضيحي يجب أن يكون expression قابلًا للترجمة. لو احتجت mapping function عادية لا يستطيع provider ترجمتها، نفّذ التحويل بعد اختيار الحقول المطلوبة فقط، وليس بعد تحميل كل entity graph.

لرؤية SQL استخدم logging في Development أو ToQueryString() على IQueryable. لا تفعّل sensitive data logging في production بلا دراسة؛ لأنه قد يسجل قيم parameters شخصية أو سرية.

C#Inspect generated SQL
var query = db.Products
    .Where(p => p.Price >= minimumPrice)
    .OrderBy(p => p.Name)
    .Select(p => new { p.Id, p.Name, p.Price });

var sql = query.ToQueryString();
// Inspect sql in a debugger or controlled diagnostic log.
08

Eager و Explicit و Lazy Loading ومشكلة N+1

Choose loading intentionally
Deep dive

Eager loading باستخدام Include يجلب navigation ضمن query. Explicit loading يحمّل navigation بطلب واضح بعد جلب entity. Lazy loading يحمّل عند الوصول للـ navigation (لو proxies/configuration متاحة)، وده ممكن يخفي round trips داخل loop.

C#Eager loading with projection
var orders = await db.Orders
    .AsNoTracking()
    .Where(o => o.Status == OrderStatus.Paid)
    .Select(o => new OrderSummary(
        o.Id,
        o.Customer.Name,
        o.Items.Sum(i => i.Quantity * i.UnitPrice)))
    .ToListAsync(cancellationToken);

N+1: query واحدة تجيب N orders، وبعدها كل access لـ Customer أو Items يطلق query إضافية. الحل مش Include دائمًا؛ projection غالبًا أفضل لقراءة API. استخدم Include لما تحتاج entity graph فعليًا للتعديل، وافحص عدد commands والـ SQL.

C#Explicit loading
var customer = await db.Customers
    .SingleAsync(x => x.Id == customerId, cancellationToken);

await db.Entry(customer)
    .Collection(x => x.Orders)
    .Query()
    .Where(o => o.CreatedAt >= fromDate)
    .LoadAsync(cancellationToken);

اختيار Loading Strategy حسب شكل الشاشة

اختيار loading strategy يبدأ من شكل use case، لا من قاعدة «Include دائمًا» أو «Lazy Loading ممنوع دائمًا». لو endpoint تحتاج Order + Items في نفس response، projection واحدة قد تكون أفضل. لو command يحتاج aggregate للتعديل، Include محدود قد يكون مناسبًا. Explicit loading مفيد عندما navigation مطلوبة بشرط runtime، لكن loop مع LoadAsync قد يتحول إلى N+1. Lazy loading يخفي database round trips داخل property access، وده يجعل performance غير واضح في review.

C#Projection avoids loading a full object graph
var rows = await db.Orders.AsNoTracking()
    .Where(o => o.CustomerId == customerId)
    .Select(o => new OrderDetailsDto(
        o.Id,
        o.Status,
        o.Items.Select(i => new OrderLineDto(
            i.ProductNameSnapshot, i.Quantity, i.UnitPrice)).ToList()))
    .ToListAsync(ct);

Projection لا تتطلب Include في أغلب الحالات لأن EF يترجم navigation usage داخل Select إلى joins/subqueries مناسبة. راجع SQL وحجم result. لو عندك عدة collection navigations، single query قد ينتج cartesian explosion. Split query يقلل row multiplication لكنه يزيد round trips وقد يرى snapshots مختلفة حسب transaction/isolation. قارن الحالتين على بيانات ممثلة.

C#Split query and explicit loading
var orders = await db.Orders
    .Include(o => o.Items)
    .Include(o => o.Payments)
    .AsSplitQuery()
    .ToListAsync(ct);

var order = await db.Orders.SingleAsync(o => o.Id == id, ct);
await db.Entry(order).Collection(o => o.Items).LoadAsync(ct);

لا تخلط AsSplitQuery مع حل سحري؛ لو endpoint ترجع آلاف orders وكلها collections، payload نفسها ضخمة. pagination/projection قد تكون الحل الصحيح.

09

Projection و Split Queries

Fetch only what the use case needs
Deep dive

Projection بـ Select ترجع الأعمدة المطلوبة فقط، وتمنع نقل graph كامل للـ API. Include متعدد مع collections ممكن يعمل Cartesian explosion بسبب JOINs؛ AsSplitQuery() يقسم التحميل لعدة SQL queries ويقلل تكرار بيانات principal، لكنه يزيد round trips وقد يقرأ بيانات مختلفة بين الاستعلامات لو مفيش transaction/isolation مناسب.

C#Split query trade-off
var customers = await db.Customers
    .Include(c => c.Orders)
    .ThenInclude(o => o.Items)
    .AsSplitQuery()
    .ToListAsync(cancellationToken);

استخدم AsSingleQuery لو query واحدة أنسب، و AsSplitQuery لو حجم join duplication كبير. قِس payload وعدد round trips ووقت التنفيذ؛ مش قاعدة عامة إن split أفضل.

اختيار Query Shape: Entity ولا DTO؟

قبل كتابة LINQ اسأل: هل use case محتاجة تعديل entity لاحقًا، أم قراءة شاشة فقط؟ في القراءة، projection إلى DTO يقلل الأعمدة والذاكرة ويمنع تحميل graph كامل بلا داعٍ. في الكتابة، tracked entity تجعل change detection و concurrency token يعملان بصورة طبيعية. AsNoTracking مفيد للقراءة، لكن لا تضفه آليًا لاستعلام ستعدل نتائجه ثم تتوقع SaveChanges أن يلتقط التغيير.

EF Core يترجم expression tree إلى SQL عبر provider. أي method C#‎ لا يستطيع provider ترجمتها قد تسبب exception داخل filter، أو client evaluation في projection بحسب موضع التعبير والإصدار. افحص SQL عبر ToQueryString() في التطوير، وراقب logs بدون تسجيل بيانات حساسة.

C#Practical engineering example
var page = await db.Products
    .AsNoTracking()
    .Where(p => p.IsActive && p.Stock > 0)
    .OrderBy(p => p.Name)
    .ThenBy(p => p.Id)
    .Select(p => new ProductListItem(
        p.Id, p.Name, p.Price, p.Category.Name))
    .Take(50)
    .ToListAsync(cancellationToken);

public sealed record ProductListItem(
    int Id, string Name, decimal Price, string CategoryName);

لاحظ أن projection يجلب الحقول المطلوبة فقط، وأن ترتيب ThenBy(Id) يجعل الترتيب deterministic. لو الـ query فيها navigation collection، فكر في join duplication أو split query حسب شكل النتيجة. لا تعتمد على Include لمجرد أن DTO يحتوي اسمًا من navigation؛ projection غالبًا أنسب.

10

Transactions و Optimistic Concurrency

Atomic updates and conflict handling
Deep dive

SaveChanges عادة transaction واحدة لتجميع أوامر الحفظ. لو use case فيها أكثر من SaveChanges أو EF مع ADO.NET command، ممكن تحتاج transaction صريحة. مع retrying execution strategy، لازم تنسق transaction مع strategy بالطريقة المدعومة من provider.

Optimistic concurrency بتفترض إن التعارض نادر: اقرأ row مع concurrency token، وعند update EF يضيف token القديم في WHERE. لو مفيش صف اتأثر، يرمي DbUpdateConcurrencyException. SQL Server rowversion token يتغير تلقائيًا مع كل update على الصف.

C#RowVersion entity and conflict handling
public sealed class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public byte[] RowVersion { get; set; } = [];
}

// Configuration: builder.Property(x => x.RowVersion).IsRowVersion();
try
{
    product.Name = request.Name;
    await db.SaveChangesAsync(cancellationToken);
}
catch (DbUpdateConcurrencyException)
{
    // Reload current values and ask the caller to resolve the conflict.
    throw new ConflictException("The product changed. Reload and retry.");
}

ما تعملش blind retry لنفس القيم؛ ده ممكن يكتب فوق تعديل مستخدم آخر. اعرض conflict أو ادمج القيم وفق business rule.

Transaction Boundaries و Execution Strategy

لو عندك عمليتان SaveChanges داخل transaction واحدة، استخدم transaction صريحة. لكن لو فعّلت provider retry strategy، بدء transaction يدويًا خارج execution strategy قد ينتج exception لأن strategy لا تستطيع إعادة تنفيذ الوحدة كاملة بشكل آمن. اجمع كل العملية داخل delegate strategy، وصممها لتكون قابلة لإعادة التنفيذ أو استخدم verification strategy عند الحاجة.

C#Explicit transaction with execution strategy
var strategy = db.Database.CreateExecutionStrategy();
await strategy.ExecuteAsync(async () =>
{
    await using var transaction = await db.Database
        .BeginTransactionAsync(cancellationToken);

    db.Orders.Add(order);
    await db.SaveChangesAsync(cancellationToken);

    db.OutboxMessages.Add(outboxMessage);
    await db.SaveChangesAsync(cancellationToken);

    await transaction.CommitAsync(cancellationToken);
});

المثال يوضح حدود المعاملة، لكن تكرار delegate بعد انقطاع اتصال يحتاج تصميمًا يمنع إنشاء order/outbox duplicate. ضع unique idempotency key أو business key مناسب، ولا تفترض إن فشل commit على العميل يعني إن DB لم تحفظ شيئًا.

Transactions و Connection Resiliency

SaveChanges غالبًا ينفذ changes في transaction واحدة عندما provider يدعم ذلك. لو use case فيها عدة SaveChanges أو queries/commands لازم تبقى atomic، استخدم explicit transaction. لكن لو enabled retrying execution strategy، manual transaction تحتاج أن تُنفذ داخل execution strategy delegate حتى يمكن إعادة الوحدة كاملة وفق provider guidance.

Retry بعد network failure قد يكون outcome ambiguous: ربما DB commit نجح لكن response ضاع. لا تعِد non-idempotent operation blindly. استخدم idempotency key/unique business constraint أو query عن outcome قبل retry. Connection resiliency لا تعني إن كل exception transient.

C#Execution strategy around an explicit transaction
var strategy = db.Database.CreateExecutionStrategy();
await strategy.ExecuteAsync(async () =>
{
    await using var tx = await db.Database.BeginTransactionAsync(ct);
    order.Confirm();
    await db.SaveChangesAsync(ct);
    await tx.CommitAsync(ct);
});

المثال توضيحي؛ لو delegate تعاد، نفس tracked context قد يحمل state متغيرًا. في عمليات حساسة، فكر في fresh DbContext per attempt أو idempotent transaction design وفق provider. لا تضع HTTP payment call داخل delegate لأن retry قد يكرر external side effect.

EF Core Concurrency و Transactions و Savepoints

Optimistic concurrency token مثل SQL Server rowversion يجعل UPDATE يحتوي original token؛ إذا تغير الصف منذ القراءة، لا يحدث update ويُرمى DbUpdateConcurrencyException. تعامل معها كقرار business: reload/merge/reject، لا تعِد SaveChanges بلا فهم. لا تستخدم concurrency token على كل شيء آليًا؛ حدّد aggregate الذي يحتاج lost-update protection.

C#Concurrency token mapping and handling
modelBuilder.Entity<Product>()
    .Property(x => x.RowVersion)
    .IsRowVersion();

try
{
    await db.SaveChangesAsync(ct);
}
catch (DbUpdateConcurrencyException)
{
    throw new ConflictException("The product changed; reload and retry your edit.");
}

EF Core يفتح transaction تلقائيًا لـ SaveChanges عند دعم provider، ويمكن explicit transaction عند عدة saves/queries. عند وجود active transaction قد يستخدم savepoints حسب provider. لا تترك transaction مفتوحة أثناء external HTTP. لو تستخدم retrying execution strategy، راجع pattern المناسب لإعادة تنفيذ transaction كاملة؛ لا تخلط retry strategy مع transaction يدوي دون مراعاة provider.

Optimistic Concurrency و Handling DbUpdateConcurrencyException

Optimistic concurrency يفترض أن التعارض نادر، لذلك لا يقفل الصف طوال وقت تحرير المستخدم. يقرأ التطبيق نسخة، وعند الحفظ يرسل UPDATE مشروطًا بالقيمة القديمة للـ concurrency token. لو عدد الصفوف المتأثرة صفرًا، EF يرمي DbUpdateConcurrencyException. ده conflict business حقيقي، وليس transient network error يجوز إعادة نفس الأمر بلا مراجعة.

SQL Server rowversion قيمة binary تتغير تلقائيًا عند تحديث الصف. في PostgreSQL يمكن استخدام concurrency token مُدار بالتطبيق أو system column وفق تصميم provider. قرر هل تعرض conflict للمستخدم، تعمل merge لحقول غير متعارضة، أم تعيد تحميل الحالة وتطلب تأكيدًا. لا تعمل blind overwrite.

C#Practical engineering example
public sealed class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public byte[] RowVersion { get; set; } = [];
}

modelBuilder.Entity<Product>()
    .Property(x => x.RowVersion)
    .IsRowVersion();

try
{
    product.Name = request.Name;
    await db.SaveChangesAsync(ct);
}
catch (DbUpdateConcurrencyException)
{
    // Reload current values and return a conflict response.
    return Results.Conflict(new { message = "The product changed. Reload and retry." });
}

الـ retry policy المناسبة للأخطاء المؤقتة لا تحل business conflict. افصل بين transient failure مثل انقطاع اتصال مؤقت، وconcurrency conflict ناتج عن تعديل متزامن. واختبر السلوك باستخدام طلبين يقرآن نفس النسخة ثم يحاولان الحفظ.

11

Raw SQL و Interceptors و Query Tags

Controlled escape hatches and diagnostics
Practical

Raw SQL مناسب لاستعلام لا يترجم بسهولة أو محتاج feature خاصة بالمحرك. استخدم parameterized APIs؛ تجنب string interpolation غير الآمن. FromSql للكيانات/النتائج المدعومة، و ExecuteSql لأوامر غير راجعة entities. Query tags تضيف تعليقًا للتعرف على query في logs و traces.

C#Parameterized SQL and query tag
var products = await db.Products
    .FromSql($"SELECT * FROM dbo.Products WHERE Price >= {minimumPrice}")
    .TagWith("Catalog: expensive products")
    .AsNoTracking()
    .ToListAsync(cancellationToken);

Interceptors تسمح بمراقبة أو تعديل بعض عمليات EF (commands, connections, SaveChanges). استخدمها للـ cross-cutting concerns مثل diagnostics أو auditing المدروس، لكن لا تخفِ business logic فيها ولا تحوّلها لمكان سحري يصعب تتبعه.

12

Performance: pooling و compiled queries و bulk operations

Optimize only after measurement
Deep dive

Compiled queries تقلل تكلفة ترجمة expression المتكررة في hot paths، لكنها لا تقلل زمن SQL نفسه. DbContext pooling يعيد استخدام context instances ويقلل initialization overhead، لكن لازم تتجنب تخزين state خاص بال request داخل context pooled. Connection pooling شيء مختلف ويتدار غالبًا من ADO.NET provider.

ExecuteUpdateAsync و ExecuteDeleteAsync ينفذان set-based SQL من غير تحميل entities أو Change Tracker؛ ممتازين للتحديث الجماعي، لكنهما يتجاوزان tracking والـ SaveChanges pipeline، وبالتالي لا تتوقع domain events أو client-side validation أو concurrency behavior المعتاد تلقائيًا.

C#Set-based update and compiled query
await db.Products
    .Where(p => !p.IsActive && p.LastUpdated < cutoff)
    .ExecuteUpdateAsync(setters => setters
        .SetProperty(p => p.IsArchived, true), cancellationToken);

private static readonly Func<AppDbContext, int, IAsyncEnumerable<Product>>
    ProductsByCategory = EF.CompileAsyncQuery(
        (AppDbContext context, int categoryId) =>
            context.Products.Where(p => p.CategoryId == categoryId));

Bulk libraries الخارجية قد تكون مفيدة جدًا لأحجام ضخمة، لكن راجع دعم provider، transaction behavior، identity generation، triggers، concurrency، وحقوق الترخيص. ما تختارش bulk لمجرد الاسم.

Connection resiliency: فعّل retry execution strategy للـ transient failures حسب provider، مع مراعاة إن العملية قد تكون نُفذت في DB قبل انقطاع الاتصال أثناء الرد؛ لذلك idempotency و unique constraints مهمين في العمليات الحساسة.

DbContext Pooling: إمتى يفيد وإمتى يضر؟

AddDbContextPool يعيد تدوير instances بعد انتهاء استخدامها. ده قد يقلل تكلفة إنشاء context في high-throughput workloads، لكنه يتطلب أن context لا يحمل state خاصًا بمستخدم/tenant يظل عالقًا عند إعادة الاستخدام. لا تخزن current user أو tenant id في field mutable من غير reset مضمون. لو عندك state خاص بال request، scoped factory أو interceptor مضبوط قد يكون أبسط.

Pooling للـ DbContext لا يعني مشاركة context بين requests في نفس الوقت؛ كل lease يستخدم instance واحدة في وقت واحد. وده مختلف عن ADO.NET connection pooling الذي يعيد استخدام physical connections.

DbContext Pooling و Compiled Queries

AddDbContextPool يعيد استخدام DbContext instances بعد reset state، وقد يقلل allocation في high-throughput apps. لكنه يتطلب عدم الاحتفاظ بـ per-request mutable state داخل context أو injected scoped services بطريقة تتسرب بين requests. لو عندك tenant id في context property أو custom interceptor state، تأكد أن reset/initialization آمن قبل إعادة الاستخدام.

Compiled queries تقلل تكلفة expression/query compilation عندما نفس query shape تتكرر بكثرة. غالبًا EF Core لديه query cache تلقائيًا؛ compiled query مفيدة في hot paths مقاسة، وليس لكل query. parameters يجب أن تكون بسيطة ومتوافقة مع compiled expression.

C#Compiled query example
private static readonly Func<AppDbContext, int, IAsyncEnumerable<Product>>
    ActiveProductByCategory = EF.CompileAsyncQuery(
        (AppDbContext db, int categoryId) => db.Products
            .Where(p => p.CategoryId == categoryId && p.IsActive));

await foreach (var product in ActiveProductByCategory(db, categoryId))
{
    // Stream results; cancellation/consumer behavior must be considered.
}

قِس قبل وبعد: query duration، allocations، CPU، DB logical reads. غالبًا index/projection/N+1 fixes تعطي أثرًا أكبر من compiled query. لا تستخدم pooling لتغطية lifetime bugs؛ افهم context ownership أولًا.

13

Global Query Filters و JSON و Multi-Tenancy

Cross-cutting data visibility
Deep dive

Global query filter يضيف شرطًا افتراضيًا لكل query على entity type، شائع للـ soft delete أو tenant isolation. لكنه ليس بديلًا عن authorization؛ لازم تتأكد إن tenant context موثوق ومربوط بالمستخدم، وتحذر من IgnoreQueryFilters لأنه يتجاوز الحماية الافتراضية.

C#Soft-delete filter
modelBuilder.Entity<Product>()
    .HasQueryFilter(p => !p.IsDeleted);

// Explicit administrative path only; guard with authorization.
var archived = await db.Products
    .IgnoreQueryFilters()
    .Where(p => p.IsDeleted)
    .ToListAsync(cancellationToken);

JSON column mapping مفيد لخصائص شبه مرنة، لكن لا تخزن كل شيء JSON لمجرد المرونة. قيم متكررة تدخل في filtering/sorting/joins غالبًا تستحق أعمدة relational واضحة أو computed/indexed strategy مدروسة.

Global Query Filters و Multi-Tenancy و Soft Delete

Global query filter يضيف predicate تلقائيًا لكل query على entity، مثل IsDeleted == false أو TenantId. مفيد لتقليل نسيان filter، لكنه لا يمثل authorization كاملًا؛ يمكن تجاوزه بـ IgnoreQueryFilters، وبعض raw SQL أو direct database paths لا تمر من خلاله. tenant scope لازم يكون جزءًا من application authorization/data access policy.

C#Tenant filter — simplified model
public sealed class AppDbContext(
    DbContextOptions<AppDbContext> options,
    ICurrentTenant tenant) : DbContext(options)
{
    public Guid CurrentTenantId { get; } = tenant.Id;

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Order>()
            .HasQueryFilter(x => x.TenantId == CurrentTenantId && !x.IsDeleted);
    }
}

مع DbContext pooling، tenant state per request حساس جدًا؛ لا تحتفظ بقيمة tenant من request سابقة. اختبر إن context يعاد تهيئته بشكل صحيح أو تجنب pooling لهذا التصميم. migrations/admin queries قد تحتاج IgnoreQueryFilters بشكل محدود ومراجع، ولا تعرضه في generic repository لكل callers.

14

Integration Tests و EF Core

Test against the real provider when it matters
Deep dive

اختبار EF Core على InMemory provider لا يثبت صحة SQL Server behavior؛ InMemory مش relational ولا يطبق FK/transactions/SQL translation بنفس الطريقة. SQLite in-memory أقرب للـ relational لكنه ما زال مختلفًا عن SQL Server. اختبر critical queries والمigrations والتزامن على نفس provider قدر الإمكان، باستخدام disposable database أو Testcontainers.

C#Repository integration test sketch
[Fact]
public async Task CreateProduct_PersistsRow()
{
    await using var db = CreateSqlServerTestContext();
    var product = new Product { Name = "Keyboard", Price = 1200m };
    db.Products.Add(product);

    await db.SaveChangesAsync();

    var saved = await db.Products
        .AsNoTracking()
        .SingleAsync(x => x.Id == product.Id);
    Assert.Equal("Keyboard", saved.Name);
}

الـ test لازم يعزل database state، ويعمل cleanup، وما يعتمدش على ترتيب تنفيذ tests. استخدم fixture مشتركة للبنية التحتية مع database منفصلة أو schema/transaction strategy واضحة.

اختبار EF Core على Provider حقيقي

اختبر migrations على database test حقيقية، relationships/delete behavior، unique/FK constraints، concurrency tokens، transaction rollback، query translation، global filters، split query و ExecuteUpdate semantics. InMemory provider لا يطبق relational constraints ولا SQL translation؛ SQLite in-memory قد يساعد لبعض relational tests لكنه ليس SQL Server، وقد تختلف types/functions/collations.

استخدم Testcontainers أو ephemeral database في CI عند أهمية provider behavior. جهز database مرة لكل test collection، طبّق migrations، اعزل data، ثم reset via transaction/Respawn/database recreation. اختبر query performance على dataset ممثلة بشكل منفصل عن correctness tests؛ لا تجعل timing assertions fragile في CI.

15

أخطاء EF Core المتكررة ومراجعة

Production-minded checklist
Basics
  • DbContext Singleton أو مشاركة نفس instance بين threads.
  • تحميل كل الأعمدة وكل العلاقات ثم تحويلها إلى DTO داخل الذاكرة.
  • Lazy loading داخل loops والتسبب في N+1.
  • اعتبار AsNoTracking حلًا سحريًا لكل query حتى لو محتاج update.
  • تغيير schema في production من كل API replica عند startup.
  • تجاهل SQL المترجم والـ execution plan.
  • الاعتماد على InMemory tests لإثبات behavior خاص بـ SQL Server.
  • تجاهل DbUpdateConcurrencyException أو إعادة المحاولة بلا conflict resolution.
  • استخدام IgnoreQueryFilters من غير authorization واضح.
هل DbSet هو الجدول نفسه؟
هو واجهة query/add للـ entity type داخل DbContext؛ mapping النهائي للجدول تحدده conventions و Fluent API.
متى أستخدم AsNoTracking؟
في read-only queries التي لا تحتاج تعديل entities tracked. Projection إلى DTO غالبًا خيار ممتاز أيضًا.
هل Include أفضل من Select؟
ليس دائمًا. Include يحمل entity graph؛ Select projection يرجع الحقول المطلوبة وغالبًا أفضل لقراءة API.
هل ExecuteUpdate يشغّل SaveChanges و Change Tracker؟
لا. ينفذ update set-based مباشرة في DB ويتجاوز تحميل وتتبع entities و SaveChanges pipeline.
ما الذي يسبب DbUpdateConcurrencyException؟
غالبًا concurrency token أو affected-row check لم يطابق الصف الحالي لأن مستخدمًا آخر عدّل أو حذف البيانات بعد قراءتها.
16

ExecuteUpdate و ExecuteDelete vs Tracked Updates

Set-based writes without materializing entities
Deep dive

ExecuteUpdateAsync و ExecuteDeleteAsync تنفذ set-based SQL مباشرة من query من غير تحميل entities أو Change Tracker. ممتازة لتحديث آلاف rows بنفس rule، لكنها تتجاوز domain methods و tracked state. لو context فيه entities محملة، Change Tracker لا يتحدث تلقائيًا بعد bulk command؛ قد تحتاج clear/reload أو context جديد.

C#Set-based bulk update
var archivedAt = clock.UtcNow;
var affected = await db.Products
    .Where(p => !p.IsActive && p.LastSoldAt < cutoff)
    .ExecuteUpdateAsync(setters => setters
        .SetProperty(p => p.IsArchived, true)
        .SetProperty(p => p.ArchivedAt, archivedAt), ct);

ده لا يستدعي Product.Archive() لكل entity؛ لذلك استخدمه عندما العملية set-based ومفهومة، ولا توجد invariants per entity تحتاج التنفيذ. لو عندك concurrency token، audit event لكل row، domain event أو side effect، bulk update قد لا يكون مناسبًا من غير design إضافي.

↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 37 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapDbContext and DbSet§01
RoadmapEntity Configuration§01
RoadmapData Annotations vs Fluent API§01
RoadmapRelationships§04
RoadmapChange Tracking§05
RoadmapAsNoTracking§05
RoadmapSaveChanges and SaveChangesAsync§05
RoadmapMigrations§06
RoadmapData Seeding§06
RoadmapLINQ Translation§02
RoadmapClient vs Server Evaluation§07
RoadmapEager Loading§08
RoadmapExplicit Loading§08
RoadmapLazy Loading§08
RoadmapN+1 Query Problem§08
RoadmapProjection§08
RoadmapTransactions§10
RoadmapRaw SQL§02
RoadmapInterceptors§10
RoadmapConcurrency Tokens§10
RoadmapQuery Splitting§06
RoadmapCompiled Query Concepts§06
RoadmapConnection Resiliency§06
RoadmapBulk Operation Concepts§06
RoadmapPerformance Optimization§06
RoadmapIntegration Tests§06
SuggestedExecuteUpdate and ExecuteDelete§06
SuggestedGlobal query filters (soft delete, tenancy)§12
SuggestedOwned types and value converters§03
SuggestedInheritance mapping: TPH, TPT, TPC§03
SuggestedSplit queries trade-offs§09
SuggestedDbContext pooling§12
SuggestedRowVersion optimistic concurrency§10
SuggestedQuery tags and EF Core logging§11
SuggestedKeyless entities and view mapping§03
SuggestedMigration bundles in CI/CD§06
SuggestedJSON columns§13

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس