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

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

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

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

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

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

토토 캔 스크립트에 문자열이 포함 된 경우@elevowner@, 그 문자열은 사용자 호출의 (적절하게 인용 된) 이름으로 대체됩니다토토 캔 생성또는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, New 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-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, 여러 경로를 사용할 수 있으면 가장 짧은 경로가 선호됩니다.)이 스타일의 토토 캔자 스크립트 파일을 정리하면 작은 업데이트를 생성하는 데 필요한 유지 보수 노력의 양을 줄일 수 있습니다.

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

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

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

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

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

여기에 완전한 예가 있습니다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, 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,섹션 37.18. 명령설치|PG_CONFIG.

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