gist/circle_ops (class)

circle 类型的 GiST 操作符类，属于 circle_ops 家族。

当前查看 PostgreSQL 18.6。

说明

circle 类型的 GiST 操作符类，属于 circle_ops 家族。

对象种类: 操作符类
索引访问方法: GiST
输入类型: circle
存储键类型: box
默认操作符类: 是

用法

gist/circle_ops

操作符类与家族

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

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

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

家族中的操作符策略

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

家族支持函数

支持函数编号	左侧类型	右侧类型	函数签名	返回类型
1	circle	circle	gist_circle_consistent(internal,circle,int2,oid,internal)	bool
2	circle	circle	gist_box_union(internal,internal)	box
3	circle	circle	gist_circle_compress(internal)	内部
5	circle	circle	gist_box_penalty(internal,internal,internal)	内部
6	circle	circle	gist_box_picksplit(internal,internal)	内部
7	circle	circle	gist_box_same(box,box,internal)	内部
8	circle	circle	gist_circle_distance(internal,circle,int2,oid,internal)	float8
12	any	any	gist_translate_cmptype_common(int4)	int2

本家族的操作符类

操作符类	输入类型	键类型	默认值
circle_ops	circle	box	是

文档与源码

来源构建

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

版本比较

PostgreSQL 17 → 18: 属性变化。

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

--- PostgreSQL 17
+++ PostgreSQL 18
@@ -162,6 +162,15 @@
     },
     {
       "family": "circle_ops",
+      "function": "gist_translate_cmptype_common(int4)",
+      "left_type": "any",
+      "method": "gist",
+      "number": "12",
+      "result_type": "int2",
+      "right_type": "any"
+    },
+    {
+      "family": "circle_ops",
       "function": "gist_box_union(internal,internal)",
       "left_type": "circle",
       "method": "gist",

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

快速链接