이 모듈은 다음을 구현합니다.와이즈 토토단일 내에 키/값 쌍 세트를 저장하기 위한 데이터 유형포스트그레SQL값. 이는 거의 검사되지 않는 속성이 많은 행이나 반구조화된 데이터 등 다양한 시나리오에서 유용할 수 있습니다. 키와 값은 단순히 텍스트 문자열입니다.
h스토어외부 대표의 텍스트 표현와이즈 토토, 입력 및 출력에 사용되며 0개 이상 포함키 = 값쌍은 쉼표로 구분됩니다. 몇 가지 예:
k = v foo = 바, baz = 뭐든지 "1-a" = "아무거나"
쌍의 순서는 중요하지 않습니다(그리고 출력 시 재생산되지 않을 수도 있습니다). 쌍 사이 또는 주변의 공백=기호는 무시됩니다. 공백, 쉼표를 포함하는 큰따옴표 키와 값=s 또는s. 키나 값에 큰따옴표나 백슬래시를 포함하려면 백슬래시로 이스케이프 처리하세요.
각 키와이즈 토토고유합니다. 선언하는 경우h스토어중복 키가 있으면 하나만 저장됩니다.와이즈 토토그리고 어느 것이 유지될 것인지에 대한 보장은 없습니다:
SELECT 'a=1,a=2'::와이즈 토토; 와이즈 토토 ---------- "a"="1"
값(키는 제외)은 SQL일 수 있습니다.NULL. 예를 들면:
키 = NULL
그NULL키워드는 대소문자를 구분하지 않습니다. 를 큰따옴표로 묶으세요.NULL일반 문자열로 처리“NULL”.
다음을 명심하세요와이즈 토토입력에 사용될 때 텍스트 형식이 적용됩니다.이전필요한 인용 또는 이스케이프. 전달하는 경우와이즈 토토리터럴을 매개변수로 사용하는 경우 추가 처리가 필요하지 않습니다. 그러나 이를 따옴표로 묶은 리터럴 상수로 전달하는 경우 모든 작은따옴표 문자와 (설정에 따라standard_conforming_strings구성 매개변수) 백슬래시 문자를 올바르게 이스케이프해야 합니다. 참조섹션 4.1.2.1문자열 상수 처리에 대한 자세한 내용.
출력 시 큰따옴표는 반드시 필요하지 않은 경우에도 항상 키와 값을 묶습니다.
와이즈 토토연산자와 함수다음에서 제공하는 연산자와이즈 토토모듈은 다음에 표시됩니다.표 F.7, 함수표 F.8.
표 F.7. h스토어연산자
| 운영자 | 설명 | 예 | 결과 |
|---|---|---|---|
h스토어 - 텍스트 |
키 값 가져오기(NULL존재하지 않는 경우) |
'a=x, b=y'::와이즈 토토 - 'a' |
x |
와이즈 토토 - 텍스트[] |
키 값 가져오기(NULL존재하지 않는 경우) |
'a=x, b=y, c=z'::와이즈 토토 - ARRAY['c','a'] |
"z","x" |
와이즈 토토 || 와이즈 토토 |
연결와이즈 토토s |
'a=b, c=d'::와이즈 토토 || 'c=x, d=q'::와이즈 토토 |
"a"="b", "c"="x", "d"="q" |
h스토어 ? 텍스트 |
그렇습니다와이즈 토토키를 포함하고 있나요? |
'a=1'::와이즈 토토 ? 'a' |
t |
와이즈 토토 ?& 텍스트[] |
그렇습니다와이즈 토토지정된 키를 모두 포함합니까? |
'a=1,b=2'::와이즈 토토 ?& ARRAY['a','b'] |
t |
와이즈 토토 ?| 텍스트[] |
그렇습니다와이즈 토토지정된 키가 포함되어 있습니까? |
'a=1,b=2'::와이즈 토토 ?| 배열['b','c'] |
t |
와이즈 토토 @ 와이즈 토토 |
왼쪽 피연산자에 오른쪽이 포함되어 있나요? | 'a=b, b=1, c=NULL'::와이즈 토토 @ 'b=1' |
t |
h스토어 <@ h스토어 |
왼쪽 피연산자가 오른쪽에 포함되어 있습니까? | 'a=c'::와이즈 토토 <@ 'a=b, b=1, c=NULL' |
f |
h스토어 - 텍스트 |
왼쪽 피연산자에서 키 삭제 | 'a=1, b=2, c=3'::와이즈 토토 - 'b'::text |
"a"="1", "c"="3" |
h스토어 - 텍스트[] |
왼쪽 피연산자에서 키 삭제 | 'a=1, b=2, c=3'::와이즈 토토 - ARRAY['a','b'] |
"c"="3" |
와이즈 토토 - h스토어 |
왼쪽 피연산자에서 일치하는 쌍 삭제 | 'a=1, b=2, c=3'::와이즈 토토 - 'a=4, b=2'::와이즈 토토 |
"a"="1", "c"="3" |
기록 #= 와이즈 토토 |
필드 교체기록일치하는 값 포함와이즈 토토 |
예시 섹션 참조 | |
%% 와이즈 토토 |
변환와이즈 토토교대되는 키와 값의 배열로 |
%% 'a=foo, b=bar'::와이즈 토토 |
a,foo,b,bar |
%# h스토어 |
변환와이즈 토토2차원 키/값 배열로 |
%# 'a=foo, b=bar'::와이즈 토토 |
a,foo,b,bar |
PostgreSQL 8.2 이전에는 봉쇄 연산자@그리고<@불려졌습니다@그리고~, 각각. 이러한 이름은 계속 사용할 수 있지만 더 이상 사용되지 않으며 결국 제거될 예정입니다. 이전 이름은 이전에 핵심 기하학적 데이터 유형이 뒤따랐던 규칙과 반대입니다!
표 F.8. 와이즈 토토기능
함수와이즈 토토_to_json다음의 경우에 사용됩니다.와이즈 토토값이 다음으로 변환됨json. 마찬가지로,와이즈 토토_to_jsonb다음의 경우에 사용됩니다.와이즈 토토값이 다음으로 변환됨jsonb.
함수populate_record실제로 선언된 내용은모든 요소아님기록을 첫 번째 인수로 사용하지만 런타임 오류로 인해 레코드가 아닌 유형을 거부합니다.
와이즈 토토다음에 대한 GiST 및 GIN 인덱스 지원이 있습니다.@, ?, ?&그리고?|연산자. 예를 들면:
GIST를 사용하여 test와이즈 토토에서 hidx 인덱스 생성(h); GIN(h)을 사용하여 test와이즈 토토에서 인덱스 hidx를 생성합니다.
h스토어또한 지원합니다브트리또는해시에 대한 색인=연산자. 이것은 허용합니다와이즈 토토선언할 열고유또는 다음에 사용됨그룹별, 주문 기준또는독특식. 정렬 순서는 다음과 같습니다.와이즈 토토값은 특별히 유용하지는 않지만 이러한 색인은 동등성 조회에 유용할 수 있습니다. 다음에 대한 색인 생성=비교는 다음과 같습니다.
BTREE(h)를 사용하여 test와이즈 토토에서 hidx 인덱스 생성; HASH(h)를 사용하여 test와이즈 토토에서 인덱스 hidx를 생성합니다.
키를 추가하거나 기존 키를 새 값으로 업데이트하세요:
업데이트 탭 SET h = h || 와이즈 토토('c', '3');
키 삭제:
UPDATE 탭 SET h = 삭제(h, 'k1');
변환 a기록에와이즈 토토:
CREATE TABLE 테스트(col1 정수, col2 텍스트, col3 텍스트);
테스트 값에 삽입(123, 'foo', 'bar');
SELECT 와이즈 토토(t) FROM 테스트 AS t;
와이즈 토토
--------------------------------
"col1"="123", "col2"="foo", "col3"="바"
(1행)
변환와이즈 토토미리 정의된기록유형:
CREATE TABLE 테스트(col1 정수, col2 텍스트, col3 텍스트);
SELECT * FROM populate_record(null::테스트,
'"col1"="456", "col2"="zzz"');
열1 | 열2 | col3
------+------+------
456 | zzz |
(1행)
다음 값을 사용하여 기존 레코드 수정와이즈 토토:
CREATE TABLE 테스트(col1 정수, col2 텍스트, col3 텍스트); 테스트 값에 삽입(123, 'foo', 'bar'); SELECT (r).* FROM (SELECT t #= '"col3"="baz"' AS r FROM test t) s; 열1 | 열2 | col3 ------+------+------ 123 | 푸 | 바즈 (1행)
그와이즈 토토유형은 본질적인 자유로움으로 인해 다양한 키를 포함할 수 있습니다. 유효한 키를 확인하는 것은 애플리케이션의 작업입니다. 다음 예에서는 키를 확인하고 통계를 얻는 여러 기술을 보여줍니다.
간단한 예:
SELECT * FROM Each('aaa=bq, b=NULL, ""=1');
테이블 사용:
SELECT (각(h)).key, (각(h)).value INTO stat FROM test와이즈 토토;
온라인 통계:
선택 키, 개수(*) FROM
(SELECT (각(h)).key FROM test와이즈 토토) AS stat
그룹별 키
ORDER BY 카운트 DESC, 키;
키 | 카운트
---------+-------
라인 | 883
쿼리 | 207
위치 | 203
노드 | 202
공간 | 197
상태 | 195
공개 | 194
제목 | 190
조직 | 189
....................
PostgreSQL 9.0 기준,와이즈 토토이전 버전과 다른 내부 표현을 사용합니다. 덤프에 사용된 텍스트 표현이 변경되지 않으므로 덤프/복원 업그레이드에 장애가 되지 않습니다.
바이너리 업그레이드의 경우 새 코드가 이전 형식 데이터를 인식하도록 하여 상위 호환성이 유지됩니다. 이는 새 코드에 의해 아직 수정되지 않은 데이터를 처리할 때 약간의 성능 저하를 수반합니다. 다음을 수행하여 테이블 열의 모든 값을 강제로 업그레이드할 수 있습니다.업데이트다음과 같은 진술:
UPDATE 테이블 이름 SET 와이즈 토토col = 와이즈 토토col || '';
또 다른 방법은 다음과 같습니다:
ALTER TABLE 테이블 이름 ALTER 와이즈 토토col TYPE 와이즈 토토 USING 와이즈 토토col || '';
그테이블 변경메서드에는가 필요합니다.접속 독점테이블을 잠그지만 이전 행 버전으로 인해 테이블이 부풀어오르지는 않습니다.
다음에 대한 변환을 구현하는 추가 확장을 사용할 수 있습니다.와이즈 토토39345_39432와이즈 토토_plperl그리고와이즈 토토_plperlu, 신뢰할 수 있는 PL/Perl용 및 신뢰할 수 없는 PL/Perl용. 이러한 변환을 설치하고 함수 생성 시 지정하면,와이즈 토토값은 Perl 해시에 매핑됩니다. PL/Python용 확장이 호출됩니다.와이즈 토토_plpythonu, 와이즈 토토_plpython2u및와이즈 토토_plpython3u(참조PostgreSQL : 문서 : 12 : 45.1. 젠 토토 2 vs. 젠 토토 3PL/Python 명명 규칙의 경우). 사용하신다면,와이즈 토토값은 Python 사전에 매핑됩니다.
변환 확장을 다음과 동일한 스키마에 설치하는 것이 좋습니다.와이즈 토토. 그렇지 않고 변환 확장의 스키마에 적대적인 사용자가 정의한 개체가 포함되어 있으면 설치 시 보안 위험이 있습니다.
올렉 바르투노프<oleg@sai.msu.su, 모스크바, 모스크바 대학교, 러시아
테오도르 시가예프<teodor@sigaev.ru, 모스크바, Delta-Soft Ltd., 러시아
Andrew Gierth의 추가 개선 사항<andrew@tao11.riddles.org.uk, 영국