35.15.1. 롤 토토 정의 사물

광범위하게 분산 된 롤 토토은 거의 가정하지 않아야합니다 그들이 점유하는 데이터베이스. 특히 발행하지 않는 한set search_path = pg_temp, 각 자격이없는 것으로 가정합니다 이름은 악의적 인 사용자가 정의한 객체로 해결할 수 있습니다. 의존하는 구성을 조심하십시오search_path암시 적으로 :inandCASE표현언제항상 an을 선택하십시오 검색 경로를 사용하는 연산자. 그들의 대신 사용연산자 (스키마. =) 어느andCASE표현.

35.15.2. 롤 토토 파일

thePostgreSQL : 문서 : 9.3 : 토토 생성명령은 각 롤 토토자의 제어 파일에 의존합니다. 접미사로 롤 토토자와 동일하게.controlSharedir/Extension디렉토리. 해야합니다 또한 하나 이상이어야SQL스크립트 이름 지정 패턴을 따르는 파일Extension--버전.SQL(예 :foo--1.0.sql버전1.0롤 토토foo). 에 의해 기본값, 스크립트 파일도에 배치됩니다.Sharedir/Extension디렉토리; 그러나 제어 파일 스크립트 파일의 다른 디렉토리를 지정할 수 있습니다.

롤 토토 제어 파일의 파일 형식은 그만큼postgresql.conf파일, 즉 목록 의Parameter_Name = value과제, 줄 당 하나. 빈 줄과 댓글이 소개#허용됩니다. 그 가치를 인용하십시오 한 단어 나 숫자가 아닙니다.

컨트롤 파일은 다음 매개 변수를 설정할 수 있습니다.

기본 제어 파일 외에롤 토토.control, 롤 토토자는 스타일에 이름이 지정된 보조 제어 파일을 가질 수 있습니다롤 토토--버전.Control. 제공되면, 이들은해야합니다 스크립트 파일 디렉토리에 위치하십시오. 보조 제어 파일 기본 제어 파일과 동일한 형식을 따르십시오. 모든 매개 변수 보조 제어 파일에서 설정된 기본 제어 파일을 대체 해당 롤 토토 버전을 설치하거나 업데이트 할 때. 그러나 매개 변수디렉토리anddefault_versiona 보조 제어 파일.

롤 토토자SQL20116_20203시작, 커밋등) 및 실행할 수없는 명령 트랜잭션 블록 내부 (예 :진공). 스크립트 파일이 있기 때문입니다 트랜잭션 블록 내에서 암시 적으로 실행됩니다.

롤 토토자SQL스크립트 파일은로 시작하는 줄도 포함 할 수 있습니다.\ echo, 무시됩니다 (의견으로 취급) 롤 토토 메커니즘에 의해. 이 조항은 일반적으로 사용됩니다 스크립트 파일이 공급되면 오류를 던지십시오PSQL롤 토토 생성(아래의 스크립트 예제 참조). 없이 즉, 사용자는 실수로 롤 토토 내용을로드 할 수 있습니다."느슨한"롤 토토, 회복하기가 약간 지루한 상황 에서.

스크립트 파일에는 지정된 인코딩, 제어 파일에는 일반 ASCII 만 포함되어야합니다. 방법이 없기 때문에PostgreSQL컨트롤을 인코딩하는 것이 무엇인지 알기 위해 파일이 있습니다. 실제로 이것은 사용하려는 경우에만 문제입니다. Extension의 의견에 비 ASCII 문자. 추천 이 경우 연습은 제어 파일을 사용하지 않는 것입니다댓글매개 변수이지만 대신 사용롤 토토에 대한 의견스크립트 파일 내에서 논평.

35.15.3. 롤 토토 재배치

사용자는 종종 롤 토토자에 포함 된 개체를로드하려고합니다. Extension의 저자가 염두에두고 다른 스키마로. 3 가지 지원 수준의 재배치 성이 있습니다.

• 완전히 재배치 가능한 롤 토토은 다른 스키마로 이동할 수 있습니다. 데이터베이스에로드 된 후에도 언제든지. 이것은 완료Alter Extension Set Schema명령은 모든 멤버 객체를 자동으로 이름을 바꿉니다 새로운 스키마. 일반적으로 롤 토토자 인 경우에만 가능합니다 어떤 스키마에 대한 내부 가정이 포함되어 있지 않습니다. 객체가 있습니다. 또한 롤 토토자의 객체는 모두 하나 여야합니다. 시작하는 스키마 (어떤 것도 속하지 않는 개체를 무시 절차 언어와 같은 스키마). 완전히 재배치 할 수 있습니다 설정으로 롤 토토rejocatable = truein 제어 파일.

• 롤 토토은 설치 중에 재배치 할 수 있지만 그렇지 않습니다 나중에. 이것은 일반적으로 롤 토토자의 스크립트 인 경우입니다 예를 들어 파일은 대상 스키마를 명시 적으로 참조해야합니다. 설정에서search_pathSQL의 속성 기능. 그러한 연장을 위해rejocatable = false제어 파일에서@extschema@대상 스키마를 참조하려면 스크립트 파일에서. 이 문자열의 모든 발생은 교체됩니다 스크립트가 실행되기 전에 실제 대상 스키마의 이름으로. 사용자는를 사용하여 대상 스키마를 설정할 수 있습니다.스키마옵션생성 확대.

• 롤 토토자가 재배치를 전혀 지원하지 않으면 설정rejocatable = false제어 파일, 또한 설정스키마의 이름으로 의도 된 대상 스키마. 이것은의 사용을 방지 할 것입니다.스키마옵션생성 확대, 제어 파일. 이 선택은 일반적으로 연장선이 필요합니다 할 수없는 스키마 이름에 대한 내부 가정이 포함되어 있습니다 의 사용으로 대체@extschema@. 그만큼@extschema@대체 메커니즘입니다 이 경우에도 사용 가능하지만 스키마 이름은 제어 파일에 따라 결정됩니다.

모든 경우에 스크립트 파일은로 실행됩니다.search_path처음에는 대상 스키마를 가리 키도록 설정했습니다. 즉,롤 토토 생성이것과 동일합니다 :

@extschema @;에 local search_path를 설정

이것은 스크립트 파일로 생성 된 개체가 안으로 들어갈 수있게 해줍니다. 대상 스키마. 스크립트 파일이 변경 될 수 있습니다search_path원하는 경우 일반적으로 그렇습니다 탐탁지 않은.search_path가 복원됩니다 완료시 이전 설정생성 확대.

대상 스키마는에 의해 결정됩니다스키마제어 파일의 매개 변수입니다 주어진, 그렇지 않으면스키마옵션롤 토토 생성그것이 주어진 경우, 그렇지 않으면 현재 기본 객체 생성 스키마 (첫 번째 기본 객체 제작 스키마 발신자의search_path). 언제 제어 파일스키마매개 변수가 사용됩니다 대상 스키마가 아직 존재하지 않으면 생성됩니다. 다른 두 경우는 이미 존재해야합니다.

전제 조건 롤 토토이 나열된 경우요구제어 파일에서 대상 스키마 의 초기 설정에 추가됩니다.search_path. 이를 통해 객체를 볼 수 있습니다 새로운 롤 토토자의 스크립트 파일에.

relocatable 롤 토토에 객체가 퍼질 수 있지만 여러 스키마에서 일반적으로 모든 것을 배치하는 것이 바람직합니다. 단일 스키마에 외부 사용을위한 객체는 롤 토토자의 대상 스키마를 고려합니다. 그러한 배열이 작동합니다 기본 설정으로 편리하게search_path의존적 생성 중 롤 토토.

35.15.4. 롤 토토 구성 테이블

일부 롤 토토에는 데이터가 포함 된 구성 테이블이 포함됩니다 설치 후 사용자가 추가하거나 변경할 수 있습니다. 롤 토토. 일반적으로 테이블이 롤 토토의 일부인 경우 테이블의 정의 나 그 내용은에 의해 덤프되지 않습니다pg_dump. 그러나 그 행동입니다 구성 테이블의 경우 바람직하지 않습니다. 모든 데이터 변경 사용자는 덤프에 포함되어야합니다. 그렇지 않으면 롤 토토자가 작동합니다. 덤프와 다시로드 후 다르게.

이 문제를 해결하려면 롤 토토자의 스크립트 파일이 테이블 구성 테이블로 생성되었으므로 원인pg_dump테이블을 포함합니다 덤프의 내용 (정의가 아님). 그렇게하려면 전화하십시오 기능pg_extension_config_dump (regclass, 텍스트)테이블을 작성한 후

테이블 작성 my_config (키 텍스트, 값 텍스트);

pg_catalog.pg_extension_config_dump를 선택하십시오 ( 'my_config', '');

이런 식으로 여러 테이블을 표시 할 수 있습니다.

두 번째 인수가pg_extension_config_dump는 빈 문자열입니다 테이블의 전체 내용은pg_dump. 이것은 일반적으로 만약입니다 테이블은 처음에 롤 토토자 스크립트에 의해 생성 된대로 비어 있습니다. 만약에 초기 데이터와 사용자 제공 데이터가 혼합되어 있습니다. 표, 두 번째 논쟁pg_extension_config_dump제공 a여기서덤프 할 데이터를 선택하는 조건. 예를 들어, 할 수 있습니다

테이블 작성 my_config (키 텍스트, 값 텍스트, Standard_Entry boolean);

pg_catalog.pg_extension_config_dump를 선택하십시오 ( 'my_config', 'standard_entry가 아닌 곳');

그런 다음Standard_Entry생성 된 행에서만 사실입니다 Extension의 스크립트에 의해.

초기에 제공되는 행과 같은 더 복잡한 상황 사용자가 수정할 수 있으며 작성하여 처리 할 수 ​​있습니다. 수정 된 행을 보장하기 위해 구성 테이블에서 트리거 올바르게 표시됩니다.

a와 관련된 필터 조건을 변경할 수 있습니다 전화로 구성 테이블pg_extension_config_dump다시. (이것은 할 것이다 일반적으로 롤 토토 업데이트 스크립트에서 유용합니다.) 유일한 방법은 테이블을 더 이상 구성 테이블이 해리하는 것입니다. 롤 토토에서변경 롤 토토 ... 드롭 테이블.

이 테이블 사이의 외국 주요 관계는 그렇습니다 PG_DUMP에 의해 테이블을 버리는 순서를 지시하십시오. 구체적으로, pg_dump는 참조 된 테이블을 덤프하려고 시도합니다 참조 테이블 전에. 외국의 주요 관계가 있습니다 Create Extension Time에서 설정 (데이터가로드되기 전에 표) 원형 의존성은 지원되지 않습니다. 원형 일 때 종속성이 존재하면 데이터는 여전히 덤프되지만 덤프는 직접 복원 할 수 없으며 사용자 개입은 필요합니다.

35.15.5. 롤 토토 업데이트

롤 토토 메커니즘의 한 가지 장점은 그것이 제공한다는 것입니다. 정의하는 SQL 명령에 대한 업데이트를 관리하는 편리한 방법 롤 토토자의 객체. 버전 이름을 연결하여 수행됩니다 또는 릴리스 된 각 버전의 롤 토토자가있는 번호 설치 스크립트. 또한 사용자가 원하는 경우 데이터베이스를 한 버전에서 다음 버전으로 동적으로 업데이트하고 당신은 제공해야합니다스크립트 업데이트한 버전에서 다음 버전으로 이동하는 데 필요한 변경을 수행하십시오. 업데이트 스크립트는 패턴에 따른 이름이 있습니다롤 토토--Oldversion--Newversion.SQL(예 :foo--1.0--1.1.sql수정하라는 명령을 포함합니다 버전1.0롤 토토foo버전1.1).

적절한 업데이트 스크립트를 사용할 수있게되면 명령Alter Extension Updateal 지정된 새 버전에 롤 토토자가 설치되었습니다. 업데이트 스크립트 같은 환경에서 실행됩니다생성 확대설치 스크립트 제공 : 특히,search_path같은 방식으로 설정되었습니다 스크립트에서 생성 된 새 개체는 자동으로 추가됩니다. 연장.

롤 토토자에 보조 제어 파일이있는 경우 컨트롤 업데이트 스크립트에 사용되는 매개 변수는 관련된 매개 변수입니다. 스크립트 대상 (신규) 버전으로.

업데이트 메커니즘을 사용하여 중요한 스페셜을 해결할 수 있습니다. 사례 : a 변환"느슨한"컬렉션 객체를 롤 토토합니다. 롤 토토 메커니즘이 추가되기 전에 에게PostgreSQL(9.1), 많은 사람들은 단순히 분류 된 롤 토토 모듈을 썼습니다 포장되지 않은 물체. 기존 데이터베이스가 포함되어 있습니다 개체, 객체를 올바르게 포장하는 방법으로 어떻게 변환 할 수 있습니까? 확대? 그들을 떨어 뜨린 다음 평범한 일을합니다롤 토토 생성는 한 가지 방법이지만 바람직하지 않습니다 객체에 종속성이있는 경우 (예 : 테이블이있는 경우 롤 토토자에 의해 생성 된 데이터 유형의 열). 고치는 방법 이 상황은 빈 연장을 생성 한 다음 사용하는 것입니다Alter Extension Add각 기존의 첨부 롤 토토자에 반대 한 다음 마지막으로 새로운 개체를 만듭니다. 현재 롤 토토 버전이지만 포장되지 않은 사람이 아닙니다. 풀어 주다.롤 토토 생성이것을 지원합니다 그것의 사례From Old_version옵션으로 인해 그렇지 않습니다 대상 버전의 일반 설치 스크립트를 실행하지만 대신 이름이 지정된 업데이트 스크립트롤 토토--Old_version--target_version.SQL. 선택 더미 버전 이름으로 사용할Old_versionExtension 저자, 그렇지만포장되지 않은는 일반적인 협약입니다. 여러 이전 버전이있는 경우 업데이트 할 수 있어야합니다. 롤 토토 스타일로 여러 더미 버전 이름을 사용하여 식별하십시오. 그들을.

Alter Extension실행할 수 있습니다 요청 된 업데이트를 달성하기 위해 업데이트 스크립트 파일 시퀀스. 을 위한 예, 만 경우foo--1.0--1.1.sqlandfoo--1.1-2.0.sql사용 가능,롤 토토 변경를 적용합니다 버전 업데이트 인 경우 시퀀스2.0IS 요청됨1.0현재입니다 설치.

PostgreSQL가정하지 않습니다 버전 이름의 속성에 대한 모든 것 : 예를 들어, IT 모르겠다1.1다음1.0. 그것은 단지 사용 가능한 것과 일치합니다 버전 이름 및 적용 해야하는 경로를 따릅니다. 가장 적은 업데이트 스크립트. (버전 이름은 실제로 모든 문자열 일 수 있습니다 포함되지 않습니다--또는 주요 또는 후행-.)

때로는 제공하는 것이 유용합니다"다운 그레이드"스크립트, 예를 들어foo--1.1--1.0.sql변경 사항을 되돌릴 수 있습니다 버전과 관련1.1. 당신이한다면 그것은 다운 그레이드 스크립트가 할 가능성에주의를 기울여야합니다. 더 짧은 경로를 생성하기 때문에 예기치 않게 적용됩니다. 그만큼 위험한 사례는가있는 곳입니다."빠른 길"여러 버전을 뛰어 넘는 스크립트를 업데이트하십시오 빠른 경로의 시작점에 대한 다운 그레이드 스크립트. 아마도 다운 그레이드를 적용하기 위해 더 적은 단계를 밟은 다음 빠른 경로를 한 번에 하나의 버전을 앞서 나가려면. 다운 그레이드 스크립트가 떨어지면 대체 할 수없는 모든 물체는 바람직하지 않은 결과를 가져올 것입니다.

예상치 못한 업데이트 경로를 확인하려면이 명령을 사용하십시오.

선택 *에서 pg_extension_update_paths ( 'Extension_name');

이것은 각각의 별개의 알려진 버전 이름 쌍을 보여줍니다. 업데이트 경로 시퀀스와 함께 지정된 롤 토토자 소스 버전에서 대상으로 이동하기 위해 촬영됩니다. 버전, 또는NULL사용 가능한 경우 업데이트 경로. 경로는 텍스트 형식으로 표시됩니다.--분리기. 사용할 수 있습니다regexp_split_to_array (path, '-')선호하는 경우 배열 형식.

35.15.6. 롤 토토 예제

여기에 완전한 예가 있습니다SQL-2 요소 복합재 인 연장 슬롯에 모든 유형의 값을 저장할 수있는 유형"K"및"V". 비 텍스트 값은 스토리지 용 텍스트로 자동 강요됩니다.

스크립트 파일쌍-1.0.sql외모 이와 같이:

- 스크립트가 PSQL에 소스가 생성 된 롤 토토자가 아닌 PSQL에 공급되는 경우 불만 사항
\ echo는 "롤 토토 쌍을 만들기 위해"만들기 "를로드합니다. \그만두다

(k text, v text)로 유형 쌍을 만듭니다.

함수 쌍 생성 또는 교체 (텍스트, 텍스트)
쌍 언어 SQL을 'select row ($ 1, $ 2) ::@extschema@.pair;'로 반환합니다.

연산자 생성 ~ (leftarg = text, rightarg = text, procedure = pair);

- "set search_path"는 쉽게 얻을 수 있지만 자격을 갖춘 이름은 더 잘 수행됩니다.
함수가 낮음 (쌍) 생성 또는 교체
쌍 언어 SQL을 반환합니다
'select row (하위 ($ 1.K), Lower ($ 1.V)) ::@extschema@.pair;'
SET SEARCH_PATH = PG_TEMP;

함수 pair_concat 생성 또는 교체 (쌍, 쌍)
쌍 언어 SQL을 반환합니다
AS 'select row ($ 1.K 운영자 (PG_CATALOG. ||) $ 2.K,
               $ 1.V Operator (PG_CATALOG. ||) $ 2.V) ::@extschema@.pair; ';

제어 파일pair.control룩 이와 같이:

# 쌍 롤 토토
댓글 = '키/값 쌍 데이터 유형'
default_version = '1.0'
regocatable = false

이 두 파일을 올바른 디렉토리, A를 사용할 수 있습니다.makefile이것을 포함하는 :

Extension = 쌍
데이터 = 쌍-1.0.sql

pg_config = pg_config
pgxs : = $ (shell $ (pg_config) --pgxs)
$ (pgxs) 포함

이 makefile의 의존PGXS, 에 설명 된섹션 35.16. 명령설치설치 에 의해보고 된대로 올바른 디렉토리로 컨트롤 및 스크립트 파일PG_CONFIG.

파일이 설치되면를 사용하십시오.롤 토토 생성특정 데이터베이스에 객체.