‫ارتقا به NET 10. و EF Core 10: تغییرات رفتار زمان اجرا که در زمان کامپایل پنهان می‌مانند

چکیده: مهاجرت به نسخه‌های جدید دات‌نت معمولاً با بررسی خطاهای زمان کامپایل (Compile-time Errors) و APIهای منسوخ‌شده آغاز می‌شود؛ با این حال، حساس‌ترین چالش‌ها مربوط به «تغییرات رفتاری زمان اجرا» (Runtime Behavioral Breaking Changes) هستند. در Entity Framework Core 10، تغییر بنیادینی در استراتژی ترجمه LINQ به SQL برای عملگر متداول Contains() اعمال شده است. در این نسخه، ترجمه پیش‌فرض از آرایه‌های مبتنی بر JSON (نظیر OPENJSON در SQL Server یا json_each در SQLite) به پارامترهای اسکالر تفکیک‌شده (Multiple Scalar Parameters) تغییر یافته است. این تغییر اگرچه در خروجی داده‌ها تفاوتی ایجاد نمی‌کند، اما ساختار متن SQL، شیوه‌ی نام‌گذاری پارامترها و رفتار حافظه موقت پلن‌های اجرایی دیتابیس (Query Plan Cache) را دگرگون می‌سازد. این مقاله به تحلیل دقیق این تغییر، اثرات آن بر کارایی و روش‌های کنترل یا بازگردانی رفتار قبلی می‌پردازد.

var idList = new List<int> { 1, 3 };
var blogs = await db.Blogs
                    .Where(b => idList.Contains(b.Id))
                    .ToListAsync();

• در SQL Server:

-- EF Core 9 (SQL Server)
SELECT [b].[Id], [b].[Name], [b].[Address_City], [b].[Address_Street]
FROM [Blogs] AS [b]
WHERE [b].[Id] IN (
    SELECT [value] 
    FROM OPENJSON(@__idList_0)
)
-- Parameters: @__idList_0='[1,3]'

• در SQLite:

-- EF Core 9 (SQLite)
SELECT "b"."Id", "b"."Name", "b"."Tags", "b"."Address_City", "b"."Address_Street"
FROM "Blogs" AS "b"
WHERE "b"."Id" IN (
    SELECT "i"."value"
    FROM json_each(@__idList_0) AS "i"
)
-- Parameters: @__idList_0='[1,3]'

• در SQL Server:

-- EF Core 10 (SQL Server)
SELECT [b].[Id], [b].[Name], [b].[Address_City], [b].[Address_Street]
FROM [Blogs] AS [b]
WHERE [b].[Id] IN (@idList1, @idList2)
-- Parameters: @idList1=1, @idList2=3

• در SQLite:

-- EF Core 10 (SQLite)
SELECT "b"."Id", "b"."Name", "b"."Tags", "b"."Address_City", "b"."Address_Street"
FROM "Blogs" AS "b"
WHERE "b"."Id" IN (@idList1, @idList2)
-- Parameters: @idList1='1', @idList2='3'

• در گذشته: پیشوند __ همراه با اندیس متغیر اعمال می‌شد (مانند @__idList_0 یا @__city_0).
• در EF Core 10: نام‌گذاری تمیزتر شده و مستقیماً برگرفته از نام متغیر در کد سی‌شارپ است (مانند @idList1, @idList2 یا @city).

نکته حائز اهمیت: اگرچه این تغییر پایگاه‌داده را تحت تأثیر منفی قرار نمی‌دهد، اما دو دسته از پیاده‌سازی‌ها را بلافاصله با خطا مواجه می‌کند:

• تست‌های مبتنی بر Snapshot: تست‌های واحد یا یکپارچه‌سازی که متن کوئری تولیدشده توسط EF Core را با رشته‌های ثابت مقایسه می‌کنند.
• اینترسپتورها (Interceptors): کدهایی که در DbCommandInterceptor با عبارات باقاعده (Regex) یا جستجوی متنی روی DbCommand.CommandText به دنبال پارامترهایی با پیشوند __ می‌گشتند.

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer(
        connectionString,
        sqlServerOptions => sqlServerOptions.UseParameterizedCollectionMode(
            ParameterTranslationMode.Parameter
        )
    );
}

var blogs = await db.Blogs
                    .Where(b => EF.Parameter(idList).Contains(b.Id))
                    .ToListAsync();