F.16. hstore

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加双引号。

在输出时，键和值总是包含在双引号中，即使并不严格需要也是这样。

F.16.2. hstore 操作符和函数

hstore模块提供的操作符显示在表 F-6中， 函数在表 F-7中。

a
b

1
2

 key | value
-----+-------
 a   | 1
 b   | 2

F.16.3. 索引

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);

F.16.4. 例子

添加一个键，或用新值更新一个现有的键：

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)

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 <oleg@sai.msu.su>, Moscow, Moscow University, Russia

Teodor Sigaev <teodor@sigaev.ru>, Moscow, Delta-Soft Ltd., Russia

Andrew Gierth <andrew@tao11.riddles.org.uk>附加的增强, United Kingdom