PostgreSQL ltree

一个标签是一个字母数字字符和下划线的序列（例如，在 C 区域中允许字符A-Za-z0-9_）。 标签长度必须少于 256 字符。

例子： 42, Personal_Services

一个标签路径是由点号分隔的零个或者更多个标签的序列，例如L1.L2.L3，它表示一个从层次树的根到一个特定节点的路径。 一个标签路径的长度不能超过65535标签。

例子：Top.Countries.Europe.Russia

ltree模块提供多种数据类型：

注意：ltxtquery允许符号之间的空白，但是ltree和lquery不允许。

类型ltree有普通比较操作符 =、<>、 <、>、<=、>=。 比较会按照树遍历的顺序排序，一个节点的子女按照标签文本排序。另外，还有 表 F.13中显示的特殊操作符。

操作符<@、@>、 @以及~有类似的、 ^<@、^@>、^@、 ^~，只是它们不适用索引。它们只对测试目的有用。

可用的函数在表 F.14中。

ltree支持一些能加速上述操作符的索引类型：

这个例子使用下列数据（在源代码发布的contrib/ltree/ltreetest.sql文件中也有）：

CREATE TABLE test (path ltree);
INSERT INTO test VALUES ("Top");
INSERT INTO test VALUES ("Top.Science");
INSERT INTO test VALUES ("Top.Science.Astronomy");
INSERT INTO test VALUES ("Top.Science.Astronomy.Astrophysics");
INSERT INTO test VALUES ("Top.Science.Astronomy.Cosmology");
INSERT INTO test VALUES ("Top.Hobbies");
INSERT INTO test VALUES ("Top.Hobbies.Amateurs_Astronomy");
INSERT INTO test VALUES ("Top.Collections");
INSERT INTO test VALUES ("Top.Collections.Pictures");
INSERT INTO test VALUES ("Top.Collections.Pictures.Astronomy");
INSERT INTO test VALUES ("Top.Collections.Pictures.Astronomy.Stars");
INSERT INTO test VALUES ("Top.Collections.Pictures.Astronomy.Galaxies");
INSERT INTO test VALUES ("Top.Collections.Pictures.Astronomy.Astronauts");
CREATE INDEX path_gist_idx ON test USING GIST (path);
CREATE INDEX path_idx ON test USING BTREE (path);

现在，我们有一个表test，它被填充了描述下列层次的数据：

                        Top
                     /   |  
             Science Hobbies Collections
                 /       |              
        Astronomy   Amateurs_Astronomy Pictures
           /                              |
Astrophysics  Cosmology                Astronomy
                                        /  |    
                                 Galaxies Stars Astronauts

我们可以做继承：

ltreetest=> SELECT path FROM test WHERE path <@ "Top.Science";
                path
------------------------------------
 Top.Science
 Top.Science.Astronomy
 Top.Science.Astronomy.Astrophysics
 Top.Science.Astronomy.Cosmology
(4 rows)

这里是一些路径匹配的例子：

ltreetest=> SELECT path FROM test WHERE path ~ "*.Astronomy.*";
                     path
-----------------------------------------------
 Top.Science.Astronomy
 Top.Science.Astronomy.Astrophysics
 Top.Science.Astronomy.Cosmology
 Top.Collections.Pictures.Astronomy
 Top.Collections.Pictures.Astronomy.Stars
 Top.Collections.Pictures.Astronomy.Galaxies
 Top.Collections.Pictures.Astronomy.Astronauts
(7 rows)

ltreetest=> SELECT path FROM test WHERE path ~ "*.!pictures@.Astronomy.*";
                path
------------------------------------
 Top.Science.Astronomy
 Top.Science.Astronomy.Astrophysics
 Top.Science.Astronomy.Cosmology
(3 rows)

这里是一些全文搜索的例子：

ltreetest=> SELECT path FROM test WHERE path @ "Astro*% & !pictures@";
                path
------------------------------------
 Top.Science.Astronomy
 Top.Science.Astronomy.Astrophysics
 Top.Science.Astronomy.Cosmology
 Top.Hobbies.Amateurs_Astronomy
(4 rows)

ltreetest=> SELECT path FROM test WHERE path @ "Astro* & !pictures@";
                path
------------------------------------
 Top.Science.Astronomy
 Top.Science.Astronomy.Astrophysics
 Top.Science.Astronomy.Cosmology
(3 rows)

使用函数的路径构建：

ltreetest=> SELECT subpath(path,0,2)||"Space"||subpath(path,2) FROM test WHERE path <@ "Top.Science.Astronomy";
                 ?column?
------------------------------------------
 Top.Science.Space.Astronomy
 Top.Science.Space.Astronomy.Astrophysics
 Top.Science.Space.Astronomy.Cosmology
(3 rows)

我们可以通过常见一个在路径中指定位置插入标签的 SQL 函数来简化：

CREATE FUNCTION ins_label(ltree, int, text) RETURNS ltree
    AS "select subpath($1,0,$2) || $3 || subpath($1,$2);"
    LANGUAGE SQL IMMUTABLE;

ltreetest=> SELECT ins_label(path,2,"Space") FROM test WHERE path <@ "Top.Science.Astronomy";
                ins_label
------------------------------------------
 Top.Science.Space.Astronomy
 Top.Science.Space.Astronomy.Astrophysics
 Top.Science.Space.Astronomy.Cosmology
(3 rows)

有一些额外的扩展为 PL/Python 实现了ltree类型的转换。 这些扩展是ltree_plpythonu、ltree_plpython2u 以及ltree_plpython3u（PL/Python 命名习惯请见 第 45.1 节）。如果安装了这些转换并且在 创建函数时指定了它们，ltree值会被映射为 Python 列表（ 不过，当前并不支持逆向的转换）。