用于输入和输出的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模块提供的操作符见表 F.8， 函数见表 F.9。

a
b

1
2

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

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 || ('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方法需要对表加 独占锁，但不会因旧行版本而导致表膨胀。

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

Teodor Sigaev <teodor@sigaev.ru>，俄罗斯莫斯科，Delta-Soft Ltd.

Andrew Gierth <andrew@tao11.riddles.org.uk>，英国，对本模块作 了额外增强