这个模块实现了hstore
数据类型用来在一个单一PostgreSQL值中存储键值对。这在很多情景下都有用,例如带有很多很少被检查的属性的行或者半结构化数据。键和值都是简单的文本字符串。
hstore
外部表示
一个hstore
的文本表示用于输入和输出,包括零个或者多个由逗号分隔的key
=>
value
对。一些例子:
k => v foo => bar, baz => whatever "1-a" => "anything at all"
键值对的顺序没有意义(并且在输出时也不会重现)。键值对之间或者=>
号周围的空白会被忽略。双引号内的键和值可以包括空白、逗号、=
或>
。要在一个键或值中包括一个双引号或一个反斜线,用一个反斜线对它转义。
一个hstore
中的每一个键是唯一的。如果你声明了一个有重复键的hstore
,只有一个会被存储在hstore
中并且无法保证哪一个将被保留:
SELECT 'a=>1,a=>2'::hstore; hstore ---------- "a"=>"1"
一个值(但不是一个键)能够是一个 SQL NULL
。例如:
key => NULL
NULL
关键词是大小写不敏感的。将NULL
放在双引号中可以将它当作一个普通的字符串“NULL”。
记住当hstore
文本格式当被用于输入时,它应用在任何必须的引用或转义之前。如果你通过一个参数传递一个hstore
文字,那么不需要额外的处理。但是如果你将它作为一个引用的文字常数,那么任何单引号字符以及(取决于standard_conforming_strings
配置参数的设置)反斜线字符需要被正确地转义。更多关于处理字符串常量的处理可见第 4.1.2.1 节。
在输出时,双引号总是围绕着键和值,即使这样做不是绝对必要。
hstore
操作符和函数 hstore
模块所提供的操作符显示在表 F.8中,函数在表 F.9中。
表 F.8. hstore
操作符
操作符 | 描述 | 例子 | 结果 |
---|---|---|---|
hstore -> text | 为键得到值(不存在则是NULL ) | 'a=>x, b=>y'::hstore -> 'a' | x |
hstore -> text[] | 为多个键得到值(不存在则是NULL ) | 'a=>x, b=>y, c=>z'::hstore -> ARRAY['c','a'] | {"z","x"} |
hstore || hstore | 串接hstore | 'a=>b, c=>d'::hstore || 'c=>x, d=>q'::hstore | "a"=>"b", "c"=>"x", "d"=>"q" |
hstore ? text | hstore 是否包含键? | 'a=>1'::hstore ? 'a' | t |
hstore ?& text[] | hstore 是否包含所有指定的键? | 'a=>1,b=>2'::hstore ?& ARRAY['a','b'] | t |
hstore ?| text[] | hstore 是否包含任何指定的键? | 'a=>1,b=>2'::hstore ?| ARRAY['b','c'] | t |
hstore @> hstore | 左操作数是否包含右操作数? | 'a=>b, b=>1, c=>NULL'::hstore @> 'b=>1' | t |
hstore <@ hstore | 左操作数是否被包含在右操作数中? | 'a=>c'::hstore <@ 'a=>b, b=>1, c=>NULL' | f |
hstore - text | 从左操作数中删除键 | 'a=>1, b=>2, c=>3'::hstore - 'b'::text | "a"=>"1", "c"=>"3" |
hstore - text[] | 从左操作数中删除多个键 | 'a=>1, b=>2, c=>3'::hstore - ARRAY['a','b'] | "c"=>"3" |
hstore - hstore | 从左操作数中删除匹配的对 | 'a=>1, b=>2, c=>3'::hstore - 'a=>4, b=>2'::hstore | "a"=>"1", "c"=>"3" |
record #= hstore | 用来自hstore 的匹配值替换record 中的域 | 见示例小节 | |
%% hstore | 把hstore 转换成键和值交替出现的数组 | %% 'a=>foo, b=>bar'::hstore | {a,foo,b,bar} |
%# hstore | 把hstore 转换成二维的键值数组 | %# 'a=>foo, b=>bar'::hstore | {{a,foo},{b,bar}} |
在 PostgreSQL 8.2 之前,包含操作符@>
和<@
分别被称为@
和~
。这些名称仍然可用,但是已经被弃用并且最终将被移除。注意,旧名称和原来核心几何数据类型所遵循的习惯是相反的!
表 F.9. hstore
函数
当一个hstore
值被造型成json
时,将使用函数hstore_to_json
。同样地,当一个hstore
值被造型成jsonb
时,将使用函数hstore_to_jsonb
。
函数populate_record
实际上被声明为第一个参数为anyelement
而非record
,但是它将会用一个运行时错误拒绝非记录类型。
hstore
有对@>
、?
、?&
和?|
操作符的 GiST 和 GIN 索引支持。例如:
CREATE INDEX hidx ON testhstore USING GIST (h); CREATE INDEX hidx ON testhstore USING GIN (h);
hstore
也为=
操作符支持btree
或hash
索引。这允许hstore
列被声明为UNIQUE
或者被使用在GROUP BY
、ORDER BY
或DISTINCT
表达式中。hstore
值的排序顺序不是特别有用,但是这些索引可能对等值查找有用。为=
比较创建以下索引:
CREATE INDEX hidx ON testhstore USING BTREE (h); CREATE INDEX hidx ON testhstore USING HASH (h);
增加一个键,或者用一个新值更新一个现有的键:
UPDATE tab SET h = h || hstore('c', '3');
删除一个键:
UPDATE tab SET h = delete(h, 'k1');
将一个record
转换成一个hstore
:
CREATE TABLE test (col1 integer, col2 text, col3 text); INSERT INTO test VALUES (123, 'foo', 'bar'); SELECT hstore(t) FROM test AS t; hstore --------------------------------------------- "col1"=>"123", "col2"=>"foo", "col3"=>"bar" (1 row)
将一个hstore
转换成一个预定义的record
类型:
CREATE TABLE test (col1 integer, col2 text, col3 text); SELECT * FROM populate_record(null::test, '"col1"=>"456", "col2"=>"zzz"'); col1 | col2 | col3 ------+------+------ 456 | zzz | (1 row)
用来自于一个hstore
的值修改一个现有的记录:
CREATE TABLE test (col1 integer, col2 text, col3 text); INSERT INTO test VALUES (123, 'foo', 'bar'); SELECT (r).* FROM (SELECT t #= '"col3"=>"baz"' AS r FROM test t) s; col1 | col2 | col3 ------+------+------ 123 | foo | baz (1 row)
由于hstore
类型本质的宽大性,它能够包含一些不同的键。检查合法键是应用的任务。下列例子验证了用于检查键以及获得统计的一些技术。
简单例子:
SELECT * FROM each('aaa=>bq, b=>NULL, ""=>1');
使用一个表:
SELECT (each(h)).key, (each(h)).value INTO stat FROM testhstore;
在线统计:
SELECT key, count(*) FROM (SELECT (each(h)).key FROM testhstore) AS stat GROUP BY key ORDER BY count DESC, key; key | count -----------+------- line | 883 query | 207 pos | 203 node | 202 space | 197 status | 195 public | 194 title | 190 org | 189 ...................
从 PostgreSQL 9.0 开始,hstore
使用了与之前版本不同的内部表示。这不会为转储/恢复升级造成障碍,因为文本表示(用于转储)没有改变。
在一次二进制升级中,通过让新代码识别旧格式数据来维持向上兼容。当处理还没有被新代码修改过的数据时,这会带来一定的性能惩罚。可以通过执行一个下面的UPDATE
语句来强制升级表中的所有值:
UPDATE tablename SET hstorecol = hstorecol || '';
另一种方法:
ALTER TABLE tablename ALTER hstorecol TYPE hstore USING hstorecol || '';
ALTER TABLE
方法要求表上的一个排他锁,但是不会导致表因为旧行版本而膨胀。
有一些额外的扩展为语言 PL/Perl 和 PL/Python 实现了hstore
类型的转换。用于 PL/Perl 的扩展叫做hstore_plperl
和
hstore_plperlu
,分别用于可信的和不可信的 PL/Perl。
如果安装这些转换并且在创建函数时指定它们,hstore
值会被
映射成 Perl 哈希。用于 PL/Python 的扩展是hstore_plpythonu
、
hstore_plpython2u
和hstore_plpython3u
(
PL/Python 命名习惯见第 45.1 节)。如果使用它们,
hstore
值会被映射成 Python 字典。
Oleg Bartunov <oleg@sai.msu.su>
,俄罗斯莫斯科大学
Teodor Sigaev <teodor@sigaev.ru>
,俄罗斯德尔塔软件有限公司
额外的提升由英国的 Andrew Gierth <andrew@tao11.riddles.org.uk>
提供