‫بهینه‌سازی دسترسی به داده‌ها در NET.: راهنمای مدیریت Connection Pool در ADO.NET

• اگر بله: ADO.NET همان اتصال موجود را به برنامه شما بازمی‌گرداند. در این حالت، عملیات پرهزینه ایجاد اتصال فیزیکی حذف می‌شود.
• اگر خیر: ADO.NET یک اتصال جدید به پایگاه داده ایجاد می‌کند (در صورتی که اندازه استخر اجازه دهد) و آن را به برنامه تحویل می‌دهد.
• پس از اتمام کار: هنگامی که برنامه شما اتصال را می‌بندد (با فراخوانی Close() یا Dispose())، اتصال به جای اینکه به صورت فیزیکی قطع شود، به استخر بازگردانده می‌شود و در آنجا منتظر درخواست بعدی می‌ماند.

var connectionString = "Server=myServer;Database=myDb;User Id=myUser;Password=myPass;";

• Pooling=true;: (پیش‌فرض) فعال یا غیرفعال کردن Connection Pooling.
• Min Pool Size=0;: (پیش‌فرض: 0) حداقل تعداد اتصالات موجود در استخر.
• Max Pool Size=100;: (پیش‌فرض: 100) حداکثر تعداد اتصالات مجاز در استخر.

var connectionString = "Server=myServer;Database=myDb;User Id=myUser;Password=myPass;Pooling=true;Max Pool Size=50;";

using(var connection = new SqlConnection(connectionString))
{
    connection.Open();
    // اجرای دستورات...
}

• اگر موجود باشد: ADO.NET اتصال استخر شده را به شما بازمی‌گرداند و نیازی به باز کردن فیزیکی اتصال نیست.
• اگر موجود نباشد: یک اتصال فیزیکی جدید ایجاد کرده و آن را برای استفاده‌های بعدی به استخر اضافه می‌کند.

connection.Close(); // یا اتمام بلوک using

Pooling=true;Max Pool Size=50;Min Pool Size=5;Connection Lifetime=600;

• TimeoutException: زمانی که درخواست برای مدت زمان مشخصی منتظر اتصال بماند.
• InvalidOperationException: در برخی سناریوها ممکن است این خطا رخ دهد.

• نظارت بر استفاده از استخر: می‌توانید از ابزارهایی مانند SQL Server Performance Counters (شمارنده‌های عملکرد SQL Server) برای نظارت بر میزان استفاده از اتصالات در استخر استفاده کنید.
• افزایش Max Pool Size: در صورت نیاز و مشاهده خطاهای مرتبط با پر بودن استخر، می‌توانید مقدار Max Pool Size را افزایش دهید.

• غیرمعتبر شدن اتصال: برای مثال، به دلیل مشکلات شبکه (Network Issues).
• راه‌اندازی مجدد پایگاه داده: پس از راه‌اندازی مجدد سرور پایگاه داده.
• اتمام عمر اتصال: زمانی که Connection Lifetime (عمر اتصال) یا آستانه‌های زمانی (Timeout Thresholds) منقضی شوند.
• فراخوانی دستی: زمانی که برنامه به صورت دستی متدهای ClearPool() یا ClearAllPools() را فراخوانی کند.

SqlConnection.ClearAllPools();

[HttpGet("products")]
public IActionResult GetProducts()
{
    using(var connection = new SqlConnection(_config.ConnectionString))
    {
        connection.Open();
        using(var command = new SqlCommand("SELECT * FROM Products", connection))
        using(var reader = command.ExecuteReader())
        {
            var products = new List<Product>();
            while(reader.Read())
            {
                products.Add(new Product
                {
                    Id = reader.GetInt32(0),
                    Name = reader.GetString(1)
                });
            }
            return Ok(products);
        }
    }
}

• connection.Open(): ابتدا استخر را بررسی می‌کند.
• یک اتصال استخر شده (Pooled Connection) مجدداً استفاده می‌شود یا یک اتصال جدید ایجاد می‌شود.
• هنگامی که بلوک using اتصال را Dispose می‌کند، اتصال به استخر بازگردانده می‌شود.

• همیشه از using یا Dispose() استفاده کنید: این کار تضمین می‌کند که اتصالات به درستی به استخر بازگردانده شوند و از نشت منابع (Resource Leaks) جلوگیری می‌کند.
• رشته‌های اتصال را دقیقاً مطابقت دهید: رشته‌های اتصال متفاوت، حتی با یک تغییر کوچک، منجر به ایجاد استخرهای جداگانه می‌شوند. اطمینان حاصل کنید که از یک رشته اتصال ثابت برای اتصالات مشابه استفاده می‌کنید.
• اندازه‌های استخر را نظارت و تنظیم کنید: بر اساس بار کاری برنامه خود، مقادیر Min Pool Size و Max Pool Size را تنظیم کنید. نظارت بر عملکرد می‌تواند به شما در تعیین مقادیر بهینه کمک کند.
• اتصالات را بیش از حد نیاز نگه ندارید: به محض اتمام کار با اتصال، آن را ببندید یا Dispose کنید تا به استخر بازگردانده شود و برای سایر درخواست‌ها در دسترس قرار گیرد.