| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
CREATE CAST (
sourcetype
AS
targettype
)
WITH FUNCTION
funcname
(
argtypes
)
[ AS ASSIGNMENT | AS IMPLICIT ]
CREATE CAST (
sourcetype
AS
targettype
)
WITHOUT FUNCTION
[ AS ASSIGNMENT | AS IMPLICIT ]
CREATE CAST를 사용하면, 새로운 캐스트를 정의할 수 있습니다. 캐스트는, 2개의 데이터형간의 변환 처리 방법을 지정하는 것입니다. 이하에 예를 나타냅니다.
SELECT CAST(42 AS text);
text(int4)의 경우, 사전에 지정된 함수를 호출하여 상수 42를 text형으로 전환합니다. (적합한 캐스트가 정의되어 있지 않은 경우, 변환 처리는 실패합니다).
2개의 데이터형이 binary compatible가 될 수 있습니다. 이 경우는, 함수를 호출하지 않아도,"자유롭게"서로의 데이터형으로 변환할 수가 있습니다. 다만, 대응하는 값은, 같은 내부 표현을 사용하고 있을 필요가 있습니다. 예를 들면, 데이터형text와varchar에는, 바이너리 호환성이 있습니다.
디폴트에서는, 캐스트는 명시적인 캐스트 요구가 있었을 경우만 발생합니다. 명시적인 캐스트 요구의 구문은,CAST( x AS typename ), 혹은, x :: typename 입니다.
캐스트에AS ASSIGNMENT옵션을 붙이면(자), 대상 데이터형의 열에 대입할 때, 암묵적으로 그 캐스트를 발생시키도록(듯이) 설정할 수 있습니다. 예를 들면,foo.f1가text형의 열이다고 가정합니다.
INSERT INTO foo (f1) VALUES (42);
integer형을text형으로 변환하는 캐스트에 AS ASSIGNMENT옵션을 붙이는 경우, 상기의 SQL문을 실행할 수 있습니다. 그러나,AS ASSIGNMENT옵션이 붙지 않으면, 실행할 수 없습니다 (일반적으로, 이런 종류의 캐스트를 설명하기 위해 assignment cast라는 용어를 사용합니다).
캐스트에AS IMPLICIT옵션을 붙이면, 대입의 경우 뿐만이 아니라, 식안에 있는 경우에서도, 모든 문맥으로 암묵적으로 그 캐스트를 호출하도록(듯이) 설정할 수 있습니다. 예를들어, || 가 text연산수를 취하기 때문에,
SELECT 'The time is ' || now();
timestamp 형을 text으로 변환하는 캐스트에 AS IMPLICIT옵션을 붙이는 경우, 상기의 SQL문을 실행할 수 있습니다. 옵션이 붙지 않으면, 명시적 캐스트를 반드시 작성해야 합니다. 예를들면,
SELECT 'The time is ' || CAST(now() AS text);
이런 종류의 캐스트를 설명하기 위해, 암묵 캐스트라는 용어를 사용합니다.
암묵 캐스트는, 다용하지 않는 것이 현명합니다. 암묵적 캐스트를 너무 사용하면(자),PostgreSQL가 커멘드를 생각하지 않는 의미로 해석해 버리는 원인이 됩니다. 또, 복수의 해석이 가능하기 때문에, 커멘드를 전혀 해독할 수 없게 되어 버릴 가능성도 있습니다. 경험적으로는, 2개의 데이터형이 동일한 일반적인 데이터형의 카테고리에 속하고 있어 변환에 의해 정보가 보관 유지되는 경우만, 암묵 캐스트를 호출해 가능하게 하는 것이 좋은 방법이라고 생각됩니다. 예를 들면,int2형으로부터int4형에의 캐스트는, 암묵 캐스트로 하는 것이 타당합니다만,float8형으로부터int4형에의 캐스트는, 대입 캐스트에만 해야 한다고 생각됩니다. text형으로부터int4형에의 변환과 같은, 카테고리를 넘는 데이터형의 캐스트는, 명시적인것 만 사용하는 것이 적절합니다.
캐스트를 생성할 수 있으려면, 대상 데이터형 또는 소스를 소유해야 합니다. 바이너리 호환성 캐스트를 생성하려면, 슈퍼유저가 되어야 합니다. (바이너리 호환성 캐스트의 잘못된 변환이 서버를 쉽게 고장나게 할 수 있기 때문에, 이러한 제한을 둡니다.)
캐스트 하는 변환원의 데이터형의 이름입니다.
캐스트 하는 변환처의 데이터형의 이름입니다.
이 함수는 캐스트를 실행하기 위해서 사용합니다. 함수명은 검증을 거친 스키마가 될 수 있습니다. 검증을 거친 스키마가 아닌 경우, 함수는 스키마 검색 패스로부터 검색됩니다. 함수의 결과의 데이터형은, 캐스트의 변환처의 데이터형과 일치할 필요가 있습니다. 인수에 대해서는 아래에 설명되어 있습니다.
변환원데이터형과 변환처 데이터형의 사이에, 바이너리 호환성이 있는 것을 나타냅니다. 이 경우, 캐스트를 실행하는데 함수는 필요 없습니다.
대입에는, 암묵적으로 캐스트를 호출할 수 있는 것을 나타냅니다. contexts.
대입 문맥으로, 암묵적으로 캐스트를 호출할 수 있는 것을 나타냅니다.
캐스트를 실행하는 함수는 1~3개의 인수를 취할 수가 있습니다. 1번째의 인수형은 캐스트의 변환원데이터형과 동일해야 합니다. 2번째의 인수 (존재하는 경우)는,integer형이어야 합니다. 변환처의 형태에 관련지을 수 있었던 형태 수식자를 지정합니다. 형태 수식자가 없는 경우는-1을 지정합니다. 3번째의 인수(존재하는 경우)는,boolean형이어야 합니다. 캐스트가 명시적인 캐스트이면true를, 그 이외이면false를 지정합니다 (기묘한 이야기입니다만, SQL 사양에서는, 명시적 캐스트와 암묵적 캐스트와의 사이에 다른 행동을 요구하는 경우가 있습니다. 이 인수는 그러한 캐스트를 실해야 하는 함수용으로 제공되고 있습니다. 독자적인 데이터형을 이 유파의 의식에 따르도록(듯이) 설계하는 것은 권유받지 않습니다).
통상, 캐스트에 있어서의 변환원데이터형과 변환처 데이터형은 다를 필요가 있습니다. 그러나, 2개 이상의 인수를 가지는 함수로 캐스트를 실행했을 경우는, 변환원과 변환처로 동일한 데이터형을 가지는 캐스트를 선언할 수가 있습니다. 이것은, 시스템 카탈로그에 대해 형태 고유의 길이 강제 함수를 표현하기 위해서 사용되고 있습니다. 이와 같이 지정된 함수는, 형태의 값을 강제적으로 2번째의 인수로 주어진 형태 수식자의 값으로 하기 위해서(때문에) 사용됩니다 (문법상, 형태 수식자를 가지는 것은 특정의 내장 데이터형만이므로, 이 기능은 변환처의 데이터형이 사용자 정의의 것인 경우에는 도움이 되지 않습니다. 여기에서는, 설명을 완전하게 하기 위해서 언급하고 있습니다).
변환원과 변환처의 데이터형이 다른 캐스트에 있어 복수의 인수를 취하는 함수는, 어느 데이터형으로부터 다른 데이터형에의 변환과 길이의 강제를 1개의 스텝에 집계한 것을 나타냅니다. 인수를 1개 밖에 취하지 않는 경우는, 형태 수식자를 사용해 형태를 강제하기 위해서, 데이터형간의 변환과 수식자의 적용이라고 하는 2개의 스텝이 필요합니다.
사용자 정의의 캐스트를 삭제하려면, DROP CAST 를 사용해 주세요.
데이터형을 쌍방향으로 변경 가능하게 하려면 , 쌍방향의 캐스트를 명시적으로 선언할 필요가 있는 것에 주의해 주세요.
PostgreSQL 7.3보다 전의 버젼에서는, 데이터형과 같은 이름을 가져, 그 데이터형을 반환하여, 다른 데이터형의 인수를 1개취하는 함수는, 자동적으로 캐스트 함수로 간주되고 있었습니다. 이 관습은, 스키마를 도입해, 시스템 카탈로그로 바이너리 호환성에 의한 캐스트를 실현 가능하게 한 것에 의해, 폐지되었습니다. 내장 캐스트 함수는, 아직 이 명명 규칙에 따르고 있습니다. 그러나, 다른 캐스트 같이,pg_cast시스템 카탈로그에 캐스트로서 나타내야 합니다.
필수가 아닙니다만, 대상 데이터형 이후에, 캐스트 실행 함수의 이름을 붙이는 이 오래된 규약을 따르는 것을 추천합니다. 많은 사용자는 typename ( x )라고 하는 함수 스타일의 표기법을 사용하여, 데이터형의 캐스트를 실시하고 있습니다. 이 표기법은, 캐스트를 실행하고 있는 함수의 호출에 지나지 않습니다. 캐스트로서 특별히 취급하고 있는 것은 아닙니다. 사용자가 작성한 변환 함수의 이름이 이 관습에 따르지 않으면 다른 사용자가 당황하게 됩니다. PostgreSQL는 인수로서 다른 형태를 취하는 같은 이름의 함수를 오버로딩 할 수가 있으므로, 여러가지 형태로부터 대상 형태의 이름을 모두 사용하는 다중 변환 함수를 갖는 데 어려움이 없습니다.
Note: 상기 단락은 한 개의 거짓이 존재합니다. pg_cast는 명백한 함수 호출의 의미로 설명하는데 사용하는 한 가지 경우가 있습니다. 함수 호출 name ( x )에 실제로 일치하는 함수가 없는 경우, name 는 데이터형의 이름이고, pg_cast는 x 형으로부터 이 형태로 바이너리 호환성 캐스트를 보여줍니다. 이 호출은 명시적 캐스트로서 처리됩니다. 이 예외는 실제의 함수가 존재하지 않아도, 바이너리 호환성 캐스트가 함수 구문을 사용하여 호출될 수 있도록 생성됩니다.
int4(text)함수를 사용하여 text형에서 int4 형으로 캐스트를 생성하려면 다음과 같이 하세요.
CREATE CAST (text AS int4) WITH FUNCTION int4(text);
(이 캐스트는, 시스템에 이미 정의되어 있습니다. )