‫پشتیبانی از نوع داده JSON در EF Core 10: تحولی در مدیریت داده‌های ساخت‌یافته

• کوئری سخت و ناکارآمد: برای جستجو داخل JSON، باید از توابع SQL مانند JSON_VALUE یا JSON_QUERY استفاده کنید، اما این کار دستی است و خطاپذیر. علاوه بر این، بدون ایندکس مناسب، عملکرد ضعیف می‌شود.
• به‌روزرسانی پیچیده: تغییر بخشی از JSON (مثل تغییر کد پستی در آدرس) اغلب نیاز به خواندن کل داده، تغییر آن در کد، و ذخیره مجدد دارد. این کار نه تنها کند است، بلکه ریسک خطا را افزایش می‌دهد.
• عدم تضمین اعتبار داده: دیتابیس نمی‌تواند بررسی کند که داده واقعاً JSON معتبر باشد، پس ممکن است داده‌های نامعتبر وارد شوند و بعداً مشکلات ایجاد کنند.
• عملکرد پایین: ذخیره به عنوان nvarchar(max) یا varchar(max) باعث می‌شود عملیات خواندن و نوشتن کندتر شود، چون دیتابیس نمی‌تواند بهینه‌سازی‌های خاصی برای JSON اعمال کند.

• نیاز به کد اضافی برای تبدیل JSON به string و بالعکس.
• کوئری‌ها باید با توابع SQL دستی نوشته می‌شدند، مثل JSON_VALUE([Column], '$.Path').
• به‌روزرسانی‌ها اغلب کامل بودند، یعنی کل ستون را جایگزین می‌کردید، نه فقط بخشی از آن.
• عدم پشتیبانی مستقیم از ایندکس روی فیلدهای داخل JSON، که جستجو را کند می‌کرد.

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public required Contact Contact { get; set; }
}

public class Contact
{
    public required Address Address { get; set; }
    public List<PhoneNumber> PhoneNumbers { get; set; } = new List<PhoneNumber>();
}

public class Address
{
    public required string Street { get; set; }
    public required string City { get; set; }
    public required string State { get; set; }
    public required string PostalCode { get; set; }
}

public class PhoneNumber
{
    public PhoneNumberType Type { get; set; }
    public string Number { get; set; }

    public PhoneNumber(PhoneNumberType type, string number)
    {
        Type = type;
        Number = number;
    }
}

public enum PhoneNumberType
{
    Mobile,
    Home
}

public class MyDbContext : DbContext
{
    public DbSet<Customer> Customers { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("<ConnectionString>", x => x.UseCompatibilityLevel(170)); // برای SQL Server 2025
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Customer>(x =>
        {
            x.ComplexProperty(c => c.Contact, b => b.ToJson());
        });
    }
}

CREATE TABLE [Customers] (
    [Id] int NOT NULL IDENTITY,
    [Name] nvarchar(max) NOT NULL,
    [Contact] json NOT NULL,
    CONSTRAINT [PK_Customers] PRIMARY KEY ([Id])
);

var customersInWA = await context.Customers
    .Where(c => c.Contact.Address.State == "WA")
    .ToListAsync();

SELECT [c].[Id], [c].[Name], [c].[Contact]
FROM [Customers] AS [c]
WHERE JSON_VALUE([c].[Contact], '$.Address.State') = N'WA'

var distinctStates = await context.Customers
    .Select(c => c.Contact.Address.State)
    .Distinct()
    .ToListAsync();

SELECT DISTINCT JSON_VALUE([c].[Contact], '$.Address.State')
FROM [Customers] AS [c]

var premiumUsers = db.Users
    .Where(u => EF.Functions.JsonContains(u.Metadata, "{ \"Premium\": true }"))
    .ToList();

await context.Customers
    .Where(c => c.Name == "John Doe")
    .ExecuteUpdateAsync(setters => setters.SetProperty(c => c.Contact.Address.PostalCode, "98102"));

UPDATE [c]
SET [Contact] = JSON_MODIFY([Contact], '$.Address.PostalCode', @p0)
FROM [Customers] AS [c]
WHERE [c].[Name] = N'John Doe'