토토 생성

복합 토토

첫 번째 형태토토 생성복합 토토을 생성합니다. 복합 토토은 속성 이름 및 데이터 유형 목록으로 지정됩니다. 해당 데이터 유형이 조합 가능한 경우 속성의 조합도 지정할 수 있습니다. 복합 토토은 기본적으로 테이블의 행 유형과 동일하지만,토토 생성유형 정의만 원하는 경우 실제 테이블을 생성할 필요가 없습니다. 독립형 복합 토토은 예를 들어 함수의 인수 또는 반환 유형으로 유용합니다.

복합 토토을 생성하려면 다음이 있어야 합니다.사용모든 속성 토토에 대한 권한.

열거 토토

두 번째 형태의토토 생성에 설명된 대로 열거(열거) 유형을 생성합니다.PostgreSQL : 문서 : 9.6 : 열거 된 범퍼카 토토. 열거형 토토은 인용된 라벨 목록을 취하며 각 라벨은 다음보다 작아야 합니다.NAMEDATALEN바이트 길이(표준 64바이트PostgreSQL빌드). (레이블이 없는 열거 토토을 생성할 수 있지만 다음을 사용하여 하나 이상의 레이블이 추가되기 전에는 이러한 유형을 사용하여 값을 보유할 수 없습니다.PostgreSQL : 문서 : 9.6 : 토토 사이트 Type.)

범위 토토

의 세 번째 형태토토 생성에 설명된 대로 새 범위 토토을 생성합니다.PostgreSQL : 문서 : 9.6 : 범퍼카 토토 유형.

범위 토토하위 토토범위 토토의 값 순서를 결정하기 위해 관련 b-트리 연산자 클래스가 있는 모든 유형일 수 있습니다. 일반적으로 하위 토토의 기본 b-트리 연산자 클래스는 순서를 결정하는 데 사용됩니다. 기본이 아닌 연산자 클래스를 사용하려면 해당 이름을 다음과 같이 지정하십시오.subtype_opclass. 하위 토토이 조합 가능하고 범위 순서에서 기본이 아닌 데이터 정렬을 사용하려는 경우, 다음을 사용하여 원하는 데이터 정렬을 지정하십시오.조합옵션.

선택사항표준함수는 정의된 범위 토토의 인수 하나를 가져와서 동일한 유형의 값을 반환해야 합니다. 해당되는 경우 범위 값을 표준 형식으로 변환하는 데 사용됩니다. 참조섹션 8.17.816412_16448표준함수는 범위 토토을 선언하기 전에 정의해야 하기 때문에 약간 까다롭습니다. 이렇게 하려면 먼저 이름과 소유자 외에는 속성이 없는 자리 표시자 유형인 셸 유형을 만들어야 합니다. 이는 다음 명령을 실행하여 수행됩니다.토토 생성이름, 추가 매개변수 없음. 그런 다음 쉘 토토을 인수와 결과로 사용하여 함수를 선언하고, 마지막으로 동일한 이름을 사용하여 범위 토토을 선언할 수 있습니다. 그러면 쉘 토토 항목이 유효한 범위 토토으로 자동으로 대체됩니다.

선택사항subtype_diff함수는 두 개의 값을 취해야 합니다.하위 토토인수로 입력하고 a를 반환합니다.배정밀도주어진 두 값 사이의 차이를 나타내는 값입니다. 이는 선택 사항이지만 이를 제공하면 범위 토토의 열에서 GiST 인덱스의 효율성이 훨씬 높아집니다. 참조섹션 8.17.8더 많은 정보를 원하시면.

기본 토토

의 네 번째 형태토토 생성새 기본 토토(스칼라 유형)을 생성합니다. 새 기본 토토을 생성하려면 수퍼유저여야 합니다. (잘못된 유형 정의로 인해 서버가 혼란을 겪거나 충돌이 발생할 수 있기 때문에 이러한 제한이 적용되었습니다.)

매개변수는 위에 설명된 것뿐만 아니라 어떤 순서로도 나타날 수 있으며 대부분은 선택 사항입니다. 두 개 이상의 기능을 등록해야 합니다(를 사용하여)함수 생성) 유형을 정의하기 전에. 지원 기능입력_함수그리고출력_기능반드시 함수는 필수입니다.receive_function, send_function, type_modifier_input_function, type_modifier_output_function그리고분석_기능선택사항입니다. 일반적으로 이러한 함수는 C 또는 다른 저수준 언어로 코딩되어야 합니다.

그input_function유형의 외부 텍스트 표현을 해당 유형에 정의된 연산자 및 함수에서 사용하는 내부 표현으로 변환합니다.출력_기능역변환을 수행합니다. 입력 함수는 다음 유형의 인수 하나를 사용하여 선언할 수 있습니다.cstring또는 세 가지 유형의 인수를 사용하여cstring, oid, 정수. 첫 번째 인수는 C 문자열의 입력 텍스트이고, 두 번째 인수는 유형의 자체 OID이며(대신 요소 유형의 OID를 받는 배열 토토은 제외), 세 번째는typmod19358_19935cstring. NULL 값에 대해서는 출력 함수가 호출되지 않습니다.

선택사항receive_function유형의 외부 바이너리 표현을 내부 표현으로 변환합니다. 이 함수가 제공되지 않으면 해당 유형은 이진 입력에 참여할 수 없습니다. 이진 표현은 내부 형식으로 변환하는 비용이 저렴하고 이식성이 뛰어나도록 선택해야 합니다. (예를 들어, 표준 정수 데이터 유형은 외부 바이너리 표현으로 네트워크 바이트 순서를 사용하는 반면 내부 표현은 머신의 기본 바이트 순서를 사용합니다.) 수신 기능은 값이 유효한지 확인하기 위해 적절한 검사를 수행해야 합니다. 수신 함수는 다음 유형의 인수 하나를 사용하여 선언할 수 있습니다.내부또는 세 가지 유형의 인수를 사용하여내부, oid, 정수. 첫 번째 인수는 a에 대한 포인터입니다.문자열정보수신된 바이트 문자열을 보유하는 버퍼; 선택적 인수는 텍스트 입력 함수와 동일합니다. 수신 함수는 데이터 유형 자체의 값을 반환해야 합니다. 일반적으로 수신 함수는 STRICT로 선언해야 합니다. 그렇지 않은 경우 NULL 입력 값을 읽을 때 NULL 첫 번째 매개변수로 호출됩니다. 이 경우 오류가 발생하지 않는 한 함수는 여전히 NULL을 반환해야 합니다. (이 경우는 주로 NULL 입력을 거부해야 할 수 있는 도메인 수신 기능을 지원하기 위한 것입니다.) 마찬가지로 선택적send_function내부 표현에서 외부 바이너리 표현으로 변환합니다. 이 함수가 제공되지 않으면 해당 유형은 이진 출력에 참여할 수 없습니다. 보내기 함수는 새로운 데이터 유형의 인수 하나를 취하도록 선언되어야 합니다. 보내기 함수는 유형을 반환해야 합니다.바이테아. NULL 값에 대해서는 보내기 함수가 호출되지 않습니다.

이 시점에서 당신은 새로운 유형이 생성되기 전에 생성되어야 할 때 입력 및 출력 함수가 새로운 유형의 결과 또는 인수를 갖도록 어떻게 선언할 수 있는지 궁금해해야 합니다. 대답은 유형이 먼저 다음과 같이 정의되어야 한다는 것입니다.쉘 토토은 이름과 소유자 외에는 속성이 없는 자리 표시자 유형입니다. 이는 다음 명령을 실행하여 수행됩니다.토토 생성이름, 추가 매개변수 없음. 그런 다음 쉘 토토을 참조하여 C I/O 함수를 정의할 수 있습니다. 마지막으로,토토 생성전체 정의를 사용하면 셸 항목을 완전하고 유효한 유형 정의로 대체한 후 새 유형을 정상적으로 사용할 수 있습니다.

선택사항type_modifier_input_function그리고type_modifier_output_function유형이 수정자를 지원하는 경우 필요합니다. 즉, 유형 선언에 첨부된 선택적 제약 조건입니다.문자(5)또는숫자(30,2). PostgreSQL사용자 정의 유형이 하나 이상의 간단한 상수 또는 식별자를 수정자로 사용할 수 있습니다. 그러나 이 정보는 시스템 카탈로그에 저장하기 위해 음수가 아닌 단일 정수 값으로 압축될 수 있어야 합니다.type_modifier_input_functiona 형식으로 선언된 수정자가 전달됩니다.cstring배열. 값의 유효성을 확인해야 하며(잘못된 경우 오류 발생) 값이 정확하면 음수가 아닌 단일 값을 반환합니다.정수컬럼으로 저장될 값"typmod". 토토에 가 없으면 토토 수정자가 거부됩니다.type_modifier_input_function.type_modifier_output_function내부 정수 typmod 값을 사용자 표시를 위한 올바른 형식으로 다시 변환합니다. a를 반환해야 합니다.cstring유형 이름에 추가할 정확한 문자열인 값입니다. 예를 들어숫자의 함수가 반환될 수 있습니다.(30,2). 를 생략할 수 있습니다.type_modifier_output_function, 이 경우 기본 표시 형식은 괄호로 묶인 저장된 typmod 정수 값입니다.

선택사항분석_기능해당 데이터 토토의 열에 대해 토토별 통계 수집을 수행합니다. 기본적으로,분석유형을 사용하여 통계 수집을 시도합니다"같음"그리고"미만"연산자, 해당 유형에 대한 기본 b-트리 연산자 클래스가 있는 경우. 스칼라 유형이 아닌 경우 이 동작은 적합하지 않을 수 있으므로 사용자 정의 분석 함수를 지정하여 재정의할 수 있습니다. 분석 함수는 다음 유형의 단일 인수를 사용하도록 선언되어야 합니다.내부, 그리고 a를 반환합니다.부울결과. 분석 기능에 대한 자세한 API는 다음과 같습니다.src/include/commands/vacuum.h.

새 유형의 내부 표현에 대한 세부사항은 해당 유형과 함께 작동하기 위해 생성한 I/O 함수 및 기타 함수에만 알려져 있지만 다음과 같이 선언되어야 하는 내부 표현의 여러 속성이 있습니다.PostgreSQL. 그 중 가장 중요한 것은내부 길이. 기본 데이터 토토은 고정 길이일 수 있습니다. 이 경우내부 길이은 설정으로 표시되는 양의 정수 또는 가변 길이입니다.내부 길이에변수. (내부적으로는 설정으로 표현됩니다.타이플렌to -1.) 모든 가변 길이 유형의 내부 표현은 해당 유형 값의 전체 길이를 제공하는 4바이트 정수로 시작해야 합니다. (길이 필드는 다음에 설명된 대로 인코딩되는 경우가 많습니다.PostgreSQL : 문서 : 9.6 : 토토 사이트; 직접 액세스하는 것은 현명하지 않습니다.)

선택적 플래그PASSEDBYVALUE은 이 데이터 유형의 값이 참조가 아닌 값으로 전달됨을 나타냅니다. 값으로 전달된 유형은 고정 길이여야 하며 내부 표현은의 크기보다 클 수 없습니다.데이텀토토(일부 시스템에서는 4바이트, 다른 시스템에서는 8바이트).

그정렬매개변수는 데이터 유형에 필요한 저장소 정렬을 지정합니다. 허용되는 값은 1, 2, 4 또는 8바이트 경계의 정렬과 동일합니다. 가변 길이 유형은 반드시 를 포함하므로 최소한 4의 정렬을 가져야 합니다.int4첫 번째 구성요소로.

그저장매개변수를 사용하면 가변 길이 데이터 유형에 대한 저장 전략을 선택할 수 있습니다. (만일반고정 길이 유형에 허용됩니다.)일반해당 유형의 데이터가 항상 인라인으로 저장되고 압축되지 않도록 지정합니다.확장시스템이 먼저 긴 데이터 값을 압축하려고 시도하고 값이 여전히 너무 길면 기본 테이블 행 밖으로 값을 이동하도록 지정합니다.외부값을 기본 테이블 밖으로 이동할 수 있지만 시스템은 값을 압축하려고 시도하지 않습니다.메인압축을 허용하지만 값을 기본 테이블 밖으로 이동하는 것은 권장하지 않습니다. (이 저장 전략을 사용하는 데이터 항목은 행을 맞추는 다른 방법이 없는 경우 기본 테이블 밖으로 이동할 수 있지만 우선적으로 기본 테이블에 유지됩니다.확장그리고외부항목.)

모두저장이외의 값일반데이터 유형의 함수가 다음과 같은 값을 처리할 수 있음을 암시구운, 설명된 대로PostgreSQL : 문서 : 9.6 : 토토 사이트그리고섹션 36.11.1. 제공된 특정 다른 값은 단지 토스트 가능한 데이터 유형의 열에 대한 기본 TOAST 저장 전략을 결정합니다. 사용자는 다음을 사용하여 개별 열에 대해 다른 전략을 선택할 수 있습니다.테이블 세트 저장소 변경.

그like_type매개변수는 데이터 유형의 기본 표현 속성을 지정하는 대체 방법을 제공합니다. 기존 유형에서 복사하는 것입니다. 의 값내부 길이, passedbyvalue, 정렬및저장이름이 지정된 유형에서 복사됩니다. (일반적으로 바람직하지 않지만 이러한 값 중 일부를 다음과 함께 지정하여 재정의하는 것이 가능합니다.좋아요절.) 이러한 방식으로 표현을 지정하는 것은 새로운 유형의 저수준 구현에 특히 유용합니다."피기백"어떤 방식으로든 기존 토토에 적용됩니다.

그범주그리고선호매개변수는 모호한 상황에서 적용될 암시적 형변환을 제어하는 데 도움이 될 수 있습니다. 각 데이터 유형은 단일 ASCII 문자로 명명된 범주에 속하며 각 유형은 다음 중 하나입니다."선호"또는 해당 카테고리에 속하지 않습니다. 이 규칙이 오버로드된 함수나 연산자를 해결하는 데 도움이 되는 경우 파서는 선호하는 유형(단, 동일한 범주 내의 다른 유형에서만)으로 캐스팅하는 것을 선호합니다. 자세한 내용은 참조PostgreSQL : 문서 : 9.6 : 토토 결과 변환. 다른 유형에 대한 암시적 캐스트가 없는 유형의 경우 이러한 설정을 기본값으로 두는 것으로 충분합니다. 그러나 암시적 캐스트가 있는 관련 유형 그룹의 경우 모두 카테고리에 속하는 것으로 표시하고 다음 중 하나 또는 두 개를 선택하는 것이 도움이 되는 경우가 많습니다."가장 일반적인"유형이 카테고리 내에서 선호되는 유형입니다.범주매개변수는 숫자 또는 문자열 유형과 같은 기존 내장 범주에 사용자 정의 유형을 추가할 때 특히 유용합니다. 그러나 새로운 전체 사용자 정의 유형 범주를 생성하는 것도 가능합니다. 이러한 카테고리의 이름을 지정하려면 대문자 이외의 ASCII 문자를 선택하세요.

사용자가 데이터 유형의 열을 null 값이 아닌 다른 값으로 기본값으로 지정하려는 경우 기본값을 지정할 수 있습니다. 를 사용하여 기본값을 지정합니다.기본값키워드. (이러한 기본값은 명시적으로 재정의될 수 있습니다.기본값특정 열에 연결된 절입니다.)

유형이 배열임을 나타내려면, 다음을 사용하여 배열 요소의 유형을 지정하십시오.요소키워드. 예를 들어 4바이트 정수 배열을 정의하려면(int4), 지정요소 = int4. 배열 토토에 대한 자세한 내용은 아래에 나와 있습니다.

이 유형의 배열 외부 표현에서 값 사이에 사용되는 구분 기호를 나타내려면,구분자특정 문자로 설정할 수 있습니다. 기본 구분 기호는 쉼표()입니다.,). 구분 기호는 배열 토토 자체가 아니라 배열 요소 유형과 연결되어 있습니다.

선택적 부울 매개변수인 경우조합 가능이 true이면 해당 유형의 열 정의 및 표현식은 다음을 사용하여 데이터 정렬 정보를 전달할 수 있습니다.콜레이트절. 실제로 데이터 정렬 정보를 활용하는 것은 해당 유형에서 작동하는 함수의 구현에 달려 있습니다. 이는 유형을 조합 가능으로 표시하는 것만으로는 자동으로 발생하지 않습니다.

배열 토토

사용자 정의 유형이 생성될 때마다PostgreSQL자동으로 연관된 배열 토토을 생성합니다. 이 유형의 이름은 요소 유형 이름 앞에 밑줄이 추가되고 필요한 경우 잘려서 다음보다 작게 유지됩니다.NAMEDATALEN바이트 길이입니다. (생성된 이름이 기존 유형 이름과 충돌하는 경우 충돌하지 않는 이름을 찾을 때까지 프로세스가 반복됩니다.) 이 암시적으로 생성된 배열 토토은 가변 길이이며 내장 입력 및 출력 함수를 사용합니다.array_in그리고array_out. 배열 토토은 해당 요소 유형의 소유자 또는 스키마의 변경 사항을 추적하고 요소 유형이 다음과 같은 경우 삭제됩니다.

이유가 왜 있는지 합리적으로 물어볼 수 있습니다.요소옵션, 시스템이 자동으로 올바른 배열 토토을 만드는 경우. 유용하게 사용할 수 있는 유일한 경우요소은 내부적으로 동일한 여러 항목의 배열인 고정 길이 유형을 만들고 해당 유형 전체에 제공하려는 모든 작업 외에도 첨자를 통해 이러한 항목에 직접 액세스할 수 있도록 하려는 경우입니다. 예를 들어 다음을 입력하세요.점는 다음을 사용하여 액세스할 수 있는 두 개의 부동 소수점 숫자로 표시됩니다.점[0]그리고점[1]. 이 기능은 내부 형식이 정확히 동일한 고정 길이 필드의 시퀀스인 고정 길이 유형에만 작동합니다. 첨자 가능한 가변 길이 유형에는 다음에서 사용되는 일반화된 내부 표현이 있어야 합니다.array_in그리고array_out. 역사적인 이유로(즉, 이는 분명히 잘못된 것이지만 변경하기에는 너무 늦음) 고정 길이 배열 토토의 첨자는 가변 길이 배열의 경우가 아닌 0부터 시작합니다.