PostgreSQL's ltree-extension ger dig materialiserade vägar med databasen -native superkrafter M SK2 GiST-indexer, specialiserade operatörer som @> och <@, och kraftfull mönstermatchningM SK1 Om du är engagerad i PostgreSQL och vill ha den bästa hierarkisk queryprestentialen

goda nyheter: Den Npgsql EF Core-leverantör supporterar LINQ-översättningar för ltree-operationer via LTree typ. Du kan använda metoder som IsAncestorOf(), IsDescendantOf(), och MatchesLQuery() direkt i LINQ queries. Hursomhelst , EF Core supporterar inte än rekursiva CTEs, så duM SK3 kommer behöva råSQL för operationer som kräver dem | ( | som att bygga kompletta subträdresultat med beräknade djupar

Tack till Shay Rojanski för att peka ut LINQs översättningssystem!

Seri Navigation

• Del 1: Übersicht - Inleiding och jämförelse
• Del 1.1: Närliggande lista
• Del 1.2: Slutbrädan
• Del 1.3: Materialiserad väg
• Del 1.4: Nested Sets
• Del 1.5: ltree (den här artikeln )

---

Vad är ltree?

ltree är en PostgreSQL-extension som ger ett inhemskt datatyp för hierarkiska etikettspår Materialiserad väg med superkrafter - så förstår databasen strukturen och erbjuder optimerade operatörer , funktioner M SK2 och GiST-indexstöd

Istället för att behandla vägen som en dumma string och använda LIKE queries, PostgreSQL kan

• Använd specialiserade operatörer (@> för " är förfäder till ", <@ för " är avkomma från ")
• Applicera GiST-index för effektiva hierarkisk frågor
• Matcha mönster med wildcards (Top.*.Europe)
• Gör uppsatta operationer på vägar

Nyckelinsikten: ltree är det bästa av båda världarna - enkelheten i materialiserade vägar med databasen - inlägsna optimeringar

Ltree Path Format

Pather i ltree använder perioder som separatörer och alfanumeriska etiketter:

Top.Countries.Europe.UK
Top.Countries.Asia.Japan.Tokyo
Top.Products.Electronics.Computers.Laptops

Regler:

• Etiketter kan innehålla bokstäver, siffror , och understreck
• Etiketter är case-känsliga
• Max. etikettlängd är 256 tecken
• Max. väglängd är 65535 etiketter

För kommentarerssystem, vi ' använder IDs som etiketter 1.3.7 mening "bemerkning 7 under bemerkning

Att sätta upp ett träd

Först, aktivera uitbreidingen ( kräver databas-superanvändarens privileekter

CREATE EXTENSION IF NOT EXISTS ltree;

Eller via EF Core migration

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql("CREATE EXTENSION IF NOT EXISTS ltree");
}

Enhetens definition

Den Npgsql-provideren inkluderar LTree typ som kartlägger direkt till PostgreSQLs ltree och ger LINQs methods

using Microsoft.EntityFrameworkCore;

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!;

    // ========== LTREE PATH ==========

    // The hierarchical path in ltree format
    // Format: ancestor1.ancestor2.thisNode
    // Examples:
    //   Root comment: "1"
    //   Child of 1: "1.5"
    //   Grandchild: "1.5.12"
    //
    // Using the LTree type enables LINQ translations for ltree operators
    public LTree Path { get; set; }

    // Keep ParentCommentId for convenience
    public int? ParentCommentId { get; set; }
    public Comment? ParentComment { get; set; }
    public ICollection<Comment> Children { get; set; } = new List<Comment>();

    // ========== HELPER METHODS ==========

    // Helper to get depth - LTree has NLevel property for this
    public int GetDepth() => Path.NLevel - 1;

    public IEnumerable<int> GetAncestorIds()
    {
        var pathString = Path.ToString();
        if (string.IsNullOrEmpty(pathString)) yield break;

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

EF Core Konfiguration

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 ==========
        // The LTree type is automatically mapped to PostgreSQL's ltree type
        // by the Npgsql provider - no explicit column type needed
        builder.Property(c => c.Path)
            .IsRequired();

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

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

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

Lägg till GiST-indexen via migration:

protected override void Up(MigrationBuilder migrationBuilder)
{
    // GiST index for ltree - enables efficient @>, <@, and ~ operators
    migrationBuilder.Sql(
        "CREATE INDEX ix_comments_path_gist ON comments USING GIST (path)");

    // Alternative: B-tree index for exact match and sorting
    // migrationBuilder.Sql(
    //     "CREATE INDEX ix_comments_path_btree ON comments USING BTREE (path)");
}

ltree Operatörer

ltree ger kraftfulla operatörer. Npgsql EF Core Provider översätter LTree metoder för dessa operatörer:

Operatör			Meningen			LINQ-metoden	МSK3	SQL-exempla
@>	är förfader till ( består av)	ltree1.IsAncestorOf(ltree2)	'1.3'::ltree @> '1.3.7'::ltree → sant
<@	Är descendenten av ( som består av ltree1.IsDescendantOf(ltree2)	'1.3.7'::ltree <@ '1.3'::ltree → sant
~	matchar lquery-mönster	ltree.MatchesLQuery(pattern)	'1.3.7'::ltree ~ '1.*'::lquery → sant
@	matchar ltxtquery	ltree.MatchesLTxtQuery(query)	'1.3.7'::ltree @ '3 & 7'::ltxtquery → sant
||	Konkatenerade vägar			МSK2	använda strängkonkatenation	'1.3'::ltree || '7'::ltree → '1.3.7'
<, >, <=, >=	jämförelse	Standardoperatörer			Sortering

Aditionella LINQ-överlägsningsbara egenskaper och metoder:

• ltree.NLevel → nlevel(ltree) - antal etiketter i vägen
• ltree.Subtree(start, end) → subltree(ltree, start, end) - utpakningsriktning av etiketter
• ltree.Subpath(offset) → subpath(ltree, offset) - agtervoegsel från avset
• ltree.Subpath(offset, len) → subpath(ltree, offset, len) - understräng
• ltree.Index(subpath) → index(ltree, subpath) - hitta undervägsposition
• LTree.LongestCommonAncestor(ltree1, ltree2) → lca(ltree1, ltree2) - minst gemensam förfader

Operationer

Insert a New Comment

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
        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");

        // Create comment first to get the ID
        var comment = new Comment
        {
            PostId = postId,
            ParentCommentId = parentId,
            Author = author,
            Content = content,
            CreatedAt = DateTime.UtcNow,
            Path = string.Empty  // Temporary
        };

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

        // Build path: parentPath.newId
        // ltree uses periods as separators
        comment.Path = $"{parentPath}.{comment.Id}";
        await context.SaveChangesAsync(ct);

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

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

        comment.Path = comment.Id.ToString();
        await context.SaveChangesAsync(ct);

        return comment;
    }
}

få omedelbart barn

Att använda ParentCommentId (simple) eller att matcha ett trädmönster

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

// Option 2: Using ltree pattern (demonstration)
public async Task<List<Comment>> GetChildrenLtreeAsync(int commentId, CancellationToken ct = default)
{
    // Get parent path first
    var parentPath = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (parentPath == null)
        return new List<Comment>();

    // Children match pattern: parentPath.*{1}
    // The {1} means exactly one more label (immediate children only)
    var sql = @"
        SELECT * FROM comments
        WHERE path ~ ($1 || '.*{1}')::lquery
        ORDER BY created_at";

    return await context.Comments
        .FromSqlRaw(sql, parentPath)
        .AsNoTracking()
        .ToListAsync(ct);
}

få alla förfäder

Att använda LINQ med IsAncestorOf metod ( översätter till @> operator):

public async Task<List<Comment>> GetAncestorsAsync(int commentId, CancellationToken ct = default)
{
    var targetPath = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (targetPath == default)
        return new List<Comment>();

    // Find all nodes whose path is an ancestor of this path
    // Using IsAncestorOf which translates to @> operator
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.IsAncestorOf(targetPath) && c.Id != commentId)
        .OrderBy(c => c.Path.NLevel)
        .ToListAsync(ct);
}

få alla barnbarn

Att använda LINQ med IsDescendantOf metod ( översätter till <@ operator):

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

    if (parentPath == default)
        return new List<Comment>();

    // Find all nodes whose path is a descendant of this path
    // Using IsDescendantOf which translates to <@ operator
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.IsDescendantOf(parentPath) && c.Id != commentId)
        .OrderBy(c => c.Path)
        .ToListAsync(ct);
}

få barnbarn till max djup

Att använda LINQ med NLevel för djupbegränsning:

public async Task<List<Comment>> GetDescendantsToDepthAsync(
    int commentId,
    int maxDepth,
    CancellationToken ct = default)
{
    var comment = await context.Comments
        .FirstOrDefaultAsync(c => c.Id == commentId, ct);

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

    var basePath = comment.Path;
    var baseLevel = comment.Path.NLevel;

    // NLevel property translates to nlevel() function
    // Filter descendants within maxDepth levels
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.IsDescendantOf(basePath) 
                 && c.Id != commentId
                 && c.Path.NLevel - baseLevel <= maxDepth)
        .OrderBy(c => c.Path)
        .ToListAsync(ct);
}

// If you need the depth value in results, you can project it:
public async Task<List<CommentWithDepth>> GetDescendantsWithDepthAsync(
    int commentId,
    int maxDepth,
    CancellationToken ct = default)
{
    var comment = await context.Comments
        .FirstOrDefaultAsync(c => c.Id == commentId, ct);

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

    var basePath = comment.Path;
    var baseLevel = comment.Path.NLevel;

    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.IsDescendantOf(basePath) 
                 && c.Id != commentId
                 && c.Path.NLevel - baseLevel <= maxDepth)
        .OrderBy(c => c.Path)
        .Select(c => new CommentWithDepth
        {
            Id = c.Id,
            Content = c.Content,
            Author = c.Author,
            CreatedAt = c.CreatedAt,
            PostId = c.PostId,
            ParentCommentId = c.ParentCommentId,
            Path = c.Path.ToString(),
            Depth = c.Path.NLevel - baseLevel
        })
        .ToListAsync(ct);
}

Pattern matchande sökningar

ltree supporterar kraftfulla lquery-mönster. Använd MatchesLQuery i LINQ:

// Find all comments at exactly depth 2 under comment 1
public async Task<List<Comment>> GetAtDepthAsync(int commentId, int depth, CancellationToken ct = default)
{
    var path = await context.Comments
        .Where(c => c.Id == commentId)
        .Select(c => c.Path)
        .FirstOrDefaultAsync(ct);

    if (path == default) return new List<Comment>();

    // Pattern: path.*{depth} matches exactly 'depth' more levels
    var pattern = $"{path}.*{{{depth}}}";
    
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.MatchesLQuery(pattern))
        .OrderBy(c => c.Path)
        .ToListAsync(ct);
}

// Find all paths matching a pattern like "1.*.7" (any path through 1 ending in 7)
public async Task<List<Comment>> MatchPatternAsync(string pattern, CancellationToken ct = default)
{
    // MatchesLQuery translates to the ~ operator
    return await context.Comments
        .AsNoTracking()
        .Where(c => c.Path.MatchesLQuery(pattern))
        .OrderBy(c => c.Path)
        .ToListAsync(ct);
}

Lösa ett underträd

Du kan använda LINQ för att välja subträdet, och sen lösa:

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 (path == default)
        throw new InvalidOperationException($"Comment {commentId} not found");

    // Delete all descendants (nodes where path is descendant of this path)
    // Note: ExecuteDeleteAsync requires EF Core 7+
    var deleted = await context.Comments
        .Where(c => c.Path.IsDescendantOf(path))
        .ExecuteDeleteAsync(ct);

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

Flytta en underträd

ltree erbjuder Funktionen för att hjälpa med vägmanipulationen:

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

    try
    {
        var node = await context.Comments.FirstOrDefaultAsync(c => c.Id == commentId, ct);
        var newParent = await context.Comments.FirstOrDefaultAsync(c => c.Id == newParentId, ct);

        if (node == null || newParent == null)
            throw new InvalidOperationException("Node or parent not found");

        // Prevent cycles
        if (newParent.Path.StartsWith(node.Path))
            throw new InvalidOperationException("Cannot move under own descendant");

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

        // Update all descendants: replace old path prefix with new one
        // subpath(path, nlevel(oldPath)) gets the suffix after oldPath
        // We concatenate newPath with that suffix
        var sql = @"
            UPDATE comments
            SET path = $2::ltree || subpath(path, nlevel($1::ltree))
            WHERE path <@ $1::ltree";

        await context.Database.ExecuteSqlRawAsync(
            sql,
            new object[] { oldPath, newPath },
            ct);

        // Update parent reference
        node.ParentCommentId = newParentId;
        await context.SaveChangesAsync(ct);

        await transaction.CommitAsync(ct);

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

Ltree Funktionsreferens

PostgreSQL erbjuder många användbara ltree-funktionen:

Funktion	Beskrywing
nlevel(ltree)	Anzahl av etiketter	nlevel('1.3.7') → 3
subpath(ltree, offset)	Suffix från offset	subpath('1.3.7', 1) → '3.7'
subpath(ltree, offset, len)	Substring	subpath('1.3.7', 1, 1) → '3'
subltree(ltree, start, end)	Kollektion av etiketter	subltree('1.3.7', 0, 2) → '1.3'
lca(ltree, ltree)	Den lägsta gemensamma förfäderna	lca('1.3.7', '1.3.9') → '1.3'
text2ltree(text)	Konvertera text till lträd	text2ltree('1.3.7')
ltree2text(ltree)	Konvertera träd till text	ltree2text('1.3.7'::ltree)

Frågaflödet visualisering

sequenceDiagram
    participant App as Application
    participant EF as EF Core
    participant PG as PostgreSQL + ltree

    Note over App,PG: Getting Descendants (GiST index)
    App->>EF: GetDescendantsAsync(commentId)
    EF->>PG: SELECT path FROM comments WHERE id = @id
    PG-->>EF: Path "1.3"
    EF->>PG: SELECT * FROM comments WHERE path <@ '1.3'::ltree
    Note over PG: Uses GiST index - O(log n)
    PG-->>EF: All descendants
    EF-->>App: List<Comment>

    Note over App,PG: Pattern Match Query
    App->>EF: MatchPatternAsync("1.*.7")
    EF->>PG: SELECT * FROM comments WHERE path ~ '1.*.7'::lquery
    Note over PG: GiST index supports pattern matching
    PG-->>EF: Matching comments
    EF-->>App: List<Comment>

Förmågor och egenskaper

Operation	Kompleksitet			Notar
Insert	O(1)	Bara sätta in banansträng
få barn	O(1)	Pattern matchar GiST-indexet
få förfäder	O(1)			4	operatör med GiST-index
få barnbarn	O(1)		3	4	Operatör med GiST-index
Pattern matching	Olog nM SK3	GiST-indexet stödjer lquery M
Flytta subträdet	OsM SK3	uppdatera de efterföljande spåren SSK5
Lösna underträdet	O(1)

Med GiST-indexen, lträdsökningar är extremt effektiva - vanligtvis OM SK2log nMSC3 oberoende av trädbredd

För och mot

Fördelen	Motsägelser
Databasen-nativ optimering	PostgreSQL
GiST-index för alla hierarkiska frågor	Tillämpning till utlängningar
Att matcha kraftfulla mönster			Etiketter begränsade till alfanumeriska
Inbyggda -inriktade manipulationsfunktioner			Rekursiv CTE kräver rå SQL
OM SK1 förfader /descendande frågor			Mindre bärbar än ren EF Core
Kompaktladdon
Support för LINQ via Npgsql's LTree typ

När man ska använda ltree

Välj lträd när:

• Du' är engagerad i PostgreSQL
• Performance är avgörande för hierarkiska queryr
• Du behöver mönster som matchar (finn alla X.*.Y-vägar
• Du vill ha det bästa av materialiserade vägar
• Du vill ha LINQ support för de flesta hierarkiska operationer

Avoid ltree när:

• Du behöver databas förnybarhet (SQL Server , MySQL, etcM SK3
• Din grupp är inte bekanta med PostgreSQL-extensioner
• Etiketter behöver icke-alphanumeriska tecken
• Du behöver rekursiva CTEs och vill undvika råSQL

jämförelse med materialiserad väg

Aspect	Materialiserad väg	ltree
Indikationstyp	B-träde	(	bara förvoegseln	)		GiST	МSK6	alla mönster
Passande mönster	LIKE ♫ ♫ ' ♫ prefix ♫ %' ♫ bara ♫
Operatörer
Portability	Vilken databas som helst ♫	♫ Bara PostgreSQL ♫
EF Core support	Full LINQ ♫ ♫	♫ LTree typ (CTEs behöver råSQL
Performansen	Bra med index			Utmärkt med GiST
Funktioner			Ingen		handfull parsing

exempel: Full Comment Tree Query

När man lägger ihop allt det - får man en komplett kommenterad träd med djup för en bloggpost

public async Task<List<CommentTreeItem>> GetPostCommentTreeAsync(
    int postId,
    int maxDepth = 5,
    CancellationToken ct = default)
{
    // Get all comments for the post with calculated depth
    // nlevel() counts the labels in the path
    var sql = @"
        WITH root_comments AS (
            -- Find root comments for this post (no dot in path = root)
            SELECT path, nlevel(path) as root_level
            FROM comments
            WHERE post_id = $1 AND path !~ '*.*'
        )
        SELECT
            c.id,
            c.content,
            c.author,
            c.created_at,
            c.post_id,
            c.parent_comment_id,
            c.path::text as path,
            nlevel(c.path) - COALESCE(
                (SELECT root_level FROM root_comments r
                 WHERE c.path <@ r.path
                 ORDER BY nlevel(r.path) DESC LIMIT 1),
                nlevel(c.path)
            ) as depth
        FROM comments c
        WHERE c.post_id = $1
          AND nlevel(c.path) <= $2 + 1  -- +1 because depth is 0-indexed
        ORDER BY c.path";  -- Perfect depth-first order!

    return await context.Database
        .SqlQueryRaw<CommentTreeItem>(sql, postId, maxDepth)
        .ToListAsync(ct);
}

public class CommentTreeItem
{
    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; }
}

Seri Navigation

• Del 1: Übersicht
• Del 1.1: Närliggande lista
• Del 1.2: Slutbrädan
• Del 1.3: Materialiserad väg
• Del 1.4: Nested Sets
• Del 1.5: ltree (den här artikeln )

Vad's Nästa?

Den här serien har omfattat fem tillvägagångssätt för hierarkiska data med hjälp av EF Core. del | 2 | kommer att utforska användandet av rådata SQL och Dapper för ännu mer kontroll över hierarchiska queries