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

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

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3
历史版本PostgreSQL 8.3 已于 2013 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

F.12. intarray #

intarray 模块提供了许多有用的函数和操作符,用于操作 一维整数数组。它还支持使用其中某些操作符进行索引搜索。

F.12.1. intarray 函数和操作符

表 F.7. intarray 函数

函数 返回类型 描述 示例 结果
icount(int[]) int 数组中的元素个数 icount('{1,2,3}'::int[]) 3
sort(int[], text dir) int[] 排序数组 — dir 必须为 asc 或 desc sort('{1,2,3}'::int[], 'desc') {3,2,1}
sort(int[]) int[] 按升序排序 sort(array[11,77,44]) {11,44,77}
sort_asc(int[]) int[] 按升序排序
sort_desc(int[]) int[] 按降序排序
uniq(int[]) int[] 移除相邻的重复元素 uniq(sort('{1,2,3,2,1}'::int[])) {1,2,3}
idx(int[], int item) int 与 item 匹配的第一个元素的索引(如果没有则为 0) idx(array[11,22,33,22,11], 22) 2
subarray(int[], int start, int len) int[] 从位置 start 开始的数组片段,共 len 个元素 subarray('{1,2,3,2,1}'::int[], 2, 3) {2,3,2}
subarray(int[], int start) int[] 从位置 start 开始的数组片段 subarray('{1,2,3,2,1}'::int[], 2) {2,3,2,1}
intset(int) int[] 构造单元素数组 intset(42) {42}

表 F.8. intarray 操作符

操作符 返回值 描述
int[] && int[] boolean 重叠 — 如果数组至少有一个共同元素,则为 true
int[] @> int[] boolean 包含 — 如果左数组包含右数组,则为 true
int[] <@ int[] boolean 包含于 — 如果左数组包含在右数组中,则为 true
# int[] int 数组中的元素个数
int[] # int int 索引(与 idx 函数相同)
int[] + int int[] 将元素压入数组(添加到数组末尾)
int[] + int[] int[] 数组连接(右数组添加到左数组末尾)
int[] - int int[] 从数组中移除与右参数匹配的项
int[] - int[] int[] 从左数组中移除右数组中的元素
int[] | int int[] 参数的并集
int[] | int[] int[] 数组的并集
int[] & int[] int[] 数组的交集
int[] @@ query_int boolean 如果数组满足查询,则为 true(见下文)
query_int ~~ int[] boolean 如果数组满足查询,则为 true(@@ 的交换子)

(在 PostgreSQL 8.2 之前,包含操作符 @> 和 <@ 分别叫做 @ 和 ~。这些名称仍然可用,但已弃用,最终将被删除。请注意,旧名称与核心几何数据类型以前采用的约定正好相反!)

@@和~~操作符用于测试数组是否满足某个 查询,该查询表示为专用数据类型query_int 的一个值。一个查询由若干整数值组成,这些值会与 数组元素进行检查,并且可通过操作符&(AND)、 |(OR)和!(NOT)组合起来。必要时 可以使用括号。例如,查询1&(2|3)可匹配包含 1 且还包含 2 或 3 之一的数组。

F.12.2. 索引支持

intarray为&&、@>、<@和@@操作符以及常规数组相等运算提供索引支持。

提供了两个 GiST 索引操作符类:gist__int_ops(默认使用)适用于小型和中型数组,而gist__intbig_ops使用更大的签名,更适合为大型数组建立索引。实现使用带有内置有损压缩的 RD 树数据结构。

另有一个非默认的 GIN 操作符类gin__int_ops。

在 GiST 和 GIN 索引之间做选择,取决于 GiST 和 GIN 的相对性能特征, 相关内容已在别处讨论。作为经验法则,GIN 索引的搜索速度快于 GiST 索引, 但构建或更新较慢;因此 GIN 更适合静态数据,而 GiST 更适合经常更新的数据。

F.12.3. 示例

-- a message can be in one or more “sections”
CREATE TABLE message (mid INT PRIMARY KEY, sections INT[], ...);

-- create specialized index
CREATE INDEX message_rdtree_idx ON message USING GIST (sections gist__int_ops);

-- select messages in section 1 OR 2 - OVERLAP operator
SELECT message.mid FROM message WHERE message.sections && '{1,2}';

-- select messages in sections 1 AND 2 - CONTAINS operator
SELECT message.mid FROM message WHERE message.sections @> '{1,2}';

-- the same, using QUERY operator
SELECT message.mid FROM message WHERE message.sections @@ '1&2'::query_int;

F.12.4. 基准测试

源代码目录contrib/intarray/bench包含一个基准测试 套件。运行方式如下:

cd .../bench
createdb TEST
psql TEST < ../_int.sql
./create_test.pl | psql TEST
./bench.pl

bench.pl脚本有很多选项,在不带任何参数运行时会显示 这些选项。

F.12.5. 作者

所有工作都由 Teodor Sigaev()和 Oleg Bartunov()完成。更多信息请见 http://www.sai.msu.su/~megera/postgres/gist/。 Andrey Oktyabrski 在添加新函数和新操作方面也做出了很大贡献。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。