問題報告 糾錯本頁面

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

30选5中奖号码查询