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

무지개 토토 제어 파일의 파일 형식은와 동일합니다.postgresql.conf파일, 즉 목록parameter_name = value한 줄 당 과제. 빈 줄과 댓글이 소개#허용됩니다. 단일 단어 나 숫자가 아닌 값을 인용하십시오.

제어 파일은 다음 매개 변수를 설정할 수 있습니다.

기본 제어 파일 외에무지개 토토.control, 무지개 토토자는 스타일에 이름이 지정된 2 차 제어 파일을 가질 수 있습니다무지개 토토--버전.control. 제공된 경우 스크립트 파일 디렉토리에 있어야합니다. 보조 제어 파일은 기본 제어 파일과 동일한 형식을 따릅니다. 보조 제어 파일에 설정된 모든 매개 변수는 해당 버전의 무지개 토토 버전을 설치하거나 업데이트 할 때 기본 제어 파일을 무시합니다. 그러나 매개 변수디렉토리및default_version보조 제어 파일로 설정할 수 없습니다.

무지개 토토자SQL스크립트 파일은 트랜잭션 제어 명령을 제외하고는 SQL 명령을 포함 할 수 있습니다 (시작, 커밋등) 및 트랜잭션 블록 내에서 실행할 수없는 명령 (예 :진공). 스크립트 파일이 트랜잭션 블록 내에서 암시 적으로 실행되기 때문입니다.

무지개 토토자SQL스크립트 파일은로 시작하는 줄도 포함 할 수 있습니다.\ echo, 이것은 무지개 토토 메커니즘에 의해 무시 될 것입니다 (주석으로 취급). 이 조항은 일반적으로 스크립트 파일에 공급되는 경우에 오류를 던지는 데 사용됩니다.PSQL무지개 토토 생성(예제 스크립트 참조섹션 38.17.7). 그 없이는 사용자가 실수로 Extension의 내용을로드 할 수 있습니다.“느슨한”연장이 아닌 물체, 회복하기가 약간 지루한 상황입니다.

무지개 토토 스크립트에 문자열이 포함 된 경우@elegowner@, 그 문자열은 사용자 호출의 (적절하게 인용 된) 이름으로 대체됩니다무지개 토토 생성또는Alter Extension. 일반적 으로이 기능은 Bootstrap 슈퍼 사용자가 아닌 호출 사용자에게 선택한 객체의 소유권을 할당하도록 신뢰할 수있는 무지개 토토에 의해 사용됩니다. (그러나 그렇게하는 데주의를 기울여야합니다. 예를 들어, C-Language 기능의 소유권을 비 슈퍼 러자에게 할당하면 해당 사용자에게 권한 에스컬레이션 경로를 만듭니다.).

스크립트 파일에는 지정된 인코딩이 허용하는 문자가 포함될 수 있지만 제어 파일은 일반 ASCII 만 포함해야합니다.PostgreSQL컨트롤 파일을 인코딩하는 것이 무엇인지 알기 위해. 실제로 이것은 Extension의 주석에서 비 ASCII 문자를 사용하려는 경우에만 문제가됩니다. 이 경우 권장되는 관행은 제어 파일을 사용하지 않는 것입니다댓글매개 변수이지만 대신 사용무지개 토토에 대한 의견주석을 설정하려면 스크립트 파일 내에서.

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

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

로컬 Search_Path를 @extschema @, pg_temp;에 설정하십시오.

스크립트 파일에서 만든 객체가 대상 스키마로 이동할 수 있습니다. 스크립트 파일이 변경 될 수 있습니다search_path원하는 경우 일반적으로 바람직하지 않습니다.search_path완료되면 이전 설정으로 복원되었습니다무지개 토토 생성.

대상 스키마는에 의해 결정됩니다스키마제어 파일의 매개 변수가 제공되는 경우, 그렇지 않으면스키마옵션무지개 토토 생성그렇지 않은 경우, 그렇지 않으면 현재 기본 오브젝트 생성 스키마 (발신자의 첫 번째 기본 개체 스키마search_path). 컨트롤 파일스키마매개 변수가 사용되면 대상 스키마가 아직 존재하지 않으면 대상 스키마가 생성되지만 다른 두 경우에는 이미 존재해야합니다.

전제 조건 무지개 토토이 나열된 경우요구제어 파일에서 대상 스키마가의 초기 설정에 추가됩니다.search_path, 새로운 Extension의 대상 스키마에 따라. 이를 통해 해당 객체가 새로운 Extension의 스크립트 파일에 표시 될 수 있습니다.

보안 용PG_TEMP|search_path모든 경우에.

relocatable이 아닌 무지개 토토에는 여러 schemas에 퍼져있는 객체를 포함 할 수 있지만, 외부 사용을위한 모든 객체를 단일 스키마에 배치하는 것이 바람직합니다.이 스키마는 무지개 토토자의 대상 스키마로 간주됩니다. 이러한 배열은 기본 설정과 편리하게 작동합니다.search_path의존적 무지개 토토을 생성하는 동안.

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

이 문제를 해결하기 위해 무지개 토토자의 스크립트 파일은 구성 관계로 작성된 테이블 또는 시퀀스를 표시 할 수 있습니다.pg_dump덤프에 테이블 또는 시퀀스의 내용 (정의가 아님)을 포함합니다. 그렇게하려면 함수를 호출하십시오pg_extension_config_dump (regclass, text)예를 들어 테이블 또는 시퀀스를 작성한 후

테이블 작성 my_config (키 텍스트, 값 텍스트);
시퀀스를 만듭니다. my_config_seq;

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

여러 테이블이나 시퀀스 가이 방식으로 표시 될 수 있습니다. 관련 시퀀스Serial또는bigserial열도 표시 될 수 있습니다.

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

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

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

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

시퀀스의 경우의 두 번째 인수pg_extension_config_dump효과가 없습니다.

사용자가 수정할 수있는 초기에 제공된 행과 같은 더 복잡한 상황은 구성 테이블에서 트리거를 생성하여 수정 된 행이 올바르게 표시되도록 처리 할 수 ​​있습니다..

호출하여 구성 테이블과 관련된 필터 조건을 변경할 수 있습니다pg_extension_config_dump다시. (이것은 일반적으로 무지개 토토 업데이트 스크립트에서 유용합니다.) 구성 테이블이 더 이상 테이블을 표시하는 유일한 방법은를 사용하여 무지개 토토자에서 해리하는 것입니다.Alter Extension ... 드롭 테이블.

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

관련 시퀀스Serial또는bigserial열은 상태를 직접 표시해야합니다. 부모 관계를 표시하는 것만으로는 충분하지 않습니다.

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

적절한 업데이트 스크립트를 사용할 수있게되면 명령Alter Extension Update지정된 새 버전으로 설치된 무지개 토토자를 업데이트합니다. 업데이트 스크립트는와 같은 환경에서 실행됩니다.무지개 토토 생성설치 스크립트 제공 : 특히search_path같은 방식으로 설정되며 스크립트에서 생성 된 새 개체는 무지개 토토자에 자동으로 추가됩니다. 또한 스크립트가 무지개 토토 멤버 객체를 삭제하기로 선택하면 무지개 토토자에서 자동으로 분리됩니다.

무지개 토토자에 보조 제어 파일이 있으면 업데이트 스크립트에 사용되는 제어 매개 변수는 스크립트의 대상 (신규) 버전과 관련된 것입니다..

Alter Extension요청 된 업데이트를 달성하기 위해 업데이트 스크립트 파일 시퀀스를 실행할 수 있습니다. 예를 들어, 만foo--1.0--1.1.sqlandfoo--1.1-2.0.sql사용 가능합니다,Alter Extension버전 업데이트가있는 경우 순서대로 적용2.01.0현재 설치되었습니다.

PostgreSQL버전 이름의 속성에 대해 아무것도 가정하지 않습니다. 예를 들어,1.1다음1.0. 사용 가능한 버전 이름과 일치하고 가장 적은 업데이트 스크립트를 적용 해야하는 경로를 따릅니다. (버전 이름은 실제로 포함하지 않는 문자열 일 수 있습니다--또는 선도 또는 후행-.)

때로는 제공하는 것이 유용합니다“다운 그레이드”스크립트, 예를 들어foo--1.1--1.0.sql버전과 관련된 변경 사항을 되돌릴 수 있도록1.1. 그렇게하면 더 짧은 경로를 생성하기 때문에 다운 그레이드 스크립트가 예기치 않게 적용될 가능성에주의하십시오. 위험한 사례는 A가있는 곳입니다.“빠른 경로”Fast Path의 시작점으로의 다운 그레이드 스크립트뿐만 아니라 여러 버전을 뛰어 넘는 스크립트를 업데이트하십시오. 한 번에 하나의 버전을 이동하는 것보다 다운 그레이드를 적용하고 빠른 경로를 적용하는 데 더 적은 단계가 필요할 수 있습니다. 다운 그레이드 스크립트가 대체 할 수없는 객체를 떨어 뜨리면 바람직하지 않은 결과를 얻을 수 있습니다.

예기치 않은 업데이트 경로를 확인하려면이 명령을 사용하십시오.

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

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

잠시 동안 주변에 있었던 무지개 토토자는 아마도 여러 버전으로 존재할 것이며, 저자는 업데이트 스크립트를 작성해야합니다. 예를 들어, a를 출시 한 경우foo버전의 무지개 토토1.0, 1.1및1.2, 업데이트 스크립트가 있어야합니다foo--1.0--1.1.sql및foo--1.1-1.2.sql. 전에PostgreSQL10, 새 스크립트 파일도 만들어야했습니다foo--1.1.sql및foo--1.2.sql최신 무지개 토토 버전을 직접 구축하거나 다른 최신 버전을 설치하여 직접 설치할 수없는1.0그런 다음 업데이트. 그것은 지루하고 복제 적 이었지만 지금은 불필요합니다. 왜냐하면무지개 토토 생성업데이트 체인을 자동으로 팔로우 할 수 있습니다. 예를 들어, 스크립트 파일 만foo--1.0.sql, foo--1.0--1.1.sql및foo--1.1-1.2.sql이용 가능 한 다음 버전 설치 요청1.23 개의 스크립트를 순서대로 실행하여 영광입니다. 처리는 처음 설치 한 것과 동일합니다1.0그리고 다음으로 업데이트1.2. (Alter Extension Update, 여러 경로를 사용할 수 있으면 가장 짧은 경로가 선호됩니다.)이 스타일의 Extension의 스크립트 파일을 정리하면 작은 업데이트를 생성하는 데 필요한 유지 보수 노력의 양을 줄일 수 있습니다.

이 스타일로 무지개 토토자가 유지되는 Secondary (버전 특정) 제어 파일을 사용하는 경우, 해당 버전에 대한 암시 적 업데이트가 수행되는 방법을 결정하기 때문에 각 버전에는 독립형 설치 스크립트가 없더라도 제어 파일이 필요합니다. 예를 들어, iffoo--1.0.control지정요구 = 'bar'그러나foo'의 다른 제어 파일은 그렇지 않습니다. Extension의 종속성은bar에서 업데이트 할 때 삭제됩니다1.0다른 버전으로.

광범위하게 분산 된 무지개 토토은 그들이 차지하는 데이터베이스에 대해 거의 가정하지 않아야합니다. 따라서 검색 경로 기반 공격으로 손상 될 수없는 안전한 스타일로 무지개 토토 기능을 제공하는 기능을 작성하는 것이 적절합니다.

SuperUsertrue로 설정된 속성은 설치 및 업데이트 스크립트 내에서 수행 된 작업에 대한 보안 위험을 고려해야합니다. 악의적 인 사용자가 나중에 부주의하게 작성된 무지개 토토 스크립트의 실행을 손상시킬 Trojan-Horse 객체를 만드는 것은별로 어렵지 않습니다. 해당 사용자는 슈퍼 사용자 권한을 획득 할 수 있습니다..

무지개 토토자가 표시된 경우신뢰할 수있는, 설치 사용자는 설치 스키마를 선택할 수 있으며, 슈퍼 사용자 권한을 얻기 위해 불안한 스키마를 의도적으로 사용할 수 있습니다. 따라서 신뢰할 수있는 무지개 토토은 보안 관점에서 극도로 노출되며, 모든 스크립트 명령을 신중하게 검사하여 타협이 없도록해야합니다.

작문 기능에 대한 조언은 안전하게 제공됩니다섹션 38.17.6.1아래, 설치 스크립트 작성에 대한 조언은 단단히 제공됩니다섹션 38.17.6.2.

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

스크립트 파일쌍-1.0.sql다음과 같습니다.

- 스크립트가 PSQL에 소스 된 경우, Create Extension을 통한 것이 아니라 PSQL에 불만을 제기합니다.
\ echo는 "무지개 토토 쌍을 만들기 위해"만들기 "를로드합니다. \그만두다

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

기능 쌍 만들기 (텍스트, 텍스트)
쌍 언어 SQL을 'select row ($ 1, $ 2) ::@extschema@.pair;'로 반환합니다.

연산자 생성 ~ (leftarg = text, rightarg = text, function = 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'
# extschema @의 사용으로 인해 # 재배치 할 수 없습니다.
regocatable = false

이 두 파일을 올바른 디렉토리에 설치하려면 makefile이 거의 필요하지 않지만 A를 사용할 수 있습니다.MakeFile이것 포함 :

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

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

이 makefile의 의존PGXS,섹션 38.18. 명령설치|PG_CONFIG.

파일이 설치되면를 사용하십시오.무지개 토토 생성객체를 특정 데이터베이스에로드하도록 명령.