이 문서는 지원되지 않는 버전의 PostgreSQL을위한 것입니다.
당신은에 대해 같은 페이지를 볼 수 있습니다PostgreSQL : 문서 : 17 : 36.13. 사용자 정의 토토 캔버전 또는 위에 나열된 다른 지원 버전 중 하나입니다.

37.13.사용자 정의 유형

설명대로섹션 37.2,postgresql새로운 데이터 유형을 지원하도록 확장 할 수 있습니다. 이 섹션에서는 새로운 기본 유형을 정의하는 방법에 대해 설명합니다. 새로운 기본 유형은 아래에 정의 된 데이터 유형입니다.SQL언어. 새 기본 범퍼카 토토을 만들면 저수준 언어로 범퍼카 토토에서 작동하는 기능을 구현해야합니다. 일반적으로 C

이 섹션의 예는에서 찾을 수 있습니다.complex.sqlandcomplex.cinSRC/Tutorial소스 분포의 디렉토리. 참조readme예제 실행에 대한 지침을 위해 해당 디렉토리의 파일.

사용자 정의 범퍼카 토토에는 항상 입력 및 출력 기능이 있어야합니다. 이러한 기능은 범퍼카 토토이 문자열에 나타나는 방법 (사용자의 입력 및 사용자에 대한 출력)과 메모리에서 범퍼카 토토을 구성하는 방법을 결정합니다.

우리가 범퍼카 토토을 정의하고 싶다고 가정복잡한이것은 복소수를 나타냅니다. 메모리에서 복소수를 나타내는 자연스러운 방법은 다음 C 구조입니다.

typedef struct complex

우리는 이것을 단일에 맞지 않기 때문에 너무 크기 때문에이를 통과 할 수있는 범퍼카 토토으로 만들어야합니다Datumvalue.

범퍼카 토토의 외부 문자열 표현으로서 양식 문자열을 선택합니다(x, y).

입력 및 출력 함수는 일반적으로 쓰기가 어렵지 않습니다. 특히 출력 기능. 그러나 범퍼카 토토의 외부 문자열 표현을 정의 할 때는 결국 입력 기능으로 해당 표현에 대한 완전하고 강력한 파서를 작성해야합니다.

pg_function_info_v1 (complex_in);

출력 함수는 단순히 다음과 같습니다.

pg_function_info_v1 (complex_out);

입력 및 출력 함수를 서로 역전시키기 위해주의해야합니다. 그렇지 않으면 데이터를 파일에 버려야 할 때 심각한 문제가 발생하여 다시 읽습니다. 이는 부동 소수점 번호가 관련 될 때 특히 일반적인 문제입니다..

선택적으로, 사용자 정의 범퍼카 토토은 이진 입력 및 출력 루틴을 제공 할 수 있습니다. 바이너리 I/O는 일반적으로 더 빠르지 만 텍스트 I/O보다 휴대성이 떨어집니다.복잡한, 우리는 타입 용 바이너리 I/O 변환기에서 피기 백float8:

pg_function_info_v1 (complex_recv);

우리가 I/O 함수를 작성하고 공유 라이브러리로 편집 한 후에는를 정의 할 수 있습니다복잡한SQL을 입력하십시오. 먼저 우리는 그것을 쉘 유형으로 선언합니다 :

범퍼카 토토 생성 단지;

이것은 I/O 함수를 정의하면서 범퍼카 토토을 참조 할 수있는 자리 표시 자 역할을합니다. 이제 우리는 I/O 함수를 정의 할 수 있습니다 :

CREATE COMPLEX_IN (CSTRING)filename'filename'filename'filename'

마지막으로 데이터 범퍼카 토토의 전체 정의를 제공 할 수 있습니다.

범퍼카 토토 Complex (

새 기본 범퍼카 토토을 정의 할 때PostgreSQL해당 범퍼카 토토의 배열을 자동으로 제공합니다. 배열 범퍼카 토토은 일반적으로 밑줄 문자가있는 기본 범퍼카 토토과 동일한 이름을 갖습니다 (_) Prefended.

일단 데이터 유형이 존재하면 데이터 유형에 유용한 작업을 제공하기 위해 추가 기능을 선언 할 수 있습니다. 그런 다음 연산자를 함수 꼭대기에 정의 할 수 있으며 필요한 경우 데이터 유형의 인덱싱을 지원하기 위해 작업자 클래스를 작성할 수 있습니다.

데이터 범퍼카 토토의 내부 표현이 가변 길이 인 경우 내부 표현은 가변 길이 데이터의 표준 레이아웃을 따라야합니다. 처음 4 바이트는 A이어야합니다.17999_18008직접 액세스하지 않은 필드 (관습 적으로 명명 된VL_LEN_). 사용해야합니다.set_varsize ()매크로이 필드에 기준 (길이 필드 자체 포함)의 총 크기를 저장하고varsize ()검색하려면. (이 매크로는 길이 필드가 플랫폼에 따라 인코딩 될 수 있기 때문에 존재합니다.)

자세한 내용은 설명을 참조하십시오.범퍼카 토토 만들기명령.

37.13.1.토스트 고려 사항

데이터 범퍼카 토토의 값이 크기가 다르면 (내부 형태) 일반적으로 데이터 범퍼카 토토을 만드는 것이 바람직합니다토스트-abable (참조섹션 69.2). 값이 항상 너무 작아서 압축되거나 외부로 저장 되더라도이 작업을 수행해야합니다.토스트헤더 오버 헤드를 줄임으로써 작은 데이터의 공간을 절약 할 수 있습니다.

지원하기토스트스토리지, 데이터 범퍼카 토토에서 작동하는 C 함수는 항상 사용하여 손에 든 구운 값을 풀려면 항상주의해야합니다PG_DETOAST_DATUM. (이 세부 사항은 관례 적으로 범퍼카 토토 특정 정의로 숨겨져 있습니다getarg_datatype_pMacros.) 그런 다음, 실행할 때범퍼카 토토 만들기명령, 내부 길이를 as 지정변수이외의 적절한 스토리지 옵션을 선택하십시오일반.

데이터 정렬이 중요하지 않은 경우 (특정 함수에 대해서만 또는 데이터 범퍼카 토토이 바이트 정렬을 지정하기 때문에)의 일부를 피할 수 있습니다.PG_DETOAST_DATUM. 사용할 수 있습니다pg_detoast_datum_packed대신 (관습 적으로 agetarg_datatype_pp매크로) 및 매크로 사용varsize_any_exhdrandvardata_any잠재적으로 포장 된 데이텀에 액세스하려면. 다시, 데이터 범퍼카 토토 정의가 정렬을 지정하더라도 이러한 매크로에 의해 반환 된 데이터는 정렬되지 않습니다.PG_DETOAST_DATUM인터페이스.

Note

이전 코드가 자주 선언VL_LEN_ASint32대신 필드char [4]. 구조물 정의에 적어도 다른 필드가있는 한int32정렬. 그러나 잠재적으로 정렬되지 않은 데이텀으로 작업 할 때 그러한 구조물 정의를 사용하는 것은 위험합니다.

|토스트지원은를 가질 가능성입니다.확장디스크에 저장된 형식보다 작업하기에 더 편리한 메모리 데이터 표현. 일반 또는flatVarlena 스토리지 형식은 궁극적으로 바이트의 덩어리입니다. 예를 들어 포인터를 포함 할 수는 없습니다. 메모리의 다른 위치에 복사 될 수 있기 때문입니다.PostgreSQL확장플랫 형식은 계산에 더 적합한 표현으로의 평평한 형식으로, 데이터 범퍼카 토토의 함수간에 해당 형식의 형식을 전달합니다..

확장 된 스토리지를 사용하려면 데이터 유형은에 주어진 규칙을 따르는 확장 형식을 정의해야합니다.src/include/utils/expededdatum.h및 기능 제공확장​​평면 바르라나 값은 확장 형식으로평평한확장 된 형식은 일반 Varlena 표현으로 되돌아갑니다. 그런 다음 데이터 유형의 모든 C 함수가 수신시 즉시 다른 표현을 수락 할 수 있는지 확인하십시오.PG_DETOAST_DATUM매크로는 확장 입력을 일반 플랫 형식으로 변환하도록 정의됩니다. 따라서 Flat Varlena 형식에서 작동하는 기존 기능은 입력이 확장 된 상태에서 약간 비효율적으로 계속 작동합니다.

c 확장 된 표현으로 작업하는 방법을 알고있는 기능은 일반적으로 두 가지 범주로 분류됩니다. 확장 된 형식 만 처리 할 수있는 것과 확장 또는 평평한 varlena 입력을 처리 할 수있는 것입니다. 전자는 쓰기가 더 쉽지만 단일 함수로 사용하기 위해 평평한 입력을 확장 된 양식으로 변환하는 것은 확장 된 형식으로 작동하는 것보다 비용이 많이들 수 있기 때문에 전반적으로 덜 효율적일 수 있습니다.varatt_is_expanded_header ()매크로가받은 형식을 결정합니다.

the토스트인프라는 정기적 인 Varlena 값을 확장 값과 구별 할 수있을뿐만 아니라읽기 쓰기and읽기 전용확장 된 값에 대한 포인터. c 확장 된 값 만 검사하기 만하면 또는 안전하고 내유 적으로 가시적으로 가시적 인 방식으로 만 변경하는 기능은 어떤 유형의 포인터를받을 필요가 없습니다.

확장 된 값으로 작업하는 예는 표준 배열 인프라, 특히를 참조하십시오.src/backend/utils/adt/array_expanded.c.