| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 8. 데이터 타입 | Fast Forward | Next |
복합형 행 혹은 레코드의 구조를 설명합니다. 기본적으로는, 단순한 필드명과 그 데이터형의 리스트입니다. PostgreSQL에서는, 단순한 형태에서 사용할 수 있는 방법과 같은 방법으로 복합형의 값을 사용할 수 있습니다. 예를 들면, 테이블열은 복합형의 형태로 선언할 수 있습니다.
2가지의 복합형의 선언의 예를 보겠습니다.
CREATE TYPE complex AS (
r double precision,
i double precision
);
CREATE TYPE inventory_item AS (
name text,
supplier_id integer,
price numeric
);
이 구문은, 필드명과 그 형태만을 지정할 수 있는 점을 제외하고는 CREATE TABLE와 동등합니다. 현재는, 제약(NOT NULL등)을 포함할 수 없습니다. AS키워드가 중요한 것이니 주의해 주세요. 이것이 없으면 시스템은 CREATE TYPE의 의미를 완전히 다르게 해석해, 이상한 에러 구문이 되어 버립니다.
정의 끝난 형태를 사용해, 이하와 같이 테이블이나 함수를 생성할 수가 있습니다.
CREATE TABLE on_hand (
item inventory_item,
count integer
);
INSERT INTO on_hand VALUES (ROW('fuzzy dice', 42, 1.99), 1000);
or functions:
CREATE FUNCTION price_extension(inventory_item, integer) RETURNS numeric AS 'SELECT $1.price * $2' LANGUAGE SQL; SELECT price_extension(item, 10) FROM on_hand;
테이블을 생성할 때는, 항상 테이블명과 같은 이름의 복합형도 자동적으로 생성됩니다. 이것은, 테이블의 행형을 표현하는 것입니다. 예를 들면,
CREATE TABLE inventory_item (
name text,
supplier_id integer REFERENCES suppliers,
price numeric CHECK (price > 0)
);
를 실시했다고 하면(자), 위의 것과 같은 inventory_item라고 하는 복합형과 같이 부차적으로 작성되어 똑같이 사용할 수 있게 됩니다. 그러나, 현재의 실장에는, 다음과 같은 중요한 제약사항이 있는 것에 주의해 주세요. 복합형에는 제약을 관련지을 수 없으므로, 테이블 정의에 포함되는 제약은 테이블 외부의 복합형의 값에는 적용되지 않습니다 (부분적인 차선책은, 복합형의 멤버로서 도메인형을 사용하는 것입니다).
복합형을 리터럴 정수로서 기술하려면 , 필드값을 쉽표로 단락지어, 그것들을 괄호표시 함. 필드값을 이중 인용부호로 입력할 경우, 쉼표나 괄호표시가 있어야만 합니다 (보다 상세한 것에 대하여는 다음에 설명합니다). 따라서, 복합형의 일반적인 서식은 이하와 같이 됩니다.
'( val1 , val2 , ... )'
이하에 예를 나타냅니다.
'("fuzzy dice",42,1.99)'
이것은 위에 정의된 inventory_item형의 유요한 값입니다. 필드를 NULL로 하려면, 리스트중의 해당 위치를 비웁니다. 예를 들면, 이하의 정수는 3번째의 필드에 NULL를 지정하고 있습니다.
'("fuzzy dice",42,)'
NULL는 아니고 공문자열로 하고 싶은 것이면, 이하와 같이 인용부호를 이중으로 기술합니다.
'("",42,)'
이것에 의해, 최초의 필드는 비NULL의 공문자열에, 3번째의 필드는 NULL가 됩니다.
(실제로는, 이러한 정수는 Section 4.1.2.5에서 설명한 일반적인 정수형태의 특수한 경우에 지나지 않습니다. 우선, 정수는 캐릭터 라인으로 취급되어 복합형의 입력 변환 처리로 보내집니다. 명시적인 형태 지정이 필요하게 될지도 모릅니다. )
또, ROW식 구문도 복합값을 생성할 때에 사용할 수 있습니다. 아마 대부분의 경우, 이것은 string-literal 구문보다 간단하게 사용할 수 있습니다. 인용부호부의 복수의 층에 대해 고려할 필요가 없습니다. 이미 이 방법을 사용하고 있습니다.
ROW('fuzzy dice', 42, 1.99)
ROW('', 42, NULL)
식안에 2개 이상의 필드가 있으면, ROW 키워드는 실제로는 생략 할 수 있습니다. 그러므로, 이하와 같이 간략화할 수 있습니다.
('fuzzy dice', 42, 1.99)
('', 42, NULL)
ROW식 구문에 대해서는 Section 4.2.11에서 보다 상세하게 설명합니다.
복합형 열의 필드에 액세스 하려면, 테이블명으로부터 필드를 선택하는 경우처럼 소수점과 필드명을 기술합니다. 사실상, 테이블명으로부터의 선택과 비슷하여 파서를 혼란시키지 않게 괄호를 사용해야 하는 경우가 자주 있습니다. 예를 들면, on_hand라고 하는 테이블의 예로부터 subfield를 선택하려고 했을 경우,
SELECT item.name FROM on_hand WHERE item.price > 9.99;
이것은, SQL의 구문 규칙에 따라 item가 필드명이 아닌 테이블명으로서 해석되기 때문에 동작하지 않습니다. 이하와 같이 기술하지 않으면 안됩니다.
SELECT (item).name FROM on_hand WHERE (item).price > 9.99;
또한, 테이블명도 사용해야 하는 경우(예를 들면 복수 테이블에 대한 쿼리) 이하와 같이 됩니다.
SELECT (on_hand.item).name FROM on_hand WHERE (on_hand.item).price > 9.99;
이것으로, 괄호 표시된 개체는 정확하게 item열에의 참조로서 해석되어, subfield가 선택할 수 있게 됩니다.
비슷한 구문상의 문제는, 복합형으로부터 필드를 선택할 때 항상 발생합니다. 예를 들면, 복합형의 값을 돌려주는 함수의 결과로부터 1개만 필드를 선택하는 경우, 이하와 같이 기술하지 않으면 안됩니다.
SELECT (my_func(...)).field FROM ...
추가 괄호가 없으면 이것은 구문 에러를 일으킵니다.
복합형의 열에 하는 삽입과 갱신용의 적절한 구문의 예를 몇 가지 들어보겠습니다. 우선, 열전체를 삽입, 갱신하는 예입니다.
INSERT INTO mytab (complex_col) VALUES((1.1,2.2)); UPDATE mytab SET complex_col = ROW(1.1,2.2) WHERE ...;
첫 번? 예에서는 ROW를 생략 하고, 두 번째의 예에서는 ROW를 사용하고 있습니다. 어느 방법으로든 실시할 수 있습니다.
이하와 같이 하면, 복합형의 열의 개개의 subfield를 갱신할 수가 있습니다.
UPDATE mytab SET complex_col.r = (complex_col).r + 1 WHERE ...;
여기서, SET 뒤의 열의 이름 주위에 괄호를 기술할 필요가 없습니다.(실제로 기술할 수 없는 것) 그러나, 등호표의 오른쪽에서 같은 열을 참조하는 경우에는 괄호가 필요함으로 주의해 주세요.
또, INSERT를 대상으로 해 subfield를 지정할 수도 있습니다.
INSERT INTO mytab (complex_col.r, complex_col.i) VALUES(1.1, 2.2);
열의 subfield 모든 값을 주지 않으면, 나머지의 subfield는 NULL값이 됩니다.
복합형의 외부 텍스트 표현은, 개개의 필드용의 I/O변환 규칙에 따라 해석되는 항목군과 복합 구조를 의미하는 장식으로 구성됩니다. 이 장식은, 값전체를 괄호((및))와 인접한 항목간 쉼표(,)로 구성됩니다. 괄호 밖의 공백 문자는 무시되지만, 괄호의 내부에서는 필드값의 일부로 간주해집니다. 공백이 의미가 있는지 없는지에 대해서는, 그 필드의 데이터형용의 입력 변환 규칙에 따릅니다. 예를 들면,
'( 42)'
안의 공백은, 그 필드형이 정수의 경우는 무시됩니다만, 텍스트의 경우는 무시되지 않습니다.
상술한 대로, 복합형의 값을 기술할 때에 개개의 필드값에 따옴표를 사용합니다. 만약, 필드값이 복합형값의 파서를 혼란시키는 경우에는, 필수 입니다. 구체적으로는, 괄호, 쉽표, 따옴표, backslash를 포함한 필드의 경우, 따옴표로 표시할 필요가 있습니다. 인용부호로 괄복합형의 필드값내에 따옴표나 backslash가 존재하는 경우, 그 앞에 backslash를 붙여 주세요 (큰따옴표 표시가 된 필드값 안에 있는 큰따옴표 쌍은 큰 따옴표 문자 자체를 나타냅니다. SQL 문자 스트링의 룰에 있는 바에 의하면 작은 따옴표에서도 유사하게 적용됩니다다). 그대로는 복합형에 대한 구문으로서 해석되어 버리는, 모든 데이터 문자를 보호하는 다른 방법으로서 backslash에 의한 이스케이프를 사용할 수가 있습니다.
완전히 비어있는 필드값(쉼표나 괄호의 사이에 전혀 문자가 없는 것)은 NULL를 나타냅니다. NULL이 아닌 공문자열을 값으로 하려면, ""과 같이 기술해 주세요.
복합형의 출력 처리에서는, 만약 필드값이 공문자열의 경우나 괄호, 쉼표, 따옴표, backslash, 공백 문자를 포함한 경우에는, 그 필드값을 따옴표로 하여 출력합니다 (공백 문자에 대한 이 처리는 중요하지는 않습니다만, 가독성을 높입니다). 필드치내에 포함된 따옴표나 backslash는 이중화 됩니다.
Note: SQL 명령에 기술한 것은 문자열 상수값과 복합형으로서 해석됨을 기억해 주세요. 이것은 필요한 backslash의 수를 배로 합니다(이스케이프 문자열 구문을 가정). 예를 들면, 복합형의 값안에 따옴표와 backslash를 가지는 text필드에 삽입하려면 , 이하와 같이 써야 합니다.
INSERT ... VALUES (E'("\\"\\\\")');문자열-리터럴 프로세서로 제1 레벨의 backslash를 없앱니다. 복합형값의 파서에게 건네지는 것은 ("\"\\")와 같이 됩니다. 그리고, text데이터형의 입력 함수로 건네지는 캐릭터 라인은 "\이 됩니다 (만약, 예를 들면 bytea라고 하는, 특별히 backslash를 취급하는 데이터형을 취급하고 있는 경우, 1개의 backslash를 저장된 복합형의 필드에 얻기 위해서 명령내의 8개의 backslash가 필요하게 됩니다). 달러 인용부호 붙이고(Section 4.1.2.2를 참조)를 사용해, 이 backslash의 이중화를 막을 수가 있습니다.
Tip: --> The ROW constructor syntax is usually easier to work with than the composite-literal syntax when writing composite values in SQL commands. In ROW, individual field values are written the same way they would be written when not members of a composite. --> 통상, SQL 명령내에 복합형의 값을 쓸 때, ROW생성 구문이 복합형의 리터럴 구문보다 작업이 간단합니다. ROW에서는, 복합형의 멤버가 아닌 값을 쓸 때와 같은 방법으로 개개의 필드값을 쓸 수가 있습니다.