PostgreSQL 8.3.3문서
Prev Fast Backward Chapter 33. SQL 확장 Fast Forward Next

33.11. 사용자 정의의 형태

Section 33.2에 진술되고 있듯이, PostgreSQL는 새로운 데이터형을 지원하도록 확장할 수가 있습니다. 본절에서는, SQL언어 이하의 레벨로 정의되는 데이터형인, 기본형을 새롭게 정의하는 방법에 대해 설명합니다. 새로운 기본형의 작성에는, 저레벨 언어, 보통 C로 작성된, 형태를 조작하는 함수의 구현이 필요합니다.

본 섹션에서 사용하는 예는, 소스 배포물 내의 src/tutorial디렉토리에 complex.sql와 complex.c라는 이름으로 찾아볼 수 있습니다. 실제로 예를 실행하는 방식은 디렉토리 내의 README를 참조해 주세요.

사용자 정의 데이터형은 반드시 입력 함수와 출력 함수가 필요합니다. 이러한 함수는, 형태가(사용자에 의한 입력과 사용자에게의 출력을 위한) 문자열에 어떠한 형식으로 표시될지와, 그 형태가 메모리에 어떻게 구성될지를 결정합니다. 입력 함수는 인자로서 NULL 종료 문자열을 취해, 그 형태의(메모리중의) 내부 표현을 돌려줍니다. 출력 함수는 인자로서 그 형태의 내부 표현을 취해, NULL 종료 문자열을 돌려줍니다. 단지 저장하는 것 만이 아니고, 그 형태에 조작을 더하고 싶은 것이면, 그 형태가 갖게 하고 싶은 모든 실행 함수를 한층 더 제공해야 합니다.

예를 들면, 복소수를 표현하는 complex형을 정의하는 것을 생각봅니다. 다음과 같은 C구조체로 복소수를 메모리에 표현하는 것이 자연스러운 방법일 것입니다. 

typedef struct Complex {
    double      x;
    double      y;
} Complex;

단일의 Datum값으로 취급하기에는 너무 크므로, 이것은 참조 인도형으로 해야 합니다.

이 형태의 외부 문자열 표현으로서, (x, y)형식의 문자열을 사용하는 것을 선택합니다.

입출력 함수, 특히 출력 함수를 기술하는 것은 곤란하지는 않습니다. 그렇지만, 이 형태의 외부 표현 문자열을 정의할 때, 그 표현을 위한 완전하고 강력한 파서를 입력 함수로서 써야합니다. 이하에 예를 나타냅니다. 

PG_FUNCTION_INFO_V1(complex_in);

Datum
complex_in(PG_FUNCTION_ARGS)
{
    char       *str = PG_GETARG_CSTRING(0);
    double      x,
                y;
    Complex    *result;

    if (sscanf(str, " ( %lf , %lf )", &x, &y) != 2)
        ereport(ERROR,
                (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
                 errmsg("invalid input syntax for complex: \"%s\"",
                        str)));

    result = (Complex *) palloc(sizeof(Complex));
    result->x = x;
    result->y = y;
    PG_RETURN_POINTER(result);
}

출력 함수는 이하와 같이 간단하게 할 수 있습니다. 

PG_FUNCTION_INFO_V1(complex_out);

Datum
complex_out(PG_FUNCTION_ARGS)
{
    Complex    *complex = (Complex *) PG_GETARG_POINTER(0);
    char       *result;

    result = (char *) palloc(100);
    snprintf(result, 100, "(%g,%g)", complex->x, complex->y);
    PG_RETURN_CSTRING(result);
}

입출력 함수는, 각각의 역함수가 되도록 해야 합니다. 그렇게 하지 않으면, 데이터를 파일에 버리고 그것을 다시 읽어오려 할 때에, 심각한 문제가 발생하겠지요. 이것은, 부동 소수가 관계될 때 자주 발생하는 문제입니다.

옵션으로서, 사용자 정의형은 바이너리 입출력 함수를 제공할 수가 있습니다. 보통, 바이너리 입출력은 빠르지만, 텍스트 입출력보다 이식성이 없습니다. 텍스트 입출력과 같게, 외부 바이너리 표현을 정확하게 정의하는 것은 작성자의 책임입니다. 대부분의 내장 데이터형은, 머신에 의존하지 않는 바이너리 표현을 제공하려고 합니다. complex형은, float8형의 바이너리 입출력 컨버터를 바탕으로 합니다. 

PG_FUNCTION_INFO_V1(complex_recv);

Datum
complex_recv(PG_FUNCTION_ARGS)
{
    StringInfo  buf = (StringInfo) PG_GETARG_POINTER(0);
    Complex    *result;

    result = (Complex *) palloc(sizeof(Complex));
    result->x = pq_getmsgfloat8(buf);
    result->y = pq_getmsgfloat8(buf);
    PG_RETURN_POINTER(result);
}

PG_FUNCTION_INFO_V1(complex_send);

Datum
complex_send(PG_FUNCTION_ARGS)
{
    Complex    *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));
}

입출력 함수를 작성해 공유 라이브러리내에 컴파일 하면, SQL의 complex형을 정의할 수 있습니다. 우선 쉘형으로서 선언합니다. 

CREATE TYPE complex;

이것은 플레이스홀더(자리)의 역할을 해, 입출력 함수를 정의할 때에 그 형태를 참조할 수 있습니다. 이 후 이하와 같이, 입출력 함수를 정의할 수가 있습니다. 

CREATE FUNCTION complex_in(cstring)
    RETURNS complex
    AS '
filename
'
    LANGUAGE C IMMUTABLE STRICT;

CREATE FUNCTION complex_out(complex)
    RETURNS cstring
    AS '
filename
'
    LANGUAGE C IMMUTABLE STRICT;

CREATE FUNCTION complex_recv(internal)
   RETURNS complex
   AS '
filename
'
   LANGUAGE C IMMUTABLE STRICT;

CREATE FUNCTION complex_send(complex)
   RETURNS bytea
   AS '
filename
'
   LANGUAGE C IMMUTABLE STRICT;

마지막으로, 데이터형의 완전한 정의를 제공할 수가 있습니다. 

CREATE TYPE complex (
   internallength = 16, 
   input = complex_in,
   output = complex_out,
   receive = complex_recv,
   send = complex_send,
   alignment = double
);

새로운 기본형을 정의하면, PostgreSQL는 자동적으로 그 형태의 배열의 지원을 제공합니다. 배열형은 통상, 기본형의 이름에 밑줄 친 문자 _가 붙은 이름이 됩니다.

데이터형이 존재하게 되면, 추가적으로 그 데이터형에 대해서 유용한 조작을 제공하는 함수를 선언할 수 있습니다. 그리고, 그 함수를 사용하는 연산자도 정의할 수 있습니다. 또, 필요에 따라서, 그 데이터형의 인덱스를 지원하기 위한 연산자 클래스도 작성 가능합니다. 이러한 추가적인 레이아웃에 대해서는 다음 섹션에서 설명합니다.

데이터형의 값이(내부 형식에서) 사이즈가 변동하는 경우, 그 데이터형을 TOAST가능하게 만들어야 합니다. (Section 52.2를 참조해 주세요. ) 이를 위해서, 내부 표현이 변수 길이 데이터의 표준 레이아웃에 따라야합니다. 처음의 4바이트는, 자료의 바이트(그 자체를 포함)에서 전체 길이를 포함하는 int32가 되어야 합니다. 그 데이터형을 취급하는 C함수는, PG_DETOAST_DATUM를 사용해, 건네받은 TOAST화된 값을 주의 깊게 전개하지 않으면 안됩니다 (통상, 자세한 것은 형태 독자적인 GETARG_DATATYPE_P매크로를 정의해 은폐합니다). 그 후, CREATE TYPE명령을 실행할 때에, variable에 내부 길이를 지정해, 또, 적절한 저장 옵션을 선택해 주세요.

--> For further details see the description of the CREATE TYPE command. --> 상세한 것에 대해서는 CREATE TYPE 명령의 설명을 참조해 주세요.

Prev Home Next
사용자 정의의 집계 Up 사용자 정의 연산자