ltree almacena una ruta de etiquetas.

lquery representa un patrón similar a una expresión regular para hacer coincidir valores de tipo ltree. Una palabra simple coincide con esa etiqueta dentro de una ruta. Un símbolo de estrella (*) coincide con cero o más etiquetas. Estos pueden unirse con puntos para formar un patrón que debe coincidir con toda la ruta de etiquetas. Por ejemplo:

foo         Coincidir exactamente con la ruta de etiquetas foo
*.foo.*     Coincidir con cualquier ruta de etiquetas que contenga la etiqueta foo
*.foo       Coincidir con cualquier ruta de etiquetas cuya última etiqueta sea foo

Tanto los símbolos de estrella como las palabras simples se pueden cuantificar para restringir cuántas etiquetas pueden coincidir:

*{n}        Coincidir exactamente con n etiquetas
*{n,}       Coincidir con al menos n etiquetas
*{n,m}      Coincidir con al menos n pero no más de m etiquetas
*{,m}       Coincidir a lo sumo con m etiquetas — lo mismo que *{0,m}
foo{n,m}    Coincidir con al menos n pero no más de m ocurrencias de foo
foo{,}      Coincidir con cualquier número de ocurrencias de foo, incluyendo cero

A falta de cualquier cuantificador explícito, el comportamiento predeterminado para un símbolo de estrella es coincidir con cualquier número de etiquetas (es decir, {,}), mientras que el predeterminado para un elemento que no sea estrella es coincidir exactamente una vez (es decir, {1}).

Existen varios modificadores que se pueden colocar al final de un elemento de tipo lquery que no sea estrella para que coincida con algo más que la coincidencia exacta:

@           Coincidir sin distinguir mayúsculas de minúsculas, por ejemplo a@ coincide con A
*           Coincidir con cualquier etiqueta que tenga este prefijo, por ejemplo foo* coincide con foobar
%           Coincidir con palabras iniciales separadas por guiones bajos

El comportamiento de % es un poco complicado. Intenta hacer coincidir palabras individuales en lugar de toda la etiqueta. Por ejemplo, foo_bar% coincide con foo_bar_baz pero no con foo_barbaz. Si se combina con *, la coincidencia de prefijos se aplica a cada palabra por separado; por ejemplo, foo_bar%* coincide con foo1_bar2_baz pero no con foo1_br2_baz.

También puedes escribir varios elementos que no sean estrellas (posiblemente modificados) separados por | (OR) para que coincidan con cualquiera de ellos, y puedes colocar ! (NOT) al inicio de un grupo que no sea estrella para coincidir con cualquier etiqueta que no coincida con ninguna de las alternativas. Si hay un cuantificador, se coloca al final del grupo; esto significa cierta cantidad de coincidencias para el grupo en su conjunto (es decir, cierta cantidad de etiquetas que coinciden o no coinciden con ninguna de las alternativas).

Aquí tienes un ejemplo anotado de lquery:

Top.*{0,2}.sport*@.!football|tennis{1,}.Russ*|Spain
a.  b.     c.      d.                   e.

Esta consulta coincidirá con cualquier ruta de etiquetas que:

ltxtquery representa un patrón similar al de búsqueda de texto completo para hacer coincidir valores de tipo ltree. Un valor de tipo ltxtquery contiene palabras, posiblemente con los modificadores @, *, % al final; los modificadores tienen el mismo significado que en lquery. Las palabras se pueden combinar con & (AND), | (OR), ! (NOT) y paréntesis. La diferencia clave con respecto a lquery es que ltxtquery busca coincidir con palabras sin importar su posición en la ruta de etiquetas.

Aquí tienes un ejemplo de ltxtquery:

Europe & Russia*@ & !Transportation

Esto coincidirá con rutas que contengan la etiqueta Europe y cualquier etiqueta que comience con Russia (sin distinguir mayúsculas de minúsculas), pero no con rutas que contengan la etiqueta Transportation. La ubicación de estas palabras dentro de la ruta no es importante. Además, cuando se usa %, la palabra puede coincidir con cualquier palabra separada por guiones bajos dentro de una etiqueta, independientemente de su posición.

Índice B-tree sobre ltree: <, <=, =, >=, >

Índice Hash sobre ltree: =

Índice GiST sobre ltree (clase de operador gist_ltree_ops): <, <=, =, >=, >, @>, <@, @, ~, ?

La clase de operador GiST gist_ltree_ops aproxima un conjunto de etiquetas de ruta como una firma de mapa de bits. Su parámetro entero opcional siglen determina la longitud de la firma en bytes. La longitud de firma por defecto es 8 bytes. La longitud debe ser un múltiplo positivo de la alineación de int (4 bytes en la mayoría de las máquinas) hasta 2024. Las firmas más largas conducen a una búsqueda más precisa (escaneando una fracción más pequeña del índice y menos páginas de almacenamiento), a costa de un índice más grande.

Ejemplo de creación de dicho índice con la longitud de firma predeterminada de 8 bytes:

CREATE INDEX path_gist_idx ON test USING GIST (path);

Ejemplo de creación de dicho índice con una longitud de firma de 100 bytes:

CREATE INDEX path_gist_idx ON test USING GIST (path gist_ltree_ops(siglen=100));

Índice GiST sobre ltree[] (clase de operador gist__ltree_ops): ltree[] <@ ltree, ltree @> ltree[], @, ~, ?

La clase de operador GiST gist__ltree_ops funciona de manera similar a gist_ltree_ops y también toma la longitud de la firma como parámetro. El valor por defecto de siglen en gist__ltree_ops es 28 bytes.

Ejemplo de creación de dicho índice con la longitud de firma predeterminada de 28 bytes:

CREATE INDEX path_gist_idx ON test USING GIST (array_path);

Ejemplo de creación de dicho índice con una longitud de firma de 100 bytes:

CREATE INDEX path_gist_idx ON test USING GIST (array_path gist__ltree_ops(siglen=100));

Nota: Este tipo de índice es con pérdida (lossy).