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

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

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

우리가 토토 꽁 머니을 정의하고 싶다고 가정복잡한12408_12533

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 : \" %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.

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

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

자세한 내용은 설명을 참조하십시오.PostgreSQL :명령.