↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 运算符族 / GiST 操作符家族

gist/box_ops (family)

box_ops 是 gist 的运算符族。

当前查看 PostgreSQL 18。

中文定义与说明

box_ops 是 gist 的运算符族。

名称
box_ops
索引访问方法
gist

策略运算符

策略编号用途运算符左操作数类型右操作数类型排序运算符族
1搜索<<(box,box)boxbox
2搜索&<(box,box)boxbox
3搜索&&(box,box)boxbox
4搜索&>(box,box)boxbox
5搜索>>(box,box)boxbox
6搜索~=(box,box)boxbox
7搜索@>(box,box)boxbox
8搜索<@(box,box)boxbox
9搜索&<|(box,box)boxbox
10搜索<<|(box,box)boxbox
11搜索|>>(box,box)boxbox
12搜索|&>(box,box)boxbox
15排序<->(box,point)boxpointfloat_ops

支持函数

支持函数编号实现函数左操作数类型右操作数类型结果类型
1gist_box_consistent(internal,box,int2,oid,internal)boxboxbool
2gist_box_union(internal,internal)boxboxbox
5gist_box_penalty(internal,internal,internal)boxboxinternal
6gist_box_picksplit(internal,internal)boxboxinternal
7gist_box_same(box,box,internal)boxboxinternal
8gist_box_distance(internal,box,int2,oid,internal)boxboxfloat8
12gist_translate_cmptype_common(int4)anyanyint2

同版本中文手册节选

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

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

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

下面的查询会显示所有已定义的操作符类:

查看完整中文手册与上下文。

说明

box_ops 是 gist 的运算符族。

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

用法

gist/box_ops

操作符类与家族

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

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

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

家族中的操作符策略

操作符重载策略用途排序家族成员范围源码说明
<<(box,box)1搜索家族成员位于左侧
&<(box,box)2搜索家族成员重叠或位于左侧
&&(box,box)3搜索家族成员重叠
&>(box,box)4搜索家族成员重叠或位于右侧
>>(box,box)5搜索家族成员位于右侧
~=(box,box)6搜索家族成员相同
@>(box,box)7搜索家族成员包含
<@(box,box)8搜索家族成员被包含于
&<|(box,box)9搜索家族成员重叠或位于下方
<<|(box,box)10搜索家族成员位于下方
|>>(box,box)11搜索家族成员位于上方
|&>(box,box)12搜索家族成员重叠或位于上方
<->(box,point)15排序float_ops家族成员两者之间的距离

家族支持函数

支持函数编号左侧类型右侧类型函数签名返回类型
1boxboxgist_box_consistent(internal,box,int2,oid,internal)bool
2boxboxgist_box_union(internal,internal)box
5boxboxgist_box_penalty(internal,internal,internal)internal
6boxboxgist_box_picksplit(internal,internal)internal
7boxboxgist_box_same(box,box,internal)internal
8boxboxgist_box_distance(internal,box,int2,oid,internal)float8
12anyanygist_translate_cmptype_common(int4)int2

本家族的操作符类

操作符类输入类型键类型默认值
box_opsboxSame as input type是

相关条目

文档与源码

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

版本比较

PostgreSQL 13 → 14: 属性变化。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 13
+++ PostgreSQL 14
@@ -54,26 +54,6 @@
       "right_type": "box",
       "sort_family": "",
       "strategy": "12"
-    },
-    {
-      "family": "box_ops",
-      "left_type": "box",
-      "method": "gist",
-      "operator": "~(box,box)",
-      "purpose": "search",
-      "right_type": "box",
-      "sort_family": "",
-      "strategy": "13"
-    },
-    {
-      "family": "box_ops",
-      "left_type": "box",
-      "method": "gist",
-      "operator": "@(box,box)",
-      "purpose": "search",
-      "right_type": "box",
-      "sort_family": "",
-      "strategy": "14"
     },
     {
       "family": "box_ops",

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

相关条目

导出 JSON · 返回运算符族 · 收录范围为 PostgreSQL 10 至 20;最早采样版本不一定是实际引入版本。