35.15. 관련 객체를 토토 결과로 포장

35.15.1. 확장 객체 정의

광범위하게 분산 된 확장은 그들이 차지하는 데이터베이스에 대해 거의 가정하지 않아야합니다. 특히 발행하지 않는 한set search_path = pg_temp, 각 자격이없는 이름이 악의적 인 사용자가 정의한 객체로 해결 될 수 있다고 가정합니다. 의존하는 구성을 조심하십시오search_path암시 적으로 :inandCASE표현when항상 검색 경로를 사용하여 연산자를 선택하십시오. 그들의 대신 사용연산자 (스키마. =) anyand케이스표현.

35.15.2. 확장 파일

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

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

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

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

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

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

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

35.15.3. 확장 재배치

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

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

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

• 확장자가 재배치를 전혀 지원하지 않으면 설정rejocatable = false제어 파일에서스키마의도 된 대상 스키마의 이름으로. 이것은의 사용을 방지 할 것입니다.스키마옵션확장 생성, 제어 파일에 명명 된 동일한 스키마를 지정하지 않는 한. 이 선택은 일반적으로 확장자에 |@extschema@. 그만큼@extschema@스키마 이름이 제어 파일에 의해 결정되기 때문에 제한된 사용이지만이 경우에도 대체 메커니즘을 사용할 수 있습니다.

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

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

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

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

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

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

35.15.4. 확장 구성 테이블

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

이 문제를 해결하기 위해 확장자의 스크립트 파일은 구성 테이블로 작성된 테이블을 표시 할 수 있습니다.pg_dump덤프에 테이블의 내용 (정의가 아님)을 포함합니다. 그렇게하려면 함수를 호출하십시오pg_extension_config_dump (regclass, text)테이블을 만든 후

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

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

테이블 수는 이런 식으로 표시 될 수 있습니다.

두 번째 인수가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다시. (이것은 일반적으로 확장 업데이트 스크립트에서 유용합니다.) 구성 테이블이 더 이상 테이블을 표시하는 유일한 방법은를 사용하여 확장자에서 해리하는 것입니다.Alter Extension ... 드롭 테이블.

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

35.15.5. 확장 업데이트

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

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

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

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

Alter Extension요청 된 업데이트를 달성하기 위해 업데이트 스크립트 파일 시퀀스를 실행할 수 있습니다. 예를 들어, 만foo--1.0--1.1.sqlandfoo--1.1-2.0.sql사용 가능,Alter Extension버전 업데이트가있는 경우 순서대로 적용2.0요청됩니다1.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, '-')배열 형식을 선호하는 경우

35.15.6. 확장 예제

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

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

- 스크립트가 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

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

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

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

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

파일이 설치되면를 사용하십시오.PostgreSQL : 문서 : 9.4 : 메이저 토토 사이트 생성객체를 특정 데이터베이스에로드하도록 명령.