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

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

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

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

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

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

스크립트 파일에는 지정된 인코딩이 허용하는 모든 문자가 포함될 수 있지만 제어 파일에는 일반 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제공어디에서32841_32915

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 명령에 대한 업데이트를 관리하는 편리한 방법을 제공한다는 것입니다. 이는 버전 이름이나 번호를 스포츠 토토 베트맨 설치 스크립트의 출시된 각 버전과 연결하여 수행됩니다. 또한 사용자가 데이터베이스를 한 버전에서 다음 버전으로 동적으로 업데이트할 수 있도록 하려면 다음을 제공해야 합니다.업데이트 스크립트한 버전에서 다음 버전으로 이동하는 데 필요한 변경을 수행합니다. 업데이트 스크립트에는 패턴을 따르는 이름이 있습니다.스포츠 토토 베트맨--old_version--target_version.sql(예를 들어,foo--1.0--1.1.sql버전 수정 명령이 포함되어 있습니다1.0스포츠 토토 베트맨foo버전으로1.1).

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

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

업데이트 메커니즘은 중요한 특수 사례를 해결하는 데 사용될 수 있습니다: a“느슨한”개체를 스포츠 토토 베트맨으로 수집합니다. 스포츠 토토 베트맨 메커니즘이 추가되기 전PostgreSQL(9.1에서) 많은 사람들이 단순히 여러 가지 포장되지 않은 개체를 생성하는 스포츠 토토 베트맨 모듈을 작성했습니다. 이러한 개체가 포함된 기존 데이터베이스가 있는 경우 해당 개체를 적절하게 패키지된 스포츠 토토 베트맨으로 어떻게 변환할 수 있습니까? 그것들을 떨어뜨린 다음 일반 작업을 수행합니다.스포츠 토토 베트맨 프로그램 만들기는 일방향이지만 개체에 종속성이 있는 경우에는 바람직하지 않습니다(예: 스포츠 토토 베트맨 프로그램에서 생성된 데이터 유형의 테이블 열이 있는 경우). 이 상황을 해결하는 방법은 빈 스포츠 토토 베트맨을 만든 다음 다음을 사용하는 것입니다.스포츠 토토 베트맨 프로그램 변경 추가기존의 각 개체를 스포츠 토토 베트맨에 연결한 다음 마지막으로 현재 스포츠 토토 베트맨 버전에는 있지만 패키지 해제된 릴리스에는 없었던 새 개체를 생성합니다.스포츠 토토 베트맨 프로그램 생성이 사례를 뒷받침합니다발신 이전_버전옵션, 대상 버전에 대한 일반 설치 스크립트를 실행하지 않고 대신 이름이 지정된 업데이트 스크립트를 실행하게 함스포츠 토토 베트맨--이전_버전--대상_버전.sql. 사용할 더미 버전 이름 선택이전_버전스포츠 토토 베트맨 프로그램 작성자에게 달려 있지만패키지 해제됨일반적인 규칙입니다. 이전 버전이 여러 개 있는 경우 스포츠 토토 베트맨 스타일로 업데이트할 수 있어야 하며 여러 더미 버전 이름을 사용하여 식별하세요.

스포츠 토토 베트맨 프로그램 변경요청된 업데이트를 달성하기 위해 일련의 업데이트 스크립트 파일을 실행할 수 있습니다. 예를 들어 다음과 같은 경우에만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로 설정된 속성은 설치 및 업데이트 스크립트 내에서 수행되는 작업에 대한 보안 위험도 고려해야 합니다. 악의적인 사용자가 부주의하게 작성된 스포츠 토토 베트맨 스크립트의 나중에 실행을 손상시켜 해당 사용자가 슈퍼유저 권한을 획득할 수 있도록 하는 트로이 목마 개체를 만드는 것은 그리 어렵지 않습니다.

함수를 안전하게 작성하는 방법에 대한 조언은 다음에서 제공됩니다.섹션 37.15.6.1아래, 설치 스크립트를 안전하게 작성하는 방법에 대한 조언은 다음에서 제공됩니다.섹션 37.15.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 = 텍스트, PROCEDURE = 쌍);

-- "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, 설명된 내용은섹션 37.16. 명령설치하기다음에서 보고한 대로 올바른 디렉토리에 제어 및 스크립트 파일을 설치합니다.pg_config.

파일이 설치되면 다음을 사용하십시오.스포츠 토토 베트맨 프로그램 만들기객체를 특정 데이터베이스에 로드하는 명령입니다.