지원 버전 :현재(17) /16 / 15 / 14 / 13
개발 버전 :18 / Devel
지원되지 않는 버전 :12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3
이 문서는 지원되지 않는 버전의 PostgreSQL을위한 것입니다.
당신은에 대해 같은 페이지를 보려고 할 수 있습니다현재버전 또는 위에 나열된 다른 지원되는 버전 중 하나입니다.

F.16. 젠 토토

이 모듈은를 구현합니다.젠 토토데이터 단일 내에서 키/값 쌍 세트를 저장하기위한 유형postgresql값. 이것은 될 수 있습니다 많은 속성이있는 행과 같은 다양한 시나리오에서 유용합니다. 거의 검사하지 않거나 반 구조화 된 데이터가 없습니다. 열쇠와 값이 있습니다 단순히 텍스트 문자열.

F.16.1.젠 토토외부 표현

an의 텍스트 표현젠 토토, 사용 입력 및 출력의 경우 0 이상 포함 = value쉼표로 분리 된 쌍. 일부 예 :

k = v
foo = bar, baz = 뭐든지
"1-a"= "무엇이든"

쌍의 순서는 중요하지 않습니다 ( 출력에 재현 됨). 쌍 사이 또는 주변 사이의 공백=표시가 무시됩니다. 두 배의 키 및 공백, 쉼표를 포함하는 값=s 또는s. a를 포함합니다 이중 견적 또는 키 또는 값의 백 슬래시, 백 슬래시.

an의 각 키젠 토토고유합니다. 당신이 선언젠 토토중복 키가있는 것 하나는에 저장됩니다.젠 토토보관할 보장은 없습니다 :

선택 'a = 1, a = 2':: 젠 토토;
  젠 토토
---------
 "a"= "1"

값 (키가 아님)은 SQL 일 수 있습니다null. 예를 들어:

key = null

thenull키워드는 사례에 민감합니다. 두 배의 ~null일반 문자열"null".

참고 :젠 토토텍스트 형식은 입력에 사용될 때 적용필요한 인용 또는 탈출. 당신이 통과하는 경우젠 토토매개 변수를 통한 리터럴이면 추가 처리가 필요하지 않습니다. 하지만 인용 된 문자 그대로 상수로 통과한다면 단일 쿼트 문자 및 (의 설정에 따라Standard_Conforming_strings구성 매개 변수) 백 슬래시 문자를 올바르게 피해야합니다. 보다섹션 4.1.2.1문자열 상수 처리에 대한 자세한 내용.

출력에 대한 이중 인용문은 항상 키와 값을 둘러싸고 있습니다. 정말로 필요하지 않은 경우.

F.16.2.젠 토토운영자 및 기능

젠 토토모듈에 표시테이블 F-8, 함수표 F-9.

테이블 F-8.젠 토토운영자

운영자 설명 example 결과
젠 토토 - 텍스트 key value get key (NULL그렇지 않은 경우 현재의) 'a = x, b = y':: 젠 토토- '에이' x
젠 토토 - 텍스트 [] 키 값 가져 오기 (NULL그렇지 않은 경우 현재의) 'a = x, b = y, c = z':: 젠 토토- 배열 [ 'c', 'a'] "z", "x"
젠 토토 || 젠 토토 Concatenate젠 토토S 'a = b, c = d':: 젠 토토 || 'c = x, d = q ':: 젠 토토 "a"= "b", "c"= "x", "D"= "Q"
젠 토토 ? 텍스트 do젠 토토키 포함? 'a = 1':: 젠 토토? '에이' t
젠 토토 ? & 텍스트 [] do젠 토토지정된 모든 것을 포함합니다 키? 'a = 1, b = 2':: 젠 토토? & 배열 [ 'a', 'b'] t
젠 토토 ? | 텍스트 [] do젠 토토지정된 것을 포함합니다 키? 'a = 1, b = 2':: 젠 토토? | 배열 [ 'b', 'c'] t
젠 토토 @ 젠 토토 왼쪽 피연산자가 오른쪽에 포함되어 있습니까? 'a = b, b = 1, c = null':: 젠 토토 @ 'b = 1' t
젠 토토 <@ 젠 토토 왼쪽 피연산자가 오른쪽에 포함되어 있습니까? 'a = c':: 젠 토토 <@ 'a = b, b = 1, c = null ' F
젠 토토 - 텍스트 왼쪽 피연산자에서 키 삭제 'a = 1, b = 2, c = 3':: 젠 토토- 'b':: 텍스트 "a"= "1", "c"= "3"
젠 토토 - 텍스트 [] 왼쪽 피연산자에서 키 삭제 'a = 1, b = 2, c = 3':: 젠 토토- 배열 [ 'a', 'b'] "C"= "3"
젠 토토 - 젠 토토 왼쪽 피연산자에서 일치하는 쌍을 삭제 'a = 1, b = 2, c = 3':: 젠 토토- 'a = 4, b = 2':: 젠 토토 "a"= "1", "c"= "3"
레코드 #= 젠 토토 필드 교체레코드일치하는 의 값젠 토토 예제 섹션 참조
%% 젠 토토 Convert젠 토토교대 배열 열쇠와 가치 %% 'a = foo, b = bar':: 젠 토토 a, foo, b, bar
%# 젠 토토 Convert젠 토토2 차원까지 키/가치 배열 %# 'a = foo, b = bar':: 젠 토토 a, foo, b, bar

참고 :PostgreSQL 8.2 이전, 격리 연산자@and<@부름@and~각각. 이 이름은 여전히 ​​사용할 수 있습니다. 그러나 더 이상 사용되지 않으며 결국 제거됩니다. 그것을 주목하십시오 오래된 이름은 이전에 컨벤션에서 뒤집어졌습니다. 핵심 기하학적 데이터 유형!

테이블 F-9.젠 토토기능

function 반환 유형 설명 example 결과
젠 토토 (레코드) 젠 토토 구성젠 토토레코드에서 또는 열 젠 토토 (ROW (1,2)) f1 = 1, f2 = 2
젠 토토 (text []) 젠 토토 구성젠 토토배열에서 키/값 배열 또는 2 차원 배열 일 수 있습니다 젠 토토 (배열 [ 'a', '1', 'b', '2']) || 젠 토토 (배열 [[ 'c', '3'], [ 'd', '4']) a = 1, b = 2, c = 3, d = 4
젠 토토 (텍스트 [], 텍스트 []) 젠 토토 건설젠 토토별도의 키에서 가치 배열 젠 토토 (배열 [ 'a', 'b'], 배열 [ '1', '2']) "a"= "1", "b"= "2"
젠 토토 (텍스트, 텍스트) 젠 토토 단일 항목 만들기젠 토토 젠 토토 ( 'a', 'b') "a"= "b"
akeys (젠 토토) 텍스트 [] get젠 토토의 열쇠는 배열로 akeys ( 'a = 1, b = 2') a, b
Skeys (젠 토토) 텍스트 설정 get젠 토토의 키로 세트 Skeys ( 'a = 1, b = 2')
a
비
avals (젠 토토) 텍스트 [] get젠 토토의 값으로 배열 avals ( 'a = 1, b = 2') 1,2
Svals (젠 토토) 텍스트 설정 ​​get젠 토토의 값 세트 svals ( 'a = 1, b = 2')
1
2
젠 토토_to_array (젠 토토) 텍스트 [] get젠 토토의 키와 값은 배열로서 교대 열쇠와 가치 젠 토토_to_array ( 'a = 1, b = 2') a, 1, b, 2
젠 토토_to_matrix (젠 토토) 텍스트 [] get젠 토토의 키와 값은 a 2 차원 배열 젠 토토_to_matrix ( 'a = 1, b = 2') a, 1, b, 2
젠 토토_to_json (젠 토토) JSON get젠 토토asJSONvalue 젠 토토_to_json ( ' "키"= 1, b = t, c = null, d = 12345, e = 012345, f = 1.234, g = 2.345e+4 ') "키": "1", "b": "t", "c": null, "d": "12345", "E": "012345", "F": "1.234", "G": "2.345E+4"
젠 토토_to_json_loose (젠 토토) JSON get젠 토토asJSON값이지만 수치를 구별하려고 시도합니다 부울 값으로 JSON에서 인용되지 않음 젠 토토_to_json_loose ( ' "키"= 1, b = t, c = null, d = 12345, e = 012345, f = 1.234, g = 2.345e+4 ') "키": 1, "b": true, "c": null, "d": 12345, "E": "012345", "F": 1.234, "G": 2.345E+4
슬라이스 (젠 토토, text []) 젠 토토 an의 하위 집합 추출젠 토토 슬라이스 ( 'a = 1, b = 2, c = 3':: 젠 토토, 배열 [ 'b', 'c', 'x'] "b"= "2", "c"= "3"
각 (젠 토토) setof (키 텍스트, 값 텍스트) get젠 토토의 키와 값은 a 세트 선택 *에서 각각 ( 'a = 1, b = 2')
키 | 값
-----+-------
 A | 1
 B | 2
존재 (젠 토토, text) 부울 do젠 토토키 포함? 존재 ( 'a = 1', 'a') t
정의 (젠 토토, text) 부울 do젠 토토NULL키 가치? 정의 ( 'a = null', 'a') f
삭제 (젠 토토, TEXT) 젠 토토 일치하는 키와 쌍 삭제 삭제 ( 'a = 1, b = 2', 'b') "a"= "1"
삭제 (젠 토토, text []) 젠 토토 일치하는 키와 쌍을 삭제 delete ( 'a = 1, b = 2, c = 3', 배열 [ 'a', 'b'] "C"= "3"
삭제 (젠 토토, 젠 토토) 젠 토토 두 번째 인수에 일치하는 쌍을 삭제 delete ( 'a = 1, b = 2', 'a = 4, b = 2':: 젠 토토) "a"= "1"
popule_record (record, 젠 토토) 레코드 필드 교체레코드일치하는 의 값젠 토토 예제 섹션 참조

참고 :함수젠 토토_to_json에 사용됩니다젠 토토값은JSON.

참고 :함수popule_record실제로Anylement, 아님레코드, 첫 번째 주장으로서, 비 레코드 유형을 런타임 오류.

F.16.3. 인덱스

젠 토토GIST 및 GIN Index 지원이 있습니다 그만큼@, ?, ? &? |연산자. 예를 들어:

GIST (h)를 사용하여 TestHstore에서 인덱스 HIDX 생성;

gin (h);을 사용하여 test젠 토토에서 인덱스 HIDX를 만듭니다.

젠 토토지원btree또는HASH=운영자. 이것은 허용젠 토토선언 될 열고유 한또는그룹 에 의해, 주문 by또는별개의표현. 정렬 주문젠 토토값은 특별히 유용하지 않지만 이러한 인덱스는 동등성 조회에 유용 할 수 있습니다. 인덱스를 만듭니다 을 위한=다음과 같이 비교 :

btree (h)를 사용하여 test젠 토토에서 인덱스 HIDX 생성;

해시 (h);을 사용하여 TestHstore에서 인덱스 HIDX를 만듭니다.

F.16.4. 예

키를 추가하거나 새로운 값으로 기존 키를 업데이트하십시오.

업데이트 탭 세트 H = H || 젠 토토 ( 'c', '3');

키 삭제 :

업데이트 탭 세트 H = 삭제 (h, 'k1');

변환레코드to an젠 토토:

테이블 테스트 생성 (Col1 Integer, Col2 Text, Col3 Text);
테스트 값에 삽입 (123, 'foo', 'bar');

test로 ts로 젠 토토 (t)를 선택하십시오.
                   젠 토토                    
----------------------------------------------------------
 "col1"= "123", "col2"= "foo", "col3"= "bar"
(1 행)

변환젠 토토사전 정의 된레코드유형 :

테이블 테스트 생성 (Col1 Integer, Col2 Text, Col3 Text);

populate_record에서 *를 선택하십시오 (null :: test,
                              ' "col1"= "456", "col2"= "zzz"');
 col1 | col2 | col3 
------+------+------
  456 | ZZZ | 
(1 행)

an을 사용하여 기존 레코드를 수정합니다젠 토토:

테이블 테스트 생성 (COL1 Integer, COL2 TEXT, COL3 TEXT);
테스트 값에 삽입 (123, 'foo', 'bar');

선택 (r).
 col1 | col2 | col3 
------+------+------
  123 | foo | 바즈
(1 행)

F.16.5. 통계

the젠 토토내재성 때문에 타입 자유는 다양한 키를 포함 할 수 있습니다. 확인 유효한 키는 응용 프로그램의 작업입니다. 다음 예제 키를 점검하고 얻는 몇 가지 기술을 보여줍니다 통계.

간단한 예 :

선택 * 각각에서 ( 'aaa = bq, b = null, ""= 1');

테이블 사용 :

select (각 (h)). 키, (각 (h)). test젠 토토에서 STAT 로의 값;.

온라인 통계 :

Key, Count (*)를 선택하십시오
  (test젠 토토의 키)를 STAT로 선택하십시오
  키 별 그룹
  Count Desc, Key에 의한 주문;
    키 | 세다
----------+-------
 라인 |   883
 쿼리 |   207
 pos |   203
 노드 |   202
 공간 |   197
 상태 |   195
 공개 |   194
 제목 |   190
 org |   189
...................

F.16.6. 호환성

Postgresql 9.0,.젠 토토a 이전 버전과 다른 내부 표현. 이것 텍스트 이후 덤프/복원 업그레이드에 장애물이 없습니다 표현 (덤프에서 사용)은 변하지 않습니다.

이진 업그레이드의 경우 상향 호환성은 다음과 같습니다. 새 코드가 구식 데이터를 인식하도록하여 유지 관리합니다. 이것 데이터를 처리 할 때 약간의 성능 페널티가 수반됩니다. 새 코드로 아직 수정되지 않았습니다. 강요 할 수 있습니다 테이블 열에서 모든 값의 업그레이드를 수행하여업데이트다음과 같이 진술 :

업데이트 태블니 이름 세트 젠 토토col = 젠 토토col || '';

그렇게하는 또 다른 방법은 다음과 같습니다.

젠 토토col을 사용한 젠 토토COL 유형 젠 토토 || '';

theAlter Table메소드가 필요합니다 테이블에 독점적 인 잠금이 있지만 팽만감은 없습니다. 오래된 행 버전이있는 테이블.

F.16.7. 저자

Oleg Bartunov, 모스크바, 모스크바 대학교, 러시아

Teodor Sigaev, 모스크바, Delta-Soft Ltd., 러시아

Andrew Gierth의 추가 향상, 영국