F.15. hstore

F.15.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.15.2. hstore 操作符和函数

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

a
b

1
2

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

F.15.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.15.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.15.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.15.6. 兼容性

从 PostgreSQL 9.0 开始，hstore使用了与之前版本不同的内部表示。 这不会为转储/恢复升级造成障碍，因为文本表示（用于转储）没有改变。

在一次二进制升级中，通过让新代码识别旧格式数据来维持向上兼容。 当处理还没有被新代码修改过的数据时，这会带来一定的性能惩罚。 可以通过执行一个下面的UPDATE语句来强制升级表中的所有值：

UPDATE tablename SET hstorecol = hstorecol || '';

另一种方法：

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

ALTER TABLE方法要求表上的一个排他锁， 但是不会导致表因为旧行版本而膨胀。

F.15.7. 转换

其他扩展可用于为PL/Perl和PL/Python语言的hstore类型实现变换。 PL/Perl的扩展为hstore_plperl 和hstore_plperlu，用于受信任和不受信任的PL/Perl。 如果安装了这些变换并在创建函数时指定它们，则hstore 值将映射到Perl哈希值。PL/Python的扩展是hstore_plpythonu、 hstore_plpython2u和hstore_plpython3u （参见第 43.1 节获取PL/Python命名惯例）。 如果使用它们，则hstore值将映射到Python字典。

F.15.8. 作者

Oleg Bartunov <oleg@sai.msu.su>，俄罗斯莫斯科大学

Teodor Sigaev <teodor@sigaev.ru>，俄罗斯德尔塔软件有限公司

额外的提升由英国的 Andrew Gierth <andrew@tao11.riddles.org.uk> 提供