cube

用于存储多维立方体的数据类型

https://www.postgresql.org/docs/current/cube.html

概览

扩展包名	版本	分类	许可证	语言
`cube`	`1.5`	TYPE	PostgreSQL	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
3950	`cube`	否	是	否	是	是	否	-

相关扩展	`seg` `prefix` `unit` `ip4r` `pgmp` `numeral` `pg_rational` `uint` `uint128` `ltree`
下游依赖	`earthdistance` `pg4ml`

版本

PG18	PG17	PG16	PG15	PG14
1.5	1.5	1.5	1.5	1.5

安装

提示：这是 PostgreSQL 内核自带的 contrib 扩展

SQL

CREATE EXTENSION cube;

用法

cube: 多维立方体数据类型

cube 扩展提供了一种数据类型，用于表示多维立方体（最多支持 100 维）。

SQL

CREATE EXTENSION cube;

输入格式

SQL

SELECT '(1,2),(3,4)'::cube;         -- 二维立方体
SELECT '(1,2,3)'::cube;              -- 三维点（零体积）
SELECT cube(1.0, 2.0);               -- 从 1 到 2 的一维立方体
SELECT cube(ARRAY[1,2], ARRAY[3,4]); -- 从数组创建的二维立方体

运算符

运算符	描述
`&&`	重叠
`@>`	包含
`<@`	被包含
`->`	提取第 n 个坐标
`<->`	欧氏距离
`<#>`	曼哈顿距离（L-1）
`<=>`	切比雪夫距离（L-inf）

函数

SQL

SELECT cube_dim('(1,2),(3,4)'::cube);                  -- 2
SELECT cube_ll_coord('(1,2),(3,4)'::cube, 1);          -- 1
SELECT cube_ur_coord('(1,2),(3,4)'::cube, 1);          -- 3
SELECT cube_is_point(cube(1,1));                        -- true
SELECT cube_distance('(1,2)'::cube, '(3,4)'::cube);    -- 2.828...
SELECT cube_union('(1,2)'::cube, '(3,4)'::cube);       -- (1,2),(3,4)
SELECT cube_inter('(0,0),(2,2)'::cube, '(1,1),(3,3)'::cube);
SELECT cube_subset(cube('(1,3,5),(6,7,8)'), ARRAY[2]); -- (3),(7)
SELECT cube_enlarge('(1,2),(3,4)'::cube, 0.5, 2);      -- 按半径扩展

GiST 索引与 KNN 搜索

SQL

CREATE INDEX idx ON points USING gist (location);

-- 查找最近的点（距 (0.5, 0.5, 0.5) 最近）
SELECT * FROM points
ORDER BY location <-> cube(ARRAY[0.5, 0.5, 0.5])
LIMIT 1;

维度处理

当对不同维度的立方体进行运算时，低维立方体的缺失坐标将被视为零。

意见反馈

这个页面对您有帮助吗？

感谢反馈！请告诉我们如何改进。

抱歉给您带来不便。请告诉我们如何改进。