本模块实现了 hstore 数据类型，用于在单个 PostgreSQL 值中存储键/值对集合。这在各种场景中都很有用，例如具有许多很少被检查的属性的行，或半结构化数据。键和值都只是文本字符串。
此模块被认为是“受信任的”，这意味着非超级用户也可以在其拥有的数据库上安装它，前提是他们具有 CREATE 权限。
hstore 外部表示 #hstore 的文本表示（用于输入和输出）包含零个或多个由逗号分隔的 key => value 对。例如：
k => v foo => bar, baz => whatever "1-a" => "anything at all"
键值对的顺序不重要（并且在输出时可能不会被复制）。键值对之间或 => 符号周围的空白被忽略。包含空格、逗号、= 或 > 的键和值需要用双引号括起来。要在键或值中包含双引号或反斜杠，请用反斜杠对其进行转义。
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.6 所示，函数如 表 F.7 所示。
表 F.6. hstore 运算符
|
运算符 描述 示例 |
|---|
|
返回与给定键关联的值，如果不存在则返回
|
|
返回与给定键关联的值，如果不存在则返回
|
|
连接两个
|
|
|
|
|
|
|
|
左操作数是否包含右操作数？
|
|
左操作数是否包含在右操作数中？
|
|
从左操作数中删除键。
|
|
从左操作数中删除键。
|
|
从左操作数中删除与右操作数中匹配的键值对。
|
|
用
|
|
将
|
|
将
|
表 F.7. hstore 函数
除了这些运算符和函数之外，hstore 类型的值还可以通过下标进行访问，使其行为类似于关联数组。只能指定一个 text 类型的下标；它被解释为键，并获取或存储相应的值。例如，
CREATE TABLE mytable (h hstore);
INSERT INTO mytable VALUES ('a=>b, c=>d');
SELECT h['a'] FROM mytable;
h
---
b
(1 row)
UPDATE mytable SET h['c'] = 'new';
SELECT h FROM mytable;
h
----------------------
"a"=>"b", "c"=>"new"
(1 row)
如果下标为 NULL 或者该键不存在于 hstore 中，则带下标的获取将返回 NULL。（因此，带下标的获取与 -> 运算符没有太大区别。）如果下标为 NULL，则带下标的更新将失败；否则，它会替换该键的值，如果该键尚不存在，则会向 hstore 添加一个条目。
hstore 为 @>, ?, ?& 和 ?| 运算符提供 GiST 和 GIN 索引支持。例如
CREATE INDEX hidx ON testhstore USING GIST (h); CREATE INDEX hidx ON testhstore USING GIN (h);
gist_hstore_ops GiST 操作符类将一组键/值对近似为位图签名。其可选的整数参数 siglen 决定了以字节为单位的签名长度。默认长度为 16 字节。签名长度的有效值为 1 到 2024 字节。更长的签名会导致更精确的搜索（扫描索引的一小部分和更少的堆页面），但代价是索引更大。
使用 32 字节签名长度创建此类索引的示例
CREATE INDEX hidx ON testhstore USING GIST (h gist_hstore_ops(siglen=32));
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['c'] = '3';
另一种实现相同功能的方法是：
UPDATE tab SET h = h || hstore('c', '3');
如果要在一次操作中添加或更改多个键，则连接方法比下标访问更高效。
UPDATE tab SET h = h || hstore(array['q', 'w'], array['11', '12']);
删除键
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');
使用表
CREATE TABLE stat AS SELECT (each(h)).key, (each(h)).value 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 方法需要表上的 ACCESS EXCLUSIVE 锁，但不会导致表膨胀旧行版本。
还提供了其他扩展，用于实现 PL/Perl 和 PL/Python 语言的 hstore 类型的转换。PL/Perl 的扩展名为 hstore_plperl 和 hstore_plperlu，分别用于受信任和不受信任的 PL/Perl。如果安装这些转换并在创建函数时指定它们，hstore 值将映射到 Perl 哈希。PL/Python 的扩展名为 hstore_plpython3u。如果使用它，hstore 值将映射到 Python 字典。
Oleg Bartunov <oleg@sai.msu.su>，莫斯科，莫斯科大学，俄罗斯
Teodor Sigaev <teodor@sigaev.ru>，莫斯科，Delta-Soft 有限公司，俄罗斯
Andrew Gierth <andrew@tao11.riddles.org.uk>，英国，做出了额外的增强
如果您发现文档中的任何内容不正确、与您使用特定功能的经验不符或需要进一步澄清，请使用 此表单 报告文档问题。