<type>ltree</type> stores a label path. ltreeはラベル経路を格納します。

<type>lquery</type> represents a regular-expression-like pattern for matching <type>ltree</type> values. A simple word matches that label within a path. A star symbol (<literal>*</literal>) matches zero or more labels. These can be joined with dots to form a pattern that must match the whole label path. For example: lqueryは、ltree値に一致する正規表現のようなパターンを表現します。 単一の単語は経路内のラベルに一致します。 スター記号（*）は0個以上のラベルに一致します。 ドットでつなげることで、ラベル経路全体に一致するパターンを形作ることができます。 以下に例を示します。

foo         <lineannotation>Match the exact label path <literal>foo</literal></lineannotation>
*.foo.*     <lineannotation>Match any label path containing the label <literal>foo</literal></lineannotation>
*.foo       <lineannotation>Match any label path whose last label is <literal>foo</literal></lineannotation>

foo         正確にfooというラベル経路に一致します。
*.foo.*     fooというラベルを含むラベル経路すべてに一致します。
*.foo       fooというラベルで終わるラベル経路すべてに一致します。

Both star symbols and simple words can be quantified to restrict how many labels they can match: スター記号と単一の単語のどちらも一致可能なラベル数を制限するために量指定を行うことができます。

*{<replaceable>n</replaceable>}        <lineannotation>Match exactly <replaceable>n</replaceable> labels</lineannotation>
*{<replaceable>n</replaceable>,}       <lineannotation>Match at least <replaceable>n</replaceable> labels</lineannotation>
*{<replaceable>n</replaceable>,<replaceable>m</replaceable>}      <lineannotation>Match at least <replaceable>n</replaceable> but not more than <replaceable>m</replaceable> labels</lineannotation>
*{,<replaceable>m</replaceable>}       <lineannotation>Match at most <replaceable>m</replaceable> labels &mdash; same as </lineannotation>*{0,<replaceable>m</replaceable>}
foo{<replaceable>n</replaceable>,<replaceable>m</replaceable>}    <lineannotation>Match at least <replaceable>n</replaceable> but not more than <replaceable>m</replaceable> occurrences of <literal>foo</literal></lineannotation>
foo{,}      <lineannotation>Match any number of occurrences of <literal>foo</literal>, including zero</lineannotation>

*{n}        正確にn個のラベルに一致します。
*{n,}       少なくともn個のラベルに一致します。
*{n,m}      少なくともn個に一致し、多くてもm個を超えないラベルに一致します。
*{,m}       最大m個のラベルに一致します。つまりと次と同じです。*{0,m}
foo{n,m}    少なくともn個に一致し、多くてもm個を超えないfooに一致します。
foo{,}      ゼロを含む任意の数のfooに一致します。

In the absence of any explicit quantifier, the default for a star symbol is to match any number of labels (that is, <literal>{,}</literal>) while the default for a non-star item is to match exactly once (that is, <literal>{1}</literal>). 明示的な量指定子が存在しなければ、スター記号に対するデフォルトは任意の数のラベルに一致(つまり{,})である一方、非スター項目に対するデフォルトは正確に1回(つまり{1})です。

There are several modifiers that can be put at the end of a non-star <type>lquery</type> item to make it match more than just the exact match: 単なる正確な一致以上の一致を行うために、スターでないlquery項目の終端に記述できる複数の修飾子が存在します。

@           <lineannotation>Match case-insensitively, for example <literal>a@</literal> matches <literal>A</literal></lineannotation>
*           <lineannotation>Match any label with this prefix, for example <literal>foo*</literal> matches <literal>foobar</literal></lineannotation>
%           <lineannotation>Match initial underscore-separated words</lineannotation>

@           大文字小文字を区別しない一致。例えばa@はAに一致します。
*           この接頭辞を持つすべてのラベルに一致。例えばfoo*はfoobarに一致します。
%           最初のアンダースコアで区切られた単語に一致。

The behavior of <literal>%</literal> is a bit complicated. It tries to match words rather than the entire label. For example <literal>foo_bar%</literal> matches <literal>foo_bar_baz</literal> but not <literal>foo_barbaz</literal>. If combined with <literal>*</literal>, prefix matching applies to each word separately, for example <literal>foo_bar%*</literal> matches <literal>foo1_bar2_baz</literal> but not <literal>foo1_br2_baz</literal>. %の動作は多少複雑です。 ラベル全体ではなく単語一致を試みます。 例えばfoo_bar%はfoo_bar_bazに一致しますがfoo_barbazに一致しません。 *と組み合わせる場合、接頭辞一致が各単語ごとに適用されます。 例えばfoo_bar%*はfoo1_bar2_bazに一致しますが、foo1_br2_bazに一致しません。

Also, you can write several possibly-modified non-star items separated with <literal>|</literal> (OR) to match any of those items, and you can put <literal>!</literal> (NOT) at the start of a non-star group to match any label that doesn't match any of the alternatives. A quantifier, if any, goes at the end of the group; it means some number of matches for the group as a whole (that is, some number of labels matching or not matching any of the alternatives). また、項目のいずれかに一致させるために|（論理和）で区切って、修飾子が付いているかもしれない複数の非スター項目を記述することもできます。 さらに、非スターグループ先頭に! (否定)を記述して選択肢のいずれにも一致しないすべてのラベルに一致させることもできます。 もしあれば、量指定子はグループの最後になります。これはグループ全体として一致する数を意味します(すなわち、一致するラベルの数、または、選択肢のいずれにも一致しない数です)。

Here's an annotated example of <type>lquery</type>: 以下に注釈付きのlqueryの例を示します。

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

This query will match any label path that: この問い合わせは以下のようなラベルに一致します。

ltxtqueryはltree値に対する全文検索のようなパターンを表します。 ltxtquery値は、おそらく最後に@、*、%修飾子を持った単語からなります。 修飾子の意味はlqueryと同じです。 単語は& (論理積)、| (論理和)、! (否定)、括弧を組み合わせることが可能です。 主なlqueryとの違いは、ltxtqueryはラベル経路上の位置を考慮せずに単語に一致することです。

Here's an example <type>ltxtquery</type>: ltxtqueryの例を示します。

Europe & Russia*@ & !Transportation

This will match paths that contain the label <literal>Europe</literal> and any label beginning with <literal>Russia</literal> (case-insensitive), but not paths containing the label <literal>Transportation</literal>. The location of these words within the path is not important. Also, when <literal>%</literal> is used, the word can be matched to any underscore-separated word within a label, regardless of position. これはEuropeラベルとRussia（大文字小文字の区別無）から始まるラベルを含む経路に一致します。 しかし、Transportationラベルを含む経路は一致しません。 経路内の単語の位置は重要ではありません。 また、%が使用された場合、位置に関係なく、単語をラベル内のアンダースコアで区切られた何らかの単語に一致させることができます。

B-tree index over <type>ltree</type>: <literal>&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, <literal>&gt;</literal> ltreeに対するB-treeインデックス：<、<=、=、>=、>

GiST index over <type>ltree</type> (<literal>gist_ltree_ops</literal> opclass): <literal>&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, <literal>&gt;</literal>, <literal>@&gt;</literal>, <literal>&lt;@</literal>, <literal>@</literal>, <literal>~</literal>, <literal>?</literal> ltreeに対するGiSTインデックス(gist_ltree_ops演算子クラス)： <、<=、=、>=、>、@>、<@、@、~、?

<literal>gist_ltree_ops</literal> GiST opclass approximates a set of path labels as a bitmap signature. Its optional integer parameter <literal>siglen</literal> determines the signature length in bytes. The default signature length is 8 bytes. The length must be a positive multiple of <type>int</type> alignment (4 bytes on most machines)) up to 2024. Longer signatures lead to a more precise search (scanning a smaller fraction of the index and fewer heap pages), at the cost of a larger index. gist_ltree_ops GiST演算子クラスは経路ラベルの集合をビットマップ署名として近似します。 オプションの整数パラメータsiglenは、署名の長さをバイト単位で決定します。 デフォルトの署名の長さは8バイトです。 長さは、int整列(ほとんどのマシンで4バイト)の正の倍数であり、最大で2024であることが必要です。 長い署名では、インデックスはより大きくなってしまいますが、(インデックスのより小さな部分とより少ないヒープページを走査することで)検索がより正確になります。

Example of creating such an index with the default signature length of 8 bytes: デフォルトの署名の長さが8バイトのインデックスを作成する例。

CREATE INDEX path_gist_idx ON test USING GIST (path);

Example of creating such an index with a signature length of 100 bytes: 署名の長さが100バイトのインデックスを作成する例。

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

GiST index over <type>ltree[]</type> (<literal>gist__ltree_ops</literal> opclass): <literal>ltree[] &lt;@ ltree</literal>, <literal>ltree @&gt; ltree[]</literal>, <literal>@</literal>, <literal>~</literal>, <literal>?</literal> ltree[]に対するGiSTインデックス（gist__ltree_ops演算子クラス）：ltree[] <@ ltree、ltree @> ltree[]、@、~、?

<literal>gist__ltree_ops</literal> GiST opclass works similarly to <literal>gist_ltree_ops</literal> and also takes signature length as a parameter. The default value of <literal>siglen</literal> in <literal>gist__ltree_ops</literal> is 28 bytes. gist__ltree_ops GiST演算子クラスはgist_ltree_opsと同じように動作しますが、署名の長さをパラメータとして取ります。 gist__ltree_opsでのsiglenのデフォルトの値は28バイトです。

Example of creating such an index with the default signature length of 28 bytes: デフォルトの署名の長さが28バイトのインデックスを作成する例。

CREATE INDEX path_gist_idx ON test USING GIST (array_path);

Example of creating such an index with a signature length of 100 bytes: 署名の長さが100バイトのインデックスを作成する例。

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

Note: This index type is lossy. 注意：この種類のインデックスは非可逆です。