그메이저 토토 사이트 프로그램 생성명령은 각 메이저 토토 사이트자에 대한 제어 파일에 의존하며, 접미사가 붙은 메이저 토토 사이트자와 동일하게 이름을 지정해야 합니다..control, 설치 위치에 배치되어야 합니다.SHAREDIR/메이저 토토 사이트자디렉토리. 또한 하나 이상 있어야 합니다.SQL이름 지정 패턴을 따르는 스크립트 파일메이저 토토 사이트--버전.sql(예:foo--1.0.sql버전용1.0메이저 토토 사이트자foo). 기본적으로 스크립트 파일은SHAREDIR/메이저 토토 사이트자디렉토리; 그러나 제어 파일은 스크립트 파일에 대해 다른 디렉터리를 지정할 수 있습니다.

메이저 토토 사이트 제어 파일의 파일 형식은 메이저 토토 사이트 제어 파일과 동일합니다.postgresql.conf파일, 즉 다음의 목록매개변수_이름 = 값할당, 한 줄에 하나씩. 에 의해 소개된 빈 줄과 주석#허용됩니다. 단일 단어나 숫자가 아닌 값은 반드시 인용하세요.

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

주 제어 파일에 추가로메이저 토토 사이트.control, 메이저 토토 사이트에는 스타일 이름으로 명명된 보조 제어 파일이 있을 수 있습니다.메이저 토토 사이트--버전.control. 제공된 경우 스크립트 파일 디렉터리에 있어야 합니다. 보조 제어 파일은 기본 제어 파일과 동일한 형식을 따릅니다. 보조 제어 파일에 설정된 모든 매개변수는 해당 버전의 메이저 토토 사이트을 설치하거나 업데이트할 때 기본 제어 파일을 재정의합니다. 그러나 매개변수디렉토리그리고기본_버전보조 제어 파일에는 설정할 수 없습니다.

메이저 토토 사이트 프로그램SQL스크립트 파일에는 트랜잭션 제어 명령을 제외한 모든 SQL 명령이 포함될 수 있습니다(시작, 커밋등) 및 트랜잭션 블록 내에서 실행할 수 없는 명령(예:진공). 이는 스크립트 파일이 트랜잭션 블록 내에서 암시적으로 실행되기 때문입니다.

메이저 토토 사이트 프로그램SQL스크립트 파일에는 다음으로 시작하는 줄도 포함될 수 있습니다.\에코, 메이저 토토 사이트 메커니즘에 의해 무시됩니다(주석으로 처리). 이 조항은 일반적으로 스크립트 파일이 제공되는 경우 오류를 발생시키는 데 사용됩니다.psql다음을 통해 로드되는 대신메이저 토토 사이트 프로그램 생성(다음의 예제 스크립트 참조섹션 38.17.7). 그렇지 않으면 사용자가 실수로 메이저 토토 사이트 프로그램의 콘텐츠를 다음과 같이 로드할 수 있습니다.“느슨한”메이저 토토 사이트보다는 객체를 사용하므로 복구하기가 다소 지루한 상태입니다.

메이저 토토 사이트 스크립트에 문자열이 포함된 경우@extowner@, 해당 문자열은 호출하는 사용자의 (적절하게 인용된) 이름으로 대체됩니다.메이저 토토 사이트 프로그램 만들기또는메이저 토토 사이트 프로그램 변경. 일반적으로 이 기능은 선택한 개체의 소유권을 부트스트랩 수퍼유저가 아닌 호출 사용자에게 할당하기 위해 신뢰할 수 있다고 표시된 메이저 토토 사이트에서 사용됩니다. (그러나 그렇게 할 때는 주의해야 합니다. 예를 들어, 슈퍼유저가 아닌 사람에게 C 언어 기능의 소유권을 할당하면 해당 사용자에 대한 권한 에스컬레이션 경로가 생성됩니다.)

스크립트 파일에는 지정된 인코딩이 허용하는 모든 문자가 포함될 수 있지만 제어 파일에는 일반 ASCII만 포함되어야 합니다. 왜냐하면 그럴 수 있는 방법이 없기 때문입니다.PostgreSQL제어 파일의 인코딩이 무엇인지 알기 위해. 실제로 이는 메이저 토토 사이트 기능의 주석에 ASCII가 아닌 문자를 사용하려는 경우에만 문제가 됩니다. 이 경우 권장되는 방법은 제어 파일을 사용하지 않는 것입니다.코멘트매개변수 대신에 사용메이저 토토 사이트에 대한 의견스크립트 파일 내에서 주석을 설정합니다.

사용자는 종종 메이저 토토 사이트 프로그램 작성자가 염두에 두었던 것과 다른 스키마에 메이저 토토 사이트 프로그램에 포함된 개체를 로드하려고 합니다. 재배치 가능성에는 세 가지 수준이 지원됩니다.

모든 경우에 스크립트 파일은 다음과 같이 실행됩니다.검색_경로처음에는 대상 스키마를 가리키도록 설정되었습니다. 즉,메이저 토토 사이트 프로그램 생성이와 동등한 작업을 수행합니다:

로컬 검색 경로를 @extschema@, pg_temp로 설정;

이것은 스크립트 파일에 의해 생성된 개체가 대상 스키마로 들어갈 수 있도록 허용합니다. 스크립트 파일은 변경될 수 있습니다.검색_경로원한다면, 그러나 일반적으로 바람직하지 않습니다.검색_경로완료되면 이전 설정으로 복원됩니다.메이저 토토 사이트 프로그램 생성.

대상 스키마는 다음에 의해 결정됩니다.스키마매개변수가 제공되면 제어 파일에, 그렇지 않으면스키마옵션메이저 토토 사이트 프로그램 생성그것이 주어지면, 그렇지 않으면 현재 기본 객체 생성 스키마(호출자의 첫 번째 스키마)검색_경로). 제어 파일이 있을 때스키마매개변수가 사용된 경우 대상 스키마가 아직 존재하지 않으면 생성되지만 다른 두 경우에는 이미 존재해야 합니다.

필요한 메이저 토토 사이트 기능이 다음에 나열되어 있는 경우요구제어 파일에서 대상 스키마가 초기 설정에 추가됩니다.검색_경로, 새 메이저 토토 사이트의 대상 스키마를 따릅니다. 이를 통해 해당 개체가 새 메이저 토토 사이트 프로그램의 스크립트 파일에 표시될 수 있습니다.

보안을 위해pg_temp다음의 끝에 자동으로 추가됩니다.검색_경로모든 경우에.

재배치 불가능한 메이저 토토 사이트에는 여러 스키마에 분산된 개체가 포함될 수 있지만 일반적으로 외부 사용을 위한 모든 개체를 메이저 토토 사이트의 대상 스키마로 간주되는 단일 스키마에 배치하는 것이 바람직합니다. 이러한 배열은 기본 설정인와 함께 편리하게 작동합니다.검색_경로종속 메이저 토토 사이트 생성 중.

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

이 문제를 해결하기 위해 메이저 토토 사이트 프로그램의 스크립트 파일은 구성 관계로 생성된 테이블이나 시퀀스를 표시할 수 있으며 이로 인해 발생하는 문제는 다음과 같습니다.pg_dump테이블 또는 시퀀스의 내용(정의가 아님)을 덤프에 포함합니다. 그렇게 하려면 함수를 호출하세요.pg_extension_config_dump(regclass, 텍스트)예를 들어 테이블이나 시퀀스를 생성한 후

CREATE TABLE my_config(키 텍스트, 값 텍스트);
시퀀스 생성 my_config_seq;

SELECT pg_catalog.pg_extension_config_dump('my_config', '');
SELECT pg_catalog.pg_extension_config_dump('my_config_seq', '');

이 방법으로 테이블이나 시퀀스를 얼마든지 표시할 수 있습니다. 다음과 관련된 시퀀스연재또는큰 직렬열도 표시할 수 있습니다.

두 번째 인수가pg_extension_config_dump은 빈 문자열이며 테이블의 전체 내용이 덤프됩니다.pg_dump. 이는 일반적으로 메이저 토토 사이트 스크립트에 의해 생성된 테이블이 처음에 비어 있는 경우에만 정확합니다. 테이블에 초기 데이터와 사용자 제공 데이터가 혼합되어 있는 경우,의 두 번째 인수pg_extension_config_dump제공어디에서35296_35370

CREATE TABLE my_config(키 텍스트, 값 텍스트, 표준 항목 부울);

SELECT pg_catalog.pg_extension_config_dump('my_config', 'standard_entry가 아닌 곳');

그런 다음 다음을 확인하세요standard_entry메이저 토토 사이트 프로그램의 스크립트에 의해 생성된 행에서만 true입니다.

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

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

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

이 테이블 사이의 외래 키 관계는 pg_dump에 의해 테이블이 덤프되는 순서를 결정합니다. 특히 pg_dump는 참조 테이블보다 먼저 참조 테이블을 덤프하려고 시도합니다. 외래 키 관계는 CREATE EXTENSION 시간(데이터가 테이블에 로드되기 전)에 설정되므로 순환 종속성은 지원되지 않습니다. 순환 종속성이 존재하는 경우 데이터는 계속 덤프되지만 덤프를 직접 복원할 수 없으므로 사용자 개입이 필요합니다.

연관된 시퀀스연재또는큰 직렬열의 상태를 덤프하려면 열을 직접 표시해야 합니다. 부모 관계를 표시하는 것만으로는 이 목적에 충분하지 않습니다.

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

적절한 업데이트 스크립트를 사용할 수 있으면 다음 명령메이저 토토 사이트 업데이트 변경설치된 메이저 토토 사이트 기능을 지정된 새 버전으로 업데이트합니다. 업데이트 스크립트는 다음과 동일한 환경에서 실행됩니다.메이저 토토 사이트 프로그램 만들기설치 스크립트 제공: 특히,검색_경로도 같은 방식으로 설정되며 스크립트에 의해 생성된 새 개체는 자동으로 메이저 토토 사이트 프로그램에 추가됩니다. 또한 스크립트가 메이저 토토 사이트 구성원 개체를 삭제하도록 선택하면 자동으로 메이저 토토 사이트 프로그램에서 연결이 해제됩니다.

메이저 토토 사이트 프로그램에 보조 제어 파일이 있는 경우 업데이트 스크립트에 사용되는 제어 매개변수는 스크립트의 대상(새) 버전과 관련된 매개변수입니다.

메이저 토토 사이트 프로그램 변경은 요청된 업데이트를 달성하기 위해 일련의 업데이트 스크립트 파일을 실행할 수 있습니다. 예를 들어 다음과 같은 경우에만foo--1.0--1.1.sql그리고foo--1.1--2.0.sql사용 가능합니다.메이저 토토 사이트 프로그램 변경버전이 업데이트되면 순차적으로 적용됩니다.2.0다음의 경우에 요청됩니다1.0현재 설치되어 있습니다.

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

때때로 제공하는 것이 유용합니다“다운그레이드”스크립트, 예를 들어foo--1.1--1.0.sql버전과 관련된 변경 사항을 되돌릴 수 있도록 허용1.1. 그렇게 하면 다운그레이드 스크립트가 더 짧은 경로를 생성하므로 예기치 않게 적용될 가능성에 주의하십시오. 위험한 경우는 다음과 같습니다.“빠른 경로”여러 버전보다 앞서가는 업데이트 스크립트와 빠른 경로의 시작점으로의 다운그레이드 스크립트입니다. 한 번에 한 버전씩 진행하는 것보다 다운그레이드를 적용한 다음 빠른 경로를 적용하는 데 더 적은 단계가 필요할 수 있습니다. 다운그레이드 스크립트가 대체할 수 없는 개체를 삭제하면 바람직하지 않은 결과가 발생합니다.

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

SELECT * FROM pg_extension_update_paths('메이저 토토 사이트_이름');

이것은 소스 버전에서 대상 버전으로 이동하는 데 사용되는 업데이트 경로 시퀀스와 함께 지정된 메이저 토토 사이트에 대해 알려진 고유한 버전 이름의 각 쌍을 표시합니다. 또는NULL사용 가능한 업데이트 경로가 없는 경우. 경로는 다음과 같은 텍스트 형식으로 표시됩니다.--구분자. 당신은 사용할 수 있습니다regexp_split_to_array(경로,'--')배열 형식을 선호하는 경우.

한동안 사용된 메이저 토토 사이트 기능은 아마도 여러 버전에 존재할 것이며, 이에 대한 작성자는 업데이트 스크립트를 작성해야 합니다. 예를 들어,foo버전의 메이저 토토 사이트명1.0, 1.1및1.2, 업데이트 스크립트가 있어야 합니다foo--1.0--1.1.sql그리고foo--1.1--1.2.sql. 이전포스트그레SQL10, 새로운 스크립트 파일도 생성해야 했습니다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.2이 세 스크립트를 순서대로 실행하면 영광입니다. 처리는 처음 설치한 것과 동일합니다.1.0다음으로 업데이트됨1.2. (와 마찬가지로메이저 토토 사이트 업데이트 변경, 여러 경로를 사용할 수 있는 경우 가장 짧은 경로가 선호됩니다.) 메이저 토토 사이트 프로그램의 스크립트 파일을 이 스타일로 정렬하면 작은 업데이트를 생성하는 데 필요한 유지 관리 노력을 줄일 수 있습니다.

이 스타일로 유지되는 메이저 토토 사이트자를 가진 보조(버전별) 제어 파일을 사용하는 경우, 각 버전에 독립 실행형 설치 스크립트가 없더라도 제어 파일이 필요하다는 점을 명심하십시오. 제어 파일이 해당 버전에 대한 암시적 업데이트 수행 방법을 결정하기 때문입니다. 예를 들어, 만약foo--1.0.control지정요구 = '바'하지만foo의 다른 제어 파일은 그렇지 않습니다. 메이저 토토 사이트 프로그램의 종속성은바다음에서 업데이트할 때 삭제됩니다1.0다른 버전으로.

널리 분산된 메이저 토토 사이트 프로그램은 자신이 차지하는 데이터베이스에 대해 거의 가정하지 않아야 합니다. 따라서 검색 경로 기반 공격으로 인해 손상될 수 없는 안전한 스타일로 메이저 토토 사이트 프로그램에서 제공하는 함수를 작성하는 것이 적절합니다.

다음을 가진 메이저 토토 사이트 프로그램수퍼유저true로 설정된 속성은 설치 및 업데이트 스크립트 내에서 수행되는 작업에 대한 보안 위험도 고려해야 합니다. 악의적인 사용자가 부주의하게 작성된 메이저 토토 사이트 스크립트의 나중에 실행을 손상시켜 해당 사용자가 슈퍼유저 권한을 획득할 수 있도록 하는 트로이 목마 개체를 만드는 것은 그리 어렵지 않습니다.

메이저 토토 사이트자가 표시된 경우신뢰할 수 있는이면 설치 사용자가 해당 설치 스키마를 선택할 수 있습니다. 이 사용자는 슈퍼유저 권한을 얻기 위해 의도적으로 안전하지 않은 스키마를 사용할 수 있습니다. 따라서 신뢰할 수 있는 메이저 토토 사이트 프로그램은 보안 관점에서 극도로 노출되어 있으며 모든 스크립트 명령을 주의 깊게 검사하여 손상될 가능성이 없는지 확인해야 합니다.

함수를 안전하게 작성하는 방법에 대한 조언은 다음에서 제공됩니다.섹션 38.17.6.1아래, 설치 스크립트를 안전하게 작성하는 방법에 대한 조언은 다음에서 제공됩니다.섹션 38.17.6.2.

여기에 완전한 예가 있습니다.SQL-전용 메이저 토토 사이트, 이름이 지정된 슬롯에 모든 유형의 값을 저장할 수 있는 2요소 복합 유형“k”그리고“v”. 텍스트가 아닌 값은 저장을 위해 자동으로 텍스트로 강제 변환됩니다.

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

-- 스크립트가 CREATE EXTENSION을 통하지 않고 psql에서 제공되는 경우 불평합니다.
\echo 이 파일을 로드하려면 "CREATE EXTENSION 쌍"을 사용하십시오. \그만둬

CREATE TYPE 쌍 AS(k 텍스트, v 텍스트);

CREATE FUNCTION 쌍(텍스트, 텍스트)
쌍 LANGUAGE SQL을 'SELECT ROW($1, $2)::@extschema@.pair;'로 반환합니다.

CREATE OPERATOR ~ (LEFTARG = 텍스트, RIGHTARG = 텍스트, FUNCTION = 쌍);

-- "SET search_path"는 이해하기 쉽지만 정규화된 이름은 더 나은 성능을 발휘합니다.
CREATE FUNCTION 하위(쌍)
반환 LANGUAGE SQL 쌍
AS 'SELECT ROW(lower($1.k), lower($1.v))::@extschema@.pair;'
SET 검색_경로 = pg_temp;

함수 생성 pair_concat(쌍, 쌍)
반환 LANGUAGE SQL 쌍
AS 'SELECT ROW($1.k OPERATOR(pg_catalog.||) $2.k,
               $1.v OPERATOR(pg_catalog.||) $2.v)::@extschema@.pair;';

제어 파일pair.control다음과 같습니다:

# 쌍 메이저 토토 사이트
comment = '키/값 쌍 데이터 유형'
default_version = '1.0'
# @extschema@ 사용으로 인해 재배치할 수 없습니다.
재배치 가능 = false

이 두 파일을 올바른 디렉토리에 설치하기 위해 makefile이 거의 필요하지 않지만 다음을 사용할 수 있습니다.메이크파일이 내용을 포함:

메이저 토토 사이트 = 쌍
데이터 = 쌍--1.0.sql

PG_CONFIG = pg_config
PGXS := $(쉘 $(PG_CONFIG) --pgxs)
$(PGXS) 포함

이 makefile은 다음에 의존합니다.PGXS, 설명된 내용은섹션 38.18. 명령설치하기다음에서 보고한 대로 올바른 디렉토리에 제어 및 스크립트 파일을 설치합니다.pg_config.

파일이 설치되면 다음을 사용하십시오.메이저 토토 사이트 프로그램 생성객체를 특정 데이터베이스에 로드하는 명령입니다.