‫مدیریت استخر اتصال (Connection Pooling) و استخر DbContext در NET.: از مفاهیم پایه تا بهینه‌سازی پیشرفته

• استخر اتصال ADO.NET (Database Connection Pooling): مدیریت و نگهداری اتصالات فیزیکی شبکه به پایگاه‌داده.
• استخر EF Core DbContext (DbContext Pooling): مدیریت و بازاستفاده از نمونه‌های شیء context در لایه نگاشت شیء-رابطه‌ای (ORM).

[ درخواست برنامه ]
                          │
                          ▼
            ┌──────────────────────────┐
                آیا اتصال آزاد در استخر        
                     موجود است؟          
            └────────────┬─────────────┘
                         │
             ┌───────────┴───────────┐
            بله                     خیر
             │                       │
             ▼                       ▼
┌──────────────────────────┐ ┌──────────────────────────┐
   تخصیص اتصال موجود به           یا ظرفیت حداکثر اندازه استخر    
        برنامه                       تکمیل شده است؟         
└──────────────────────────┘ └───────────┬──────────────┘
                                         │
                             ┌───────────┴───────────┐
                            بله                     خیر
                             │                       │
                             ▼                       ▼
                ┌──────────────────────────┐ ┌──────────────────────────┐
                    قرارگیری درخواست در صف              ایجاد اتصال فیزیکی جدید   
                    (انتظار تا Connection               و افزودن به استخر          
                         Timeout)            └──────────────────────────┘
                └──────────────────────────┘

نکته مهم: حتی تغییر در ترتیب کلیدواژه‌های رشته اتصال باعث ایجاد استخرهای متفاوت می‌شود:

• Server=localhost;Database=AppDb;
• Database=AppDb;Server=localhost;

این دو رشته اتصال منجر به ایجاد دو استخر مجزا می‌شوند که می‌تواند باعث هدر رفت منابع سرور گردد.

using Microsoft.Data.SqlClient;

public async Task<List<Product>> GetProductsAsync(string connectionString)
{
    var products = new List<Product>();

    // ساختار await using تضمین می‌کند که اتصال حتی در صورت بروز خطا به استخر بازمی‌گردد
    await using var connection = new SqlConnection(connectionString);
    
    // در این مرحله، اتصال واقعی از استخر گرفته می‌شود (یا ایجاد می‌شود)
    await connection.OpenAsync();

    await using var command = new SqlCommand("SELECT Id, Title, Price FROM Products", connection);
    await using var reader = await command.ExecuteReaderAsync();

    while (await reader.ReadAsync())
    {
        products.Add(new Product
        {
            Id = reader.GetInt32(0),
            Title = reader.GetString(1),
            Price = reader.GetDecimal(2)
        });
    }

    return products;
} // در پایان اسکوپ، متد DisposeAsync فراخوانی شده و اتصال به استخر باز می‌گردد.

• Database Connection Pooling: توسط ADO.NET مدیریت می‌شود و هدف آن بازاستفاده از اتصالات فیزیکی شبکه است.
• DbContext Pooling: توسط EF Core مدیریت می‌شود و هدف آن بازاستفاده از اشیاء DbContext در حافظه RAM جهت کاهش هزینه‌های تخصیص حافظه (Allocation) و جمع‌آوری زباله (Garbage Collection) است.

┌──────────────────────────────────────────────────────────┐
│                   EF Core Application                    │
│                                                          │
│   ┌──────────────────────────────────────────────────┐   │
│   │               DbContext Pool                     │   │
│   │   [DbContext Instance]   [DbContext Instance]    │   │
│   └────────────────────────┬─────────────────────────┘   │
└────────────────────────────┼─────────────────────────────┘
                             │ (بازاستفاده از نمونه‌ها)
                             ▼
┌──────────────────────────────────────────────────────────┐
│                  ADO.NET Provider                        │
│                                                          │
│   ┌──────────────────────────────────────────────────┐   │
│   │             Connection Pool                      │   │
│   │   [Physical Conn 1]      [Physical Conn 2]       │   │
│   └────────────────────────┬─────────────────────────┘   │
└────────────────────────────┼─────────────────────────────┘
                             │ (بازاستفاده از اتصالات شبکه)
                             ▼
                   ┌───────────────────┐
                   │  Database Server  │
                   └───────────────────┘

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

builder.Services.AddDbContextPool<AppDbContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")),
    poolSize: 1024); // تنظیم حداکثر اندازه استخر (پیش‌فرض 1028 است)

• دریافت درخواست HTTP
• ایجاد یک نمونه جدید از DbContext
• دریافت اتصال از استخر ADO.NET
• اجرای پرس‌وجو (Query)
• بازگشت اتصال به استخر ADO.NET
• تخریب (Destroy) نمونه DbContext و آزادسازی حافظه توسط Garbage Collector

• دریافت درخواست HTTP
• دریافت یک نمونه آماده از DbContext از استخر EF Core
• دریافت اتصال از استخر ADO.NET
• اجرای پرس‌وجو (Query)
• بازگشت اتصال به استخر ADO.NET
• بازنشانی وضعیت داخلی (Reset State) نمونه DbContext
• بازگشت نمونه DbContext به استخر EF Core برای درخواست بعدی

System.InvalidOperationException: Timeout expired. The timeout period elapsed prior to obtaining a connection from the pool.

• عدم آزادسازی اتصالات: عدم استفاده از using یا Dispose در کدهای ADO.NET/Dapper.
• تراکنش‌های طولانی‌مدت (Long-running Transactions): باز نگه داشتن اتصال در حین پردازش‌های سنگین غیر پایگاه‌داده‌ای.
• تغییرات پویا در رشته اتصال: تولید Dynamic Connection String به ازای هر کاربر که باعث ایجاد استخرهای متعدد و اتمام منابع سرور می‌شود.

• عدم نخ‌امنی (Thread Safety): کلاس DbContext به هیچ عنوان Thread-Safe نیست. هرگز نباید آن را به صورت Singleton ثبت کرد.
• حفظ حالت (State Leakage) در DbContext Pooling: اگر در کلاس DbContext متغیرها یا سرویس‌های دارای State ذخیره کنید، این حالت ممکن است بین درخواست‌های کاربران مختلف به اشتراک گذاشته شود.

// پاکسازی استخر مربوط به یک اتصال خاص
SqlConnection.ClearPool(new SqlConnection(connectionString));

// پاکسازی تمامی استخرهای برنامه
SqlConnection.ClearAllPools();

• ارزیابی پیش از استفاده: همیشه پیش از فعال‌سازی AddDbContextPool تست بار (Load Test) انجام دهید. این بهینه‌سازی عمدتاً در سامانه‌هایی با نرخ درخواست بالا (High Throughput) تاثیر ملموس نشان می‌دهد.
• الگوی Open Late, Close Early: اتصال به پایگاه‌داده را دقیقاً پیش از اجرای پرس‌وجو باز کرده و به محض اتمام عملیات آزادسازی کنید.
• استفاده همه‌جانبه از متدهای Async: همواره از متدهای OpenAsync، ExecuteReaderAsync و SaveChangesAsync استفاده کنید تا نخ‌های (Threads) برنامه بلوکه نشوند.
• تثبیت رشته اتصال: از اعمال تغییرات پویا در Connection String پرهیز کرده و پارامترهای مستاجری (Multi-tenancy) را به جای Connection String در سطح کئوری‌ها یا شیوه Catalog به‌کار ببرید.
• مانیتورینگ: عملکرد استخر را با ابزارهای مانیتورینگ مانند Performance Counters، مترییک‌های OpenTelemetry یا دستورات تحلیل دیتابیس (مانند sys.dm_exec_sessions در SQL Server) زیر نظر بگیرید.