35.11. 사용자 정의 토토

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

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

사용자 정의 토토에는 항상 입력 및 출력 기능이 있어야합니다. 이러한 기능은 토토이 문자열에 나타나는 방법 (사용자의 입력 및 사용자에 대한 출력)과 메모리에서 토토을 구성하는 방법을 결정합니다. 입력 함수는 인수로 무효 문자 문자열을 취하고 토토의 내부 (메모리) 표현을 반환합니다. 출력 함수는 토토의 내부 표현을 인수로 가져 와서 무효 문자 문자열을 반환합니다. 토토을 저장하는 것보다 토토으로 더 많은 일을하고 싶다면 토토에 대해 원하는 작업을 구현하기 위해 추가 기능을 제공해야합니다.

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

typedef struct complex 
    더블 X;
    이중 Y;
 복잡한;

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

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

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

pg_function_info_v1 (complex_in);

자료
complex_in (pg_function_args)

    char *str = pg_getarg_cstring (0);
    더블 X,
                와이;
    복잡한 *결과;

    if (sscanf (str, "( %lf, %lf)", & x, & y)! = 2)
        Ereport (오류,
                (errcode (errcode_invalid_text_representation),
                 errmsg ( "복합체에 대한 잘못된 입력 구문 : \"%s \ "",
                        str));

    결과 = (복합 *) palloc (sizeof (complex));
    결과- x = x;
    결과- y = y;
    pg_return_pointer (결과);

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

pg_function_info_v1 (complex_out);

자료
complex_out (pg_function_args)

    complex *complex = (복합체 *) pg_getarg_pointer (0);
    char *결과;

    결과 = psprintf ( "(%g,%g)", complex- x, complex- y);
    pg_return_cstring (결과);

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

선택적으로, 사용자 정의 토토은 이진 입력 및 출력 루틴을 제공 할 수 있습니다. 바이너리 I/O는 일반적으로 더 빠르지 만 텍스트 I/O보다 휴대성이 떨어집니다. 텍스트 I/O와 마찬가지로 외부 바이너리 표현이 무엇인지 정확히 정의하는 것은 귀하에게 달려 있습니다. 내장 데이터 토토의 대부분은 기계 독립적 이진 표현을 제공하려고합니다. 을 위한복잡한, 우리는 타입 용 바이너리 I/O 변환기에서 피기 백float8:

pg_function_info_v1 (complex_recv);

자료
complex_recv (pg_function_args)

    StringInfo buf = (stringInfo) pg_getarg_pointer (0);
    복잡한 *결과;

    결과 = (복합 *) palloc (sizeof (complex));
    결과- x = pq_getmsgfloat8 (buf);
    결과- y = pq_getmsgfloat8 (buf);
    pg_return_pointer (결과);

pg_function_info_v1 (complex_send);

자료
complex_send (pg_function_args)

    complex *complex = (복합체 *) pg_getarg_pointer (0);
    StringInfodata buf;

    pq_begintypsend (& buf);
    pq_sendfloat8 (& buf, complex- x);
    pq_sendfloat8 (& buf, complex- y);
    pg_return_bytea_p (pq_endtypsend (& buf));

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

토토 생성 단지;

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

함수 complex_in (cstring) 생성
    복잡한 반환
    처럼 'filename'
    언어 C 불변의 엄격;

함수 만들기 complex_out (complex)
    cstring을 반환합니다
    처럼 'filename'
    언어 C 불변의 엄격;

함수 만들기 complex_recv (내부)
   복잡한 반환
   처럼 'filename'
   언어 C 불변의 엄격;

함수 만들기 complex_send (complex)
   Bytea를 반환합니다
   처럼 'filename'
   언어 c 불변의 엄격한;

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

토토 생성 단지 (
   내부 길이 = 16,
   입력 = complex_in,
   출력 = complex_out,
   수신 = complex_recv,
   send = complex_send,
   정렬 = 이중
);

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

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

데이터 토토의 값이 크기가 크기 (내부 형식)에 따라 데이터 토토을 만들어야합니다토스트-abable (참조섹션 59.2). 데이터가 항상 너무 작아서 압축되거나 외부로 저장 되더라도이 작업을 수행해야합니다.토스트헤더 오버 헤드를 줄임으로써 작은 데이터의 공간을 절약 할 수 있습니다.

이렇게하려면, 내부 표현은 가변 길이 데이터의 표준 레이아웃을 따라야합니다. 처음 4 바이트는 A이어야합니다.char [4]직접 액세스하지 않은 필드 (관습 적으로 명명 된VL_LEN_). 사용해야합니다set_varsize ()이 필드에 데이텀의 크기를 저장하려면varsize ()검색하려면. 데이터 토토에서 작동하는 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인터페이스.

자세한 내용은 설명을 참조하십시오.토토 생성명령.