35.11. 사용자 정의 토토 사이트 추천

설명대로PostgreSQL : 문서 : 9.5 : 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 불변의 엄격한;

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

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

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

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

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

자세한 내용은 설명을 참조하십시오.토토 사이트 추천 만들기명령.