32.11. 사용자 정의 젠 토토

설명에 따라PostgreSQL : 문서 : 8.1 : PostgreSQL 토토 사이트 시스템, 포스트그레SQL될 수 있습니다 새로운 데이터 유형을 지원하도록 확장되었습니다. 이 섹션에서는 다음 방법을 설명합니다. 아래에 정의된 데이터 유형인 새로운 기본 유형을 정의합니다. 수준SQL언어. 새로운 기본 유형을 생성하려면 다음을 수행하는 함수를 구현해야 합니다. 일반적으로 C와 같은 저수준 언어로 유형을 조작합니다.

이 섹션의 예는 다음에서 찾을 수 있습니다.복잡한.sql그리고복잡한.c에서src/튜토리얼소스 디렉토리 유통. 참조README파일 있음 예제 실행에 대한 지침은 해당 디렉토리를 참조하세요.

사용자 정의 젠 토토에는 항상 입력과 출력 함수.이 기능은 다음 방법을 결정합니다. 유형은 문자열로 나타납니다(사용자가 입력하고 사용자) 및 유형이 메모리에서 구성되는 방식. 입력 기능 null로 끝나는 문자열을 인수로 사용하고 유형의 내부(메모리 내) 표현을 반환합니다. 는 출력 함수는 유형의 내부 표현을 다음과 같이 사용합니다. 인수를 입력하고 null로 끝나는 문자열을 반환합니다. 만약 우리가 단순히 저장하는 것 이상으로 유형에 대해 더 많은 작업을 수행하고 싶습니다. 무엇이든 구현하려면 추가 기능을 제공해야 합니다. 해당 유형에 대해 갖고 싶은 작업입니다.

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

typedef 구조체 복합체 
    더블엑스;
    이중 y;
 복잡;

우리는 이것을 참조에 의한 전달 젠 토토으로 만들어야 합니다. 너무 커서 한 장에 들어갈 수 없습니다.데이텀값.

젠 토토의 외부 문자열 표현으로 우리는 형식의 문자열(x,y).

입력 및 출력 함수는 일반적으로 작성하기 어렵지 않습니다. 특히 출력 기능. 그러나 외부를 정의할 때 유형의 문자열 표현을 사용하려면 다음을 수행해야 한다는 점을 기억하세요. 결국에는 이에 대한 완전하고 강력한 파서를 작성합니다. 입력 기능으로 표현합니다. 예를 들어:

PG_FUNCTION_INFO_V1(콤플렉스인);

데이텀
complex_in(PG_FUNCTION_ARGS)

    char *str = PG_GETARG_CSTRING(0);
    더블 엑스,
                와이;
    복잡한 *결과;

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

    결과 = (복소수 *) palloc(sizeof(복소수));
    결과-x = x;
    결과-y = y;
    PG_RETURN_POINTER(결과);

출력 기능은 간단하게 다음과 같습니다:

PG_FUNCTION_INFO_V1(complex_out);

데이텀
complex_out(PG_FUNCTION_ARGS)

    복잡한 *복잡한 = (복잡한 *) PG_GETARG_POINTER(0);
    문자 *결과;

    결과 = (char *) palloc(100);
    snprintf(결과, 100, "(%g,%g)", 복합체-x, 복합체-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(복소수));
    결과-x = pq_getmsgfloat8(buf);
    결과-y = pq_getmsgfloat8(buf);
    PG_RETURN_POINTER(결과);

PG_FUNCTION_INFO_V1(complex_send);

데이텀
complex_send(PG_FUNCTION_ARGS)

    복잡한 *복잡한 = (복잡한 *) 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 함수를 생성하십시오. 젠 토토:

CREATE FUNCTION complex_in(cstring)
    반품 콤플렉스
    그대로 '파일 이름'
    언어 C 불변 STRICT;

CREATE FUNCTION complex_out(복잡한)
    반환 cstring
    그대로 '파일 이름'
    언어 C 불변 STRICT;

CREATE FUNCTION complex_recv(내부)
   반품 콤플렉스
   그대로 '파일 이름'
   언어 C 불변 STRICT;

CREATE FUNCTION complex_send(복잡한)
   반환 bytea
   그대로 '파일 이름'
   언어 C 불변 STRICT;

입력 및 출력 함수의 선언에 주목하세요. 아직 정의되지 않은 젠 토토을 참조해야 합니다. 이는 허용되지만 무시할 수 있는 경고 메시지를 표시합니다. 입력 함수가 먼저 나타나야 합니다.

마지막으로 데이터 젠 토토을 선언할 수 있습니다:

CREATE TYPE 콤플렉스(
   내부 길이 = 16, 
   입력 = complex_in,
   출력 = complex_out,
   수신 = complex_recv,
   보내기 = complex_send,
   정렬 = 이중
);

새 기본 젠 토토을 정의할 때,PostgreSQL자동으로 지원 제공 해당 유형의 배열의 경우.용 역사적인 이유로 배열 젠 토토은 기본과 동일한 이름을 갖습니다. 밑줄 문자()로 입력하세요._) 앞에 붙습니다.

데이터 유형이 존재하면 추가 기능을 선언할 수 있습니다 데이터 유형에 대한 유용한 작업을 제공합니다. 그러면 운영자는 다음을 수행할 수 있습니다. 함수 위에 정의되고, 필요한 경우 연산자 클래스 데이터 유형의 인덱싱을 지원하기 위해 생성될 수 있습니다. 이것들 추가 레이어는 다음 섹션에서 논의됩니다.

당신의 가치가 데이터 젠 토토의 크기가 수백 바이트를 초과할 수 있습니다(내부 양식), 데이터 젠 토토을 만들어야 합니다.토스트-가능(참조섹션 50.2). 이를 위해서는 내부 표현은 표준 레이아웃을 따라야 합니다. 가변 길이 데이터: 처음 4바이트는 다음과 같아야 합니다.int32전체 길이(바이트)를 포함합니다. 데이텀(자체 포함). 데이터에 대해 작동하는 C 함수 유형은 구운 값을 압축 해제할 때 주의해야 합니다. 를 사용하여 전달됨PG_DETOAST_DATUM. (이 세부 사항은 젠 토토별 정의에 따라 관례적으로 숨겨집니다.GETARG매크로.) 그런 다음 실행할 때젠 토토 생성명령, 다음을 지정하세요. 내부 길이는 다음과 같습니다.변수그리고 선택 적절한 저장 옵션을 선택하세요.

자세한 내용은 다음 설명을 참조하세요.PostgreSQL : 문서 : 8.1 : 토토 베이 생성명령.