# Ієрархії даних - частина 1.3: Матеріалізований шлях з ядром EF

<!--category-- Entity Framework, PostgreSQL, EF Hierarchies -->
<datetime class="hidden">2025-12-06T09:30</datetime>

Материалізовані шляхи зберігають повну давність як обмежену стрічку -, як `/1/3/7/` - зробить предків миттєво читаними без будь-яких з 'єднувань . Чудово для генерації хлібних хробаків та людини M SK2 читабельне виправлення МSK3 хоча рух піддербів означає оновлення кожного потомка

## Навігація серії

- [Частина 1: Обзор](/blog/efcore-hierarchical-data) - Вprowadzenie та порівняння
- [Частина 1.1: Допомічник](/blog/efcore-hierarchical-data-adjacency)
- [Частина 1.2: Закривальний стіл](/blog/efcore-hierarchical-data-closure)
- **Частина 1.3: Матеріалізований шлях** (таков artykułМSK1
- [Частина 1.4: Насаджені набіри](/blog/efcore-hierarchical-data-nested)
- [Частина 1.5: ltree](/blog/efcore-hierarchical-data-ltree)

---


## Що таке матеріалізований шлях?

Матеріалізована схема маршруту ( також називається "Enumeration Path МSK2 в [Дерево і єрархії Джо Селко](https://www.amazon.com/Hierarchies-Smarties-Kaufmann-Management-Systems/dp/0123877334)) зберігає повну давність кожного вузла як обмежену стрічку - так само, як файловий шлях чи поштовий адрес

Подумайте про те, як зберігати повну URL замість простого ім 'я сторінки. Путь `/blog/posts/2024/my-article` вказує вам, де ви знаходитесь в ієрархії.

**Ключеві ідеї:** Ми'ре складність торгових запитів для резервуарної зайнятості . пращур денормований у кожному рядку M SK2, але це робить питання про пращурів банальними МSK3 просто розшифровуйте стрічку .

[TOC]

## Концепція візуализована

```mermaid
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
```

Path is self-describing

- **Читання предків:** Розібрати `/1/3/4/` → предки [1, 3, 4]
- **Вишукання потомків:** Запитання `WHERE path LIKE '/1/3/%'` → отримує все під вузлом МSK1
- **Вирахунки глибини:** Перерахуйте розділювачів мінус один.
- **Знайти братів і сестер:** Запитання `WHERE path LIKE '/1/3/_/'` (посередні діти

## Визначення об 'єкту

Ця сутність додає одну колону Трохи:

```csharp
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;
    }
}
```

## Конфігурація ядра EF

```csharp
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
    }
}
```

## Карта бази даних

```mermaid
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"
```

## Операції

### Вsert a New Comment

Введення потребує побудови маршруту з батьківського'шогоM SK1

```csharp
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;
    }
}
```

### Отримайте безпосередні діти

Використовуючи батьківський зв 'язок

```csharp
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);
}
```

### Візьміть усіх пращурів

Це місце, де виділяються матеріалізовані шляхи - розшифровує шлях , не потрібні пошуки бази даних

```csharp
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();
}
```

### Візьміть усіх дітей

Використовуйте LIKE з префиксом маршруту:

```csharp
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);
}
```

### Добивати дітей з глибиною

Ми можемо обчислити глибину з шляху:

```csharp
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; }
}
```

### Утворити піддерево

Простий із співпадінням маршруту:

```csharp
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);
}
```

### Переміщувати піддерево

Це дорога операція для матеріалізованих шляхів - ми повинні модернізувати всі послідовні шляхи :

```csharp
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;
    }
}
```

## Візуалізація потоку запитів

```mermaid
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>
```

## Характеристики ефективності

| Операція МSK1 Сложність МSK2 Попити на бази даних | Примітки M|
|-----------|------------|------------------|-------|
| Вставляйте | OM SK2 МSK3 \2 || |Вставляєте МSK6 шлях оновлення | |
| Приймайте дітей МSK1 OM SK2 МSK3 ♫ ♫ 1 | ♫ 5 ♫ Використовуйте ParentCommentId index ♫
| Візьміть предків | OM SK2d МSK4 ♫ ♫ МSK5 ♫ | ♫ Перейти шлях ♫+ ♫ перейти d предков ♫
| Добивати потомків | OM SK2* | ♫ ♫ 2 ♫
| Переміщайте піддерево | OM SK2s МSK4 \1 | | Обновляйте послідовні шляхи МSK7
| Поletes subtree* | МSK1 ♫ ♫ МSK2 ♫ Прийти шлях ♫ + ♫ видалити велику кількість ♫

*З відповідним індексом на столбці маршруту

## Розглядання індексу

Індекс маршруту критичний. Для PostgreSQL, візьміть до уваги використання [`text_pattern_ops`](https://www.postgresql.org/docs/current/indexes-opclass.html),, що дозволяє виконувати практикові LIKE-запроси в неможливихM SK1C локаях:

```sql
-- 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);
```

Dodaj це за допомогою міграції:

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

## Розглядання формату маршруту

Різні деlimitери мають торгівлю-offsM SK1

| Формат МSK1 Приклад МSK2 Преподобання | Загнічення мSK4
|--------|---------|------|------|
| `/1/3/7/` | Цей artykuł МSK1 ВиczyśćM SK2 URL- подібноMSC4 легке розшифровування
| `1.3.7` | سبک ltree PostgreSQL | Компактна МSK2 працює з ltree
| `1,3,7` | Кома
| `001.003.007` | фіксованийM SK1широта МSK2 сортованийМ SK3 послідовний МSK4 обмеження діапазону ID , простір для відходів M|

І `/id/` формат з провідними та відштовхованими стрічками рекомендується, тому що

1. Моделі LIKE працюють правильно (`/1/%` збігів `/1/` але не `/10/`)
2. Легко розділяти та аналізувати
3. Людський-читаний для виправлення

## Привілеї та мінуси

| Преподобання МSK1 Загнічення |
|------|------|
| Ансестори доступні шляхом аналізу МSK1без запитуM SK2 МSK3 Переміщення піддербів вимагає оновлення усіх потомків |
| Descendants via simple LIKE query
| Глубина, яку можна обчислити з шляху | Маніпуляція струн має поверхневу поверхню МSK2
| Людська - читабельна для відладки МSK2 Які питання можуть бути повільними без відповідного індексу МSK3
| Чудово для генерації хлібних кромиків | Путь має бути синхронним з rodzicом
| Доdanie одного столбца МSK1 Може МSK2 не використовувати стандартну дереву B - для підсумку мSK4

## Коли використовувати матеріалізований шлях

**Виберите матеріалізований шлях, коли:**

- Хлебові пластинки - це поширена норма
- Про предків запитують частіше, ніж про потомків
- Глубина дерева обмежена. ( ви виграли ' не маєте МSK2 дерева на рівні
- Рух підземних дерев рідкісний
- Ви хочете людських-читаних ієрархічних даних для розладів

**Уникніть матеріалізованої дороги, коли:**

- Ви часто переміщуєте піддерби. (Aktualізація всіх шляхів дорого коштує.
- Дерева можуть бути дуже глибокими. (стрічки маршруту стають неважкими
- Потрібно ефективне поєднання суффиксів (найти всі дерева, що закінчуються у візерункуM SK1
- Ви' почуваєтесь більш комфортно з ltree M SK1PostgreSQL-спеціальне, але більш оптимізоване )

## Порівняння з деревом

Якщо ви знаходитеся на PostgreSQL [Частина 1.5: ltree](/blog/efcore-hierarchical-data-ltree) замість. ltree є, по суті, базою даних

- Індекс GiST для ефективних запитів
- Вбудовані оператори -`@>`, `<@`, `~`, і т.д.
- Функції маніпуляції шляхом
- Модель, яка підходить до диких карт

Торгівля "-" - це постгреSQL замок МSK1 в мск2 . Зверніть увагу, що [Поставник Npgsql тепер підтримує переклади LINQ](https://www.npgsql.org/efcore/mapping/translations.html#ltree-functions) для Ltree через `LTree` тип, хоча рекурсивні CTE все ще потребують сирого SQL.

## Навігація серії

- [Частина 1: Обзор](/blog/efcore-hierarchical-data)
- [Частина 1.1: Допомічник](/blog/efcore-hierarchical-data-adjacency)
- [Частина 1.2: Закривальний стіл](/blog/efcore-hierarchical-data-closure)
- **Частина 1.3: Матеріалізований шлях** (таков artykułМSK1
- [Частина 1.4: Насаджені набіри](/blog/efcore-hierarchical-data-nested)
- [Частина 1.5: ltree](/blog/efcore-hierarchical-data-ltree)