gin/jsonb_path_ops (family)

GIN 操作符家族 containing 1 classes, 3 operator strategies and 5 support functions in this source build。

当前查看 PostgreSQL 18.6。

说明

GIN 操作符家族 containing 1 classes, 3 operator strategies and 5 support functions in this source build。

对象种类: 操作符家族
索引访问方法: GIN

用法

gin/jsonb_path_ops

操作符类与家族

一个索引定义可以为索引的每一列指定一个操作符类。

操作符类标识该索引在该列上要使用哪些操作符。例如，类型 int4 上的一个 B-树索引会使用 int4_ops 类；这个操作符类包含对 int4 值进行比较所需的函数。实践中，列数据类型的默认操作符类通常已经足够。之所以存在操作符类，主要是因为对某些数据类型来说，可能存在多种有意义的索引行为。例如，我们可能希望按绝对值排序一种复数数据类型，也可能希望按实部排序。我们可以通过为该数据类型定义两个操作符类，并在创建索引时选择合适的那个来做到这一点。操作符类决定了基础排序顺序（之后还可以通过添加排序选项 COLLATE 、 ASC / DESC 和/或 NULLS FIRST / NULLS LAST 来修改）。

除了默认操作符类之外，还有一些内置操作符类：

专题手册说明

非默认的 GIN 操作符类 jsonb_path_ops 不支持键存在操作符，但支持 @> 、 @? 和 @@ 。使用此操作符类创建索引的例子如下：

对于这些运算符，GIN 索引会从 jsonpath 模式中提取 accessors_chain == constant 形式的子句，并根据其中提到的键和值进行索引搜索。访问器链可以包含 . key、[*] 和 [ index ] 访问器。jsonb_ops 运算符类还支持 .* 和 .** 访问器，而 jsonb_path_ops 运算符类不支持。

虽然 jsonb_path_ops 操作符类只支持带有 @> 、 @? 和 @@ 操作符的查询，但相较于默认操作符类 jsonb_ops ，它具有显著的性能优势。 jsonb_path_ops 索引通常比相同数据上的 jsonb_ops 索引小得多，而且搜索也更有针对性，尤其是在查询中包含数据里频繁出现的键时。因此，搜索操作通常比使用默认操作符类时性能更佳。

jsonb_ops 与 jsonb_path_ops GIN 索引之间的技术差异在于，前者会为数据中的每个键和值分别创建独立的索引项，而后者只会为数据中的每个值创建索引项。 [7] 基本上，每个 jsonb_path_ops 索引项都是该值连同通向该值的键一起计算出的 hash。例如，要索引 {"foo": {"bar": "baz"}} ，会创建一个单独的索引项，其 hash 值中同时纳入 foo 、 bar 和 baz 这三者。因此，查找这一结构的包含查询会得到一次非常精确的索引搜索；但完全没有办法据此找出 foo 是否作为键出现。另一方面， jsonb_ops 索引会分别创建三个索引项来表示 foo 、 bar 和 baz ；然后为了执行包含查询，它会查找包含这三个项的行。尽管 GIN 索引可以相当高效地执行这种 AND 搜索，但它仍然会比等效的 jsonb_path_ops 搜索更不精确、也更慢，尤其是在包含这三个索引项中任意一个的行数非常多时。

jsonb_path_ops 方法的一个缺点是，它不会为不包含任何值的 JSON 结构产生索引项，例如 {"a": {}} 。如果请求查找包含此类结构的文档，就需要执行一次全索引扫描，这会相当慢。因此， jsonb_path_ops 并不适合经常执行此类搜索的应用。

家族中的操作符策略

操作符重载	策略	用途	成员范围	源码说明
@>(jsonb,jsonb)	7	搜索	家族成员	包含
@?(jsonb,jsonpath)	15	搜索	家族成员	jsonpath 存在性检查
@@(jsonb,jsonpath)	16	搜索	家族成员	jsonpath 匹配

家族支持函数

支持函数编号	左侧类型	右侧类型	函数签名	返回类型
1	jsonb	jsonb	btint4cmp(int4,int4)	int4
2	jsonb	jsonb	gin_extract_jsonb_path(jsonb,internal,internal)	内部
3	jsonb	jsonb	gin_extract_jsonb_query_path(jsonb,internal,int2,internal,internal,internal,internal)	内部
4	jsonb	jsonb	gin_consistent_jsonb_path(internal,int2,jsonb,int4,internal,internal,internal,internal)	bool
6	jsonb	jsonb	gin_triconsistent_jsonb_path(internal,int2,jsonb,int4,internal,internal,internal)	char

本家族的操作符类

操作符类	输入类型	键类型	默认值
jsonb_path_ops	jsonb	int4	否

文档与源码

来源构建

版本: 18.6
构建: https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
来源指纹: 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

版本比较

PostgreSQL 17 → 18: 无变化。

比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。

快速链接