F.16. hstore

这个模块完成了hstore数据类型,在单个PostgreSQL值中存储一组键/值对。 这在不同的场景中是有用的,如很少查看带有许多特点的行,或半结构化的数据。 键和值是简略的文本字符串。

F.16.1. 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 节获取更多处理字符串常量的信息。

在输出时,键和值总是包括在双引号中,即便并不严厉需求也是这样。

F.16.2. hstore 操作符和函数

hstore模块供给的操作符显现在表 F-6中, 函数在表 F-7中。

表 F-6. 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 ? texthstore 包括键吗?'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 #= hstorehstore里匹配的值替换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-7. hstore 函数

函数回来类型描绘示例成果
hstore(record)hstore从一个记载或行结构一个 hstorehstore(ROW(1,2))f1=>1,f2=>2
hstore(text[])hstore从一个数组结构一个hstore,或许是一个键/值数组,也或许是一个两维数组hstore(ARRAY['a','1','b','2']) || hstore(ARRAY[['c','3'],['d','4']])a=>1, b=>2, c=>3, d=>4
hstore(text[], text[])hstore从一个独自的键和值数组结构一个hstorehstore(ARRAY['a','b'], ARRAY['1','2'])"a"=>"1","b"=>"2"
hstore(text, text)hstore制造单一项hstorehstore('a', 'b')"a"=>"b"
akeys(hstore)text[]获取hstore的键作为一个数组akeys('a=>1,b=>2'){a,b}
skeys(hstore)setof text获取hstore的键作为一个调集skeys('a=>1,b=>2')
a
b
avals(hstore)text[]获取hstore的值作为一个数组avals('a=>1,b=>2'){1,2}
svals(hstore)setof text获取hstore的值作为一个调集svals('a=>1,b=>2')
1
2
hstore_to_array(hstore)text[]获取hstore的键和值作为一个键值替换的数组hstore_to_array('a=>1,b=>2'){a,1,b,2}
hstore_to_matrix(hstore)text[]获取hstore的键和值作为一个两维数组hstore_to_matrix('a=>1,b=>2'){{a,1},{b,2}}
hstore_to_json(hstore)json获取hstore作为一个jsonhstore_to_json('"a key"=>1, b=>t, c=>null, d=>12345, e=>012345, f=>1.234, g=>2.345e+4'){"a key": "1", "b": "t", "c": null, "d": "12345", "e": "012345", "f": "1.234", "g": "2.345e+4"}
hstore_to_json_loose(hstore)json获取hstore作为一个json值,可是企图区别数值和布尔值,所以它们在JSON中没有引号hstore_to_json_loose('"a key"=>1, b=>t, c=>null, d=>12345, e=>012345, f=>1.234, g=>2.345e+4'){"a key": 1, "b": true, "c": null, "d": 12345, "e": "012345", "f": 1.234, "g": 2.345e+4}
slice(hstore, text[])hstore提取hstore的一个子集slice('a=>1,b=>2,c=>3'::hstore, ARRAY['b','c','x'])"b"=>"2", "c"=>"3"
each(hstore)setof(key text, value text)获取 hstore的键和值作为一个调集select * from each('a=>1,b=>2')
 key | value
-----+-------
 a   | 1
 b   | 2
exist(hstore,text)booleanhstore 包括键吗?exist('a=>1','a')t
defined(hstore,text)booleanhstore 包括非NULL值的键吗?defined('a=>NULL','a')f
delete(hstore,text)hstore删去匹配键的对delete('a=>1,b=>2','b')"a"=>"1"
delete(hstore,text[])hstore删去匹配键的多个对delete('a=>1,b=>2,c=>3',ARRAY['a','b'])"c"=>"3"
delete(hstore,hstore)hstore删去匹配第二个参数中元素的对delete('a=>1,b=>2','a=>4,b=>2'::hstore)"a"=>"1"
populate_record(record,hstore)record替换record中匹配hstore中的值的字段参看示例章节 

注意: hstore值转化为json时运用hstore_to_json函数。

注意: 函数populate_record实际上是用anyelement, 而不是record,声明为它的第一个参数,可是它将用运行时过错拒绝非记载类型。

F.16.3. 索引

hstore有GiST 和 GIN索引支撑@>, ?, ?&?|操作符。例如:

CREATE INDEX hidx ON testhstore USING GIST (h);

CREATE INDEX hidx ON testhstore USING GIN (h);

hstore也为=操作符支撑btreehash索引。 这答应hstore字段声明为UNIQUE,或在GROUP BY, ORDER BYDISTINCT表达式中运用。为hstore 值的排序次序不是很有用,可是这些索引或许关于等价查找有用途。为= 比较创立索引如下:

CREATE INDEX hidx ON testhstore USING BTREE (h);

CREATE INDEX hidx ON testhstore USING HASH (h);

F.16.4. 比如

增加一个键,或用新值更新一个现有的键:

UPDATE tab SET h = h || hstore('c', '3');

删去一个键:

UPDATE tab SET h = delete(h, 'k1');

转化recordhstore:

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)

F.16.5. 计算

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
...................

F.16.6. 兼容性

自PostgreSQL 9.0起,hstore运用一个不同于曾经版别的内部表明。 这样做关于转储/康复晋级没有什么妨碍,由于文本表明(在转储中运用的)没有改动。

在一个二进制晋级中,向上兼容是经过使新代码知道老格局的数据来保护的。 这在处理还未被新代码修正的数据时会有一点功能代偿。经过像下面这样的UPDATE 句子强制晋级一个表字段中的一切值是或许的:

UPDATE tablename SET hstorecol = hstorecol || '';

另一个办法是:

ALTER TABLE tablename ALTER hstorecol TYPE hstore USING hstorecol || '';

ALTER TABLE办法要求在表上的一个排他锁,可是不会导致有旧行版别的表胀大。

F.16.7. 作者

Oleg Bartunov , Moscow, Moscow University, Russia

Teodor Sigaev , Moscow, Delta-Soft Ltd., Russia

Andrew Gierth 附加的增强, United Kingdom

188bet