الجزء 1-3: مُوَدَدّد المسار مع EF (العربية (Arabic))

الجزء 1-3: مُوَدَدّد المسار مع EF

Saturday, 06 December 2025

//

15 minute read

مسارات مُحَكَّمَة مُحَمَّدة تُخَرِج السلالة الكاملة كسلسلة مُحَدَّدة - مثل /1/3/7/ مثالي لجيل فتات الخبز والتنقيط الذي يمكن قراءة الإنسان له، على الرغم من أن تحريك الأشجار الفرعية يعني تحديث كل سلسلة مسار كل سليل.

السلسلة


ما هو الدرب المصوَّر ؟

نمط المسار (يسمى أيضاً أيضاً "Path Enternationation" في اشجار وهيّات Celko لـ(يخزن النسب الكاملة لكل عقدة كسلسلة محددة - مثل مسار ملف أو عنوان بريدي. بدلاً من تخزين "والدي هو العقدة 5" ، نخزن "أنا وصلت عبر العقدة 1 o 3 o 5 y 7" مباشرة في الصف.

فكّر فيه مثل تخزين العنوان الكامل بدلاً من مجرد اسم الصفحة. /blog/posts/2024/my-article تخبرك بالضبط أين أنت في التسلسل الهرمي، لا حاجة للبحث.

البصيرة الرئيسية: نحن نتاجر بالتساؤل عن التعقيد من أجل تكرار التخزين. السلالة تتحلل إلى كل صف، لكن هذا يجعل من الأسلاف استفسارات تافهة -- فقط إعراب عن السلسلة.

ألف - المفهوم المكصّر

flowchart TD
    subgraph "Comment Tree"
        C1["Comment 1<br/>Path: /1/"]
        C2["Comment 2<br/>Path: /1/2/"]
        C3["Comment 3<br/>Path: /1/3/"]
        C4["Comment 4<br/>Path: /1/3/4/"]
    end

    C1 --> C2
    C1 --> C3
    C3 --> C4

    subgraph "What the paths tell us"
        P1["Comment 4's path /1/3/4/ means:<br/>• Ancestors are 1, 3 (parse the path)<br/>• Depth is 3 (count separators - 1)<br/>• Root is 1 (first element)"]
    end

    style C1 stroke:#6366f1,stroke-width:2px
    style C2 stroke:#8b5cf6,stroke-width:2px
    style C3 stroke:#8b5cf6,stroke-width:2px
    style C4 stroke:#a855f7,stroke-width:2px

المسار هو ذاتي الوصف:

  • أُسس الأُسس: تهيئة /1/3/4/ الأسلاف هم: [1, 3, 4]
  • الأحفاد: طلب المطلب WHERE path LIKE '/1/3/%' يحصل على الكل تحت العقدة 3
  • عُيّنة العمق: الـ عدد المفرقات المنفصلة - 1
  • الإخوة الذين توصلوا إلى: طلب المطلب WHERE path LIKE '/1/3/_/' (أطفال 3 أطفال 3 سنوات)

كُلْ

ويضيف الكيان عموداً واحداً للمسار:

public class Comment
{
    public int Id { get; set; }
    public string Content { get; set; } = string.Empty;
    public string Author { get; set; } = string.Empty;
    public DateTime CreatedAt { get; set; }

    public int PostId { get; set; }
    public BlogPost Post { get; set; } = null!;

    // ========== MATERIALISED PATH ==========

    // The complete path from root to this node
    // Format: /ancestor1/ancestor2/.../thisNode/
    // Examples:
    //   Root comment: "/1/"
    //   Child of 1: "/1/5/"
    //   Grandchild: "/1/5/12/"
    //
    // The leading and trailing slashes make pattern matching easier:
    // - LIKE '/1/%' finds all descendants of 1 (includes /1/ itself)
    // - LIKE '/1/5/%' finds all descendants of 5 under 1
    public string Path { get; set; } = string.Empty;

    // We still keep ParentCommentId for:
    // 1. Quick "who is my parent" without parsing
    // 2. EF Core navigation properties
    // 3. Data integrity (can validate path matches parent relationship)
    public int? ParentCommentId { get; set; }
    public Comment? ParentComment { get; set; }
    public ICollection<Comment> Children { get; set; } = new List<Comment>();

    // ========== COMPUTED HELPERS ==========

    // Parse ancestors from path - not stored, computed on demand
    public IEnumerable<int> GetAncestorIds()
    {
        if (string.IsNullOrEmpty(Path)) yield break;

        // Split "/1/3/4/" into ["", "1", "3", "4", ""]
        var parts = Path.Split('/', StringSplitOptions.RemoveEmptyEntries);

        // Return all except the last (which is this node's ID)
        for (int i = 0; i < parts.Length - 1; i++)
        {
            if (int.TryParse(parts[i], out var id))
                yield return id;
        }
    }

    // Calculate depth from path
    public int GetDepth()
    {
        if (string.IsNullOrEmpty(Path)) return 0;
        // Count segments: "/1/3/4/" has 3 segments, depth is 2 (0-indexed from root)
        return Path.Split('/', StringSplitOptions.RemoveEmptyEntries).Length - 1;
    }
}

إف إف احتياطي

public class CommentConfiguration : IEntityTypeConfiguration<Comment>
{
    public void Configure(EntityTypeBuilder<Comment> builder)
    {
        builder.HasKey(c => c.Id);

        builder.Property(c => c.Content)
            .IsRequired()
            .HasMaxLength(10000);

        builder.Property(c => c.Author)
            .IsRequired()
            .HasMaxLength(200);

        // ========== PATH COLUMN ==========
        // Set a reasonable max length - this limits your tree depth
        // /1/12345/12346/12347/...
        // Each segment is up to ~7 chars (ID + slash), so 1000 chars ≈ 140 levels
        builder.Property(c => c.Path)
            .IsRequired()
            .HasMaxLength(1000);

        // Relationship to blog post
        builder.HasOne(c => c.Post)
            .WithMany(p => p.Comments)
            .HasForeignKey(c => c.PostId)
            .OnDelete(DeleteBehavior.Cascade);

        // Self-referencing (optional but useful)
        builder.HasOne(c => c.ParentComment)
            .WithMany(c => c.Children)
            .HasForeignKey(c => c.ParentCommentId)
            .OnDelete(DeleteBehavior.Restrict);

        // ========== INDEXES ==========

        // Standard indexes
        builder.HasIndex(c => c.PostId);
        builder.HasIndex(c => c.ParentCommentId);

        // PATH INDEX - Critical for performance!
        // This makes LIKE 'prefix%' queries efficient
        // PostgreSQL can use a B-tree index for prefix LIKE patterns
        // (but NOT for '%suffix' or '%contains%' patterns)
        builder.HasIndex(c => c.Path);

        // For PostgreSQL, a text_pattern_ops index is even better for LIKE:
        // CREATE INDEX ix_comments_path ON comments (path text_pattern_ops);
        // You may want to add this via a raw migration
    }
}

قاعدة بيانات

erDiagram
    COMMENT {
        int id PK
        string content
        string author
        datetime created_at
        int post_id FK
        int parent_comment_id FK "optional"
        string path "e.g. /1/3/7/"
    }

    BLOG_POST {
        int id PK
        string title
        string content
    }

    BLOG_POST ||--o{ COMMENT : "has"
    COMMENT ||--o{ COMMENT : "parent-child"

إدخال جديد

يتطلب إدراج بناء المسار من المسار:

public async Task<Comment> AddCommentAsync(
    int postId,
    int? parentId,
    string author,
    string content,
    CancellationToken ct = default)
{
    string path;

    if (parentId.HasValue)
    {
        // Get parent's path to extend it
        var parentPath = await context.Comments
            .Where(c => c.Id == parentId.Value)
            .Select(c => c.Path)
            .FirstOrDefaultAsync(ct);

        if (parentPath == null)
        {
            throw new InvalidOperationException($"Parent comment {parentId} not found");
        }

        // We need the ID first, so we'll update the path after saving
        // (Chicken-and-egg: path contains our ID, but we don't have ID until saved)

        var comment = new Comment
        {
            PostId = postId,
            ParentCommentId = parentId,
            Author = author,
            Content = content,
            CreatedAt = DateTime.UtcNow,
            Path = string.Empty  // Temporary - will update after save
        };

        context.Comments.Add(comment);
        await context.SaveChangesAsync(ct);

        // Now we have the ID - build the real path
        // Parent path "/1/3/" + our ID "7" = "/1/3/7/"
        comment.Path = $"{parentPath}{comment.Id}/";
        await context.SaveChangesAsync(ct);

        logger.LogInformation("Added comment {CommentId} with path {Path}", comment.Id, comment.Path);
        return comment;
    }
    else
    {
        // Root comment - path is just our ID
        var comment = new Comment
        {
            PostId = postId,
            ParentCommentId = null,
            Author = author,
            Content = content,
            CreatedAt = DateTime.UtcNow,
            Path = string.Empty  // Temporary
        };

        context.Comments.Add(comment);
        await context.SaveChangesAsync(ct);

        comment.Path = $"/{comment.Id}/";
        await context.SaveChangesAsync(ct);

        logger.LogInformation("Added root comment {CommentId} with path {Path}", comment.Id, comment.Path);
        return comment;
    }
}

إحصل على الأطفال المُوَجِّهين

استخدام العلاقة بين الوالدين والأطفال (احتفظنا بالوالدين CommentId للراحة):

public async Task<List<Comment>> GetChildrenAsync(int commentId, CancellationToken ct = default)
{
    // Option 1: Use ParentCommentId (simple, always works)
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.ParentCommentId == commentId)
        .OrderBy(c => c.CreatedAt)
        .ToListAsync(ct);

    // Option 2: Use path pattern (demonstrates path power)
    // var parentPath = await context.Comments
    //     .Where(c => c.Id == commentId)
    //     .Select(c => c.Path)
    //     .FirstOrDefaultAsync(ct);
    //
    // if (parentPath == null) return new List<Comment>();
    //
    // // Find paths that extend parent by exactly one segment
    // // Parent: /1/3/  Children: /1/3/X/ where X is one number
    // var childPathPattern = $"{parentPath}%";
    //
    // return await context.Comments
    //     .AsNoTracking()
    //     .Where(c => EF.Functions.Like(c.Path, childPathPattern)
    //              && c.Path != parentPath
    //              && c.ParentCommentId == commentId)  // Ensures immediate children only
    //     .ToListAsync(ct);
}

تحصل على جميع المنجّزات

هذا هو المكان الذي تشرق فيه المسارات المُتَوَجِّدة - تُوضّحُ المسارَ، لا قاعدة بيانات البحث المطلوبة:

public async Task<List<Comment>> GetAncestorsAsync(int commentId, CancellationToken ct = default)
{
    // Step 1: Get the path (single query)
    var path = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (string.IsNullOrEmpty(path))
        return new List<Comment>();

    // Step 2: Parse ancestor IDs from path
    // Path "/1/3/7/" -> split -> ["1", "3", "7"] -> take all but last -> [1, 3]
    var ancestorIds = path
        .Split('/', StringSplitOptions.RemoveEmptyEntries)
        .SkipLast(1)  // Exclude self
        .Select(int.Parse)
        .ToList();

    if (!ancestorIds.Any())
        return new List<Comment>();

    // Step 3: Fetch ancestors (single query, uses primary key index)
    var ancestors = await context.Comments
        .AsNoTracking()
        .Where(c => ancestorIds.Contains(c.Id))
        .ToListAsync(ct);

    // Step 4: Order by position in path (root first)
    return ancestorIds
        .Select(id => ancestors.First(a => a.Id == id))
        .ToList();
}

احصل على كل المنسوسات

استخدام مثل مع منفذ المسار:

public async Task<List<Comment>> GetDescendantsAsync(int commentId, CancellationToken ct = default)
{
    // Get the path first
    var path = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (string.IsNullOrEmpty(path))
        return new List<Comment>();

    // LIKE 'path%' finds all paths that START with this path
    // Path "/1/3/" matches "/1/3/", "/1/3/5/", "/1/3/5/9/", etc.
    // Using EF.Functions.Like for proper SQL generation
    return await context.Comments
        .AsNoTracking()
        .Where(c => EF.Functions.Like(c.Path, $"{path}%") && c.Id != commentId)
        .OrderBy(c => c.Path)  // Gives us depth-first order!
        .ToListAsync(ct);
}

احصل على مُنْسِسات مع تعمّد

يمكننا حساب العمق من المسار:

public async Task<List<CommentWithDepth>> GetDescendantsWithDepthAsync(
    int commentId,
    int? maxDepth = null,
    CancellationToken ct = default)
{
    var comment = await context.Comments
        .AsNoTracking()
        .FirstOrDefaultAsync(c => c.Id == commentId, ct);

    if (comment == null)
        return new List<CommentWithDepth>();

    var basePath = comment.Path;
    var baseDepth = basePath.Split('/', StringSplitOptions.RemoveEmptyEntries).Length;

    // Get all descendants
    var query = context.Comments
        .AsNoTracking()
        .Where(c => EF.Functions.Like(c.Path, $"{basePath}%") && c.Id != commentId);

    var descendants = await query.ToListAsync(ct);

    // Calculate relative depth and filter if needed
    var result = descendants
        .Select(d =>
        {
            var absoluteDepth = d.Path.Split('/', StringSplitOptions.RemoveEmptyEntries).Length;
            var relativeDepth = absoluteDepth - baseDepth;
            return new CommentWithDepth
            {
                Id = d.Id,
                Content = d.Content,
                Author = d.Author,
                CreatedAt = d.CreatedAt,
                PostId = d.PostId,
                ParentCommentId = d.ParentCommentId,
                Path = d.Path,
                Depth = relativeDepth
            };
        })
        .Where(d => !maxDepth.HasValue || d.Depth <= maxDepth.Value)
        .OrderBy(d => d.Path)
        .ToList();

    return result;
}

public class CommentWithDepth
{
    public int Id { get; set; }
    public string Content { get; set; } = string.Empty;
    public string Author { get; set; } = string.Empty;
    public DateTime CreatedAt { get; set; }
    public int PostId { get; set; }
    public int? ParentCommentId { get; set; }
    public string Path { get; set; } = string.Empty;
    public int Depth { get; set; }
}

احذف اصغر

مُرفق

public async Task DeleteSubtreeAsync(int commentId, CancellationToken ct = default)
{
    var path = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (string.IsNullOrEmpty(path))
    {
        throw new InvalidOperationException($"Comment {commentId} not found");
    }

    // Delete all comments whose path starts with this path
    // This includes the comment itself and ALL descendants
    var deleted = await context.Comments
        .Where(c => EF.Functions.Like(c.Path, $"{path}%"))
        .ExecuteDeleteAsync(ct);

    logger.LogInformation("Deleted {Count} comments with path prefix {Path}", deleted, path);
}

هذه هي العملية المكلفة للمسارات المادية - يجب علينا تحديث جميع المسارات:

public async Task MoveSubtreeAsync(
    int commentId,
    int newParentId,
    CancellationToken ct = default)
{
    await using var transaction = await context.Database.BeginTransactionAsync(ct);

    try
    {
        // Get the node being moved
        var comment = await context.Comments
            .FirstOrDefaultAsync(c => c.Id == commentId, ct);

        if (comment == null)
            throw new InvalidOperationException($"Comment {commentId} not found");

        // Get the new parent
        var newParent = await context.Comments
            .FirstOrDefaultAsync(c => c.Id == newParentId, ct);

        if (newParent == null)
            throw new InvalidOperationException($"New parent {newParentId} not found");

        // Prevent cycles: can't move under own descendant
        if (newParent.Path.StartsWith(comment.Path))
        {
            throw new InvalidOperationException("Cannot move a node under its own descendant");
        }

        var oldPath = comment.Path;
        var newPath = $"{newParent.Path}{comment.Id}/";

        // Get all descendants (including the node itself)
        var descendants = await context.Comments
            .Where(c => EF.Functions.Like(c.Path, $"{oldPath}%"))
            .ToListAsync(ct);

        // Update all paths by replacing the old prefix with the new one
        foreach (var descendant in descendants)
        {
            // Replace old path prefix with new one
            // Old: /1/3/7/  Node 7 moving under /2/
            // Node 7: /1/3/7/ -> /2/7/
            // Node 9 (child of 7): /1/3/7/9/ -> /2/7/9/
            descendant.Path = newPath + descendant.Path.Substring(oldPath.Length);
        }

        // Update the direct parent reference
        comment.ParentCommentId = newParentId;

        await context.SaveChangesAsync(ct);
        await transaction.CommitAsync(ct);

        logger.LogInformation("Moved subtree of {Count} nodes from {OldPath} to {NewPath}",
            descendants.Count, oldPath, newPath);
    }
    catch
    {
        await transaction.RollbackAsync(ct);
        throw;
    }
}

& & است السؤال

sequenceDiagram
    participant App as Application
    participant EF as EF Core
    participant DB as PostgreSQL

    Note over App,DB: Getting Ancestors (Path parsing)
    App->>EF: GetAncestorsAsync(commentId)
    EF->>DB: SELECT path FROM comments WHERE id = @id
    DB-->>EF: Path "/1/3/7/"
    Note over App: Parse path → [1, 3]
    EF->>DB: SELECT * FROM comments WHERE id IN (1, 3)
    DB-->>EF: Ancestor comments
    EF-->>App: List<Comment>

    Note over App,DB: Getting Descendants (LIKE query)
    App->>EF: GetDescendantsAsync(commentId)
    EF->>DB: SELECT path FROM comments WHERE id = @id
    DB-->>EF: Path "/1/3/"
    EF->>DB: SELECT * FROM comments WHERE path LIKE '/1/3/%'
    DB-->>EF: All descendants
    EF-->>App: List<Comment>

(أ)

□ العملية □ معقّد □ قاعدة بيانات أسئلة □ ملاحظات □ |-----------|------------|------------------|-------| (ب) تدرج الفقرة الفرعية (أ) و(ب) و(ب) و(ب) و(ب) و(ب) و(ب) و(ب) و(ب) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) و(ج) • الحصول على أطفال o O (1) o 1 o استخدام الأب/الوالد نَحْصلُ على أسلافِ o O(d) o 2 يَحْصلُ على المسارِ + جَلْبُ d الأسلافِ o (أ) الحصول على الأحفاد (س (1))* • ٢ / ٢ اعثر على المسار + مثل الاستفسار 1 □ تحديث مسارات السُلُل تُحذف الفقرة الفرعية من الفقرة □ سين (1)* (ي) 2 (ي) (ي) 2 (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي) (ي)

*مع فهرس صحيح على عمود

أولا - مقدمــة

مؤشر المسار حاسم الأهمية. بالنسبة لـ PostgresSQL، النظر في استخدام text_pattern_opsالتي تمكّن من الترسيب الكفء مثل الاستفسارات في الأماكن غير C:

-- Standard B-tree index (works for LIKE 'prefix%')
CREATE INDEX ix_comments_path ON comments (path);

-- Better for pattern matching in PostgreSQL
CREATE INDEX ix_comments_path_pattern ON comments (path text_pattern_ops);

إضافة هذا إلى النزوح:

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql(
        "CREATE INDEX ix_comments_path_pattern ON comments (path text_pattern_ops)");
}

أولاً - مقدمـة

(ب) أن يكون لمختلف المعاوضات ما يلي:

● شكل أمثلة على PRs cons |--------|---------|------|------| | /1/3/7/ □ هذه المادة □ استخدام المزيد من الحيز المكاني في هذه المادة □ | 1.3.7 □ PostgreSQL Ltree أسلوب TM Agrit، يعمل مع Ltrey ^ فترة تضارب مع الكسور العشرية □ | 1,3,7 □ يمكن أن تسبب فاصلة منفصلة عن فاصلة □ فاصلة بسيطة في البيانات مسائل □ | 001.003.007 □ نطاق معرف حدودي متسق، حيز نفايات قابل للفرز ومتسق، حيز النفايات □

الـ /id/ يوصى بالتشكيل مع الرصاص والقطع التتبعية للأسباب التالية:

  1. مثل أنماط العمل الصحيحة (/1/% 1 ف-4، 1 ف-3، 1 ف-3، 1 خ م، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م أ م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م أ م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م و، 1 م أ /1/ عُرف /10/)
  2. من السهل تقسيمها واخراجها
  3. مُقَرَّرَةً لرُقْع

بروات وكونس

▪ pros cons / |------|------| □ الأسلاف المتاحون عن طريق قطع الأشجار (لا استفسار) □ يتطلب تحريك الأشجار الفرعية تحديثا لجميع الأحفاد □ □ المسيّنات عبر اسئلة بسيطة مثل : « طول الطريق يحدّد عمق الشجرة □ Depth يمكن حسابه من المسار o التلاعب سترنغ له فوق o يمكن للاستفسارات أن تكون بطيئة دون مؤشر صحيح. ♪ جيد لجيل فتات الخبز ♪ الدرب يجب أن يبقى متزامنا مع الأباءCommentId ♪ □ عمود واحد إضافة عمود □ لا يمكن استخدام المعيار B-try لمطابقة الملحقين □

متى إلى استخدام المُوَمَزْدَ

مُنتفِد المسار متى:

  • الكسرات المحسّنة هي من المتطلبات المشتركة
  • الأسلاف يسألون عن الأسلاف أكثر من الورثة
  • يُحدّد عمق شجرة (لن يكون لديك 100 شجرة مستوى أعلى)
  • يُنَجُدُجُجُزُ
  • تريد بيانات التسلسل الهرمي لـ مصحح

مُحَجّد المسار متى:

  • كثيراً ما تقوم بتحريك الأشجار الفرعية (تحديث جميع المسارات مكلف)
  • يمكن ان تكون الاشجار عميقة جدا ( تصير الاوتار غير عملية )
  • تحتاج لمطابقة الكفاية (تجد كل الأشجار التي تنتهي في نمط)
  • أنت أكثر راحة مع لتري (PopstgresgresSQL محدد ولكن أكثر تفضيلا)

مقارنة بالمعتري (باللتر)

إذا كنت على الموقع الجزء الأول: الشارع بدلاً من ذلك، فالأشجار هي أساساً قاعدة بيانات بديلة، ومسار مجسد مفضّل مع ما يلي:

  • دعم الرقم القياسي للاستفسارات المتسمة بالكفاءة
  • مشغِّلي الإنشاءات (@>, <@, ~)، وما إلى ذلك(
  • دالات التشويش
  • مور مع

المقايضة هي قفل موقع PostgresGresSQL. لاحظ أن مقدّم مورِد Npggsql يدعم الآن عمليات دعم LINQ عـن شـرـر شـر LTree على الرغم من أن الـ CTEs لا تزال تتطلب الخام SQL.

السلسلة

Finding related posts...
logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.