选择 打开 改范围 完整检索页

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
历史版本PostgreSQL 9.0 已于 2015 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

F.15. intarray #

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

F.15.1. intarray Functions and Operators

表 F.8. intarray Functions

Function Return Type Description Example Result
icount(int[]) int 数组中的元素个数 icount('{1,2,3}'::int[]) 3
sort(int[], text dir) int[] sort array — dir must be asc or desc sort('{1,2,3}'::int[], 'desc') {3,2,1}
sort(int[]) int[] sort in ascending order sort(array[11,77,44]) {11,44,77}
sort_asc(int[]) int[] sort in ascending order
sort_desc(int[]) int[] sort in descending order
uniq(int[]) int[] remove adjacent duplicates 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[] make single-element array intset(42) {42}

表 F.9. intarray Operators

Operator Returns Description
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[] union of arrays
int[] & int[] int[] intersection of arrays
int[] @@ query_int boolean true if array satisfies query (see below)
query_int ~~ int[] boolean true if array satisfies query (commutator of @@)

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

包含操作符 @><@ 大致等价于 PostgreSQL 内置的同名操作符,不同之处在于它们只 适用于整数数组,而内置操作符适用于任何数组类型。一个重要的区别 是,intarray 的操作符不认为空数组包含于任何其他数组。 这与 GIN 索引查询的行为一致,但与通常的数学包含定义不同。

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

F.15.2. 索引支持

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

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

另有一个非默认的 GIN 操作符类gin__int_ops,支持相同的操作符。

作为经验法则,GIN 索引的搜索速度快于 GiST 索引,但构建或更新较慢; 因此 GIN 更适合静态数据,而 GiST 更适合经常更新的数据。

F.15.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.15.4. 基准测试

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

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

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

F.15.5. 作者

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

提交更正

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