| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
INSERT INTO
table
[ (
column
[, ...] ) ]
{ DEFAULT VALUES | VALUES ( {
expression
| DEFAULT } [, ...] ) [, ...] |
query
}
[ RETURNING * |
output_expression
[ AS
output_name
] [, ...] ]
INSERT는 테이블에 새로운 행을 삽입합니다. 값식을 사용해 한 행 이나 그 이상의 행을 삽입할 수 있고, 쿼리문의 결과를 사용해 0행 이나 그 이상의 행을 삽입할 수도 있습니다.
대상의 컬럼 이름은 어떠한 차례에서도 지정할 수 있습니다. 컬럼 이름의 리스트가 지정되지 않았던 경우는, 선언시의 차례로 늘어놓은 테이블내의 모든 열이 기본값이 됩니다. 또는 VALUES 구나 query 에 의해 N 열만이 지정되었을 경우는, 선두의 N 열의 이름이 기본값이 됩니다. VALUES구나 query 로 제공되는 값은, 명시적 또는 암묵적인 열 리스트를 왼쪽에서 오른쪽에의 순서로 관련지을 수 있습니다.
명시적 또는 암묵적인 열리스트에 없는 각 열에는 기본값이 삽입됩니다. 만약 열에 아무 값이 없으면 기본값이나 NULL 값이 삽입됩니다.
각 열의 식이 올바른 데이터형이 아닌 경우는, 자동적으로 형태의 변환을 할 것입니다.
생략 가능한RETURNING 구에 의해,INSERT는 실제로 삽입된 각 행에 근거해 계산된 값을 돌려주게 됩니다. 이것은 시리얼 시퀀스 넘버와 같이 기본값에 의해 지원되어 얻어지는 값은 유용합니다. 그러나, 그 테이블의 열을 사용한 식을 지정할 수가 있습니다. RETURNING리스트의 구문은SELECT의 출력 리스트와 동일합니다.
테이블에 행을 추가하려면 그 테이블에 대해서INSERT권한을 가지고 있을 필요가 있습니다. 또 RETURNING를 사용하려면, SELECT권한이 필요합니다. 만약 쿼리문으로 행을 삽입하려고 query 를 사용한다면, 그 쿼리문 내에서 사용되는 모든 테이블에 대해서SELECT권한을 가지고 있을 필요가 있습니다.
기존의 테이블의 이름입니다(schema 수식명도 가능).
table 의 컬럼의 이름입니다. 그 컬럼의 이름은 서브필드의 이름이나 서브스크립트의 정렬과 함께 자격이 주어집니다. (혼합된 컬럼의 몇몇 필드로의 삽입은 다른 필드의 null 값을 남긴다)
모든 열에 각각의 기본값이 설정됩니다.
column 에 대응하는 유효한 식 또는 값을 대입합니다.
대응하는 column 에는 기본값이 설정 될 것입니다.
삽입하는 행을 제공하는 쿼리문(SELECT)를 지정합니다. 구문의 설명에 대해서는 SELECT 문장을 참조해 주세요.
각 행이 삽입된 후, 식이 INSERT에 의해 계산되고 값이 반환됩니다. 이 식에는 table 의 임의의 열 이름을 사용할 수가 있습니다. 삽입된 행의 모든 열을 돌려주는 경우는*이라고 기재해 주세요.
반환되는 열로 사용되는 이름입니다.
정상적으로 종료하면,INSERT는 이하와 같은 명령 태그를 돌려줍니다.
INSERT oid count
count 는 삽입된 행수입니다. count 가 정확하게 1이고 대상의 테이블이 OID를 가지는 경우, oid 는 삽입된 행에 할당할 수 있었던OID입니다. 그 외의 경우, oid 는 0이 됩니다.
INSERT명령어가 RETURNING구를 포함한다면, 그 결과 명령어로 삽입된 행 전체에 대해서 계산을 실시하는RETURNING리스트로 정의한 열과 값을 갖고 있는 SELECT 명령문의 결과와 닮게 될것입니다.
films테이블에 1행을 삽입합니다.
INSERT INTO films VALUES
('UA502', 'Bananas', 105, '1971-07-13', 'Comedy', '82 minutes');
이 예제에서는,len열을 생략 하고 있습니다. 그러므로 여기에는 기본값이 들어갑니다.
INSERT INTO films (code, title, did, date_prod, kind)
VALUES ('T_601', 'Yojimbo', 106, '1961-06-16', 'Drama');
이 예제에서는, 특별한 값이 아닌 그 데이터 열의 DEFAULT를 사용합니다.
INSERT INTO films VALUES
('UA502', 'Bananas', 105, DEFAULT, 'Comedy', '82 minutes');
INSERT INTO films (code, title, did, date_prod, kind)
VALUES ('T_601', 'Yojimbo', 106, DEFAULT, 'Drama');
기본값으로로 완전히 구성되는 행을 삽입합니다.
INSERT INTO films DEFAULT VALUES;
복수행의VALUES구문을 사용해 복수행을 삽입합니다.
INSERT INTO films (code, title, did, date_prod, kind) VALUES
('B6717', 'Tampopo', 110, '1985-02-10', 'Comedy'),
('HG120', 'The Dinner Game', 140, DEFAULT, 'Comedy');
이 예제에서는 films테이블과 같은 열 레이아웃을 가지는tmp_films테이블에서films테이블에 몇몇 행을 삽입합니다.
INSERT INTO films SELECT * FROM tmp_films WHERE date_prod < '2004-05-07';
이 예제에서는, 배열형의 열에 삽입합니다.
-- 3째 늘어놓고 용무의 3×3 매스의 게임반을 작성합니다.
INSERT INTO tictactoe (game, board[1:3][1:3])
VALUES (1, '{{" "," "," "},{" "," "," "},{" "," "," "}}');
--위의 예의 첨자는 사실은 필요 없습니다.
INSERT INTO tictactoe (game, board)
VALUES (2, '{{X," "," "},{" ",O," "},{" ",X," "}}');
distributors테이블에 단일행을 삽입해, 그DEFAULT구에 의해 생성된 순서 번호를 돌려줍니다.
INSERT INTO distributors (did, dname) VALUES (DEFAULT, 'XYZ Widgets') RETURNING did;
RETURNING구는PostgreSQL의 확장인 것을 제외하고, INSERT는 표준 SQL에 준거합니다. 또, 표준 SQL에서는 열이름 리스트가 생략 되었을 때에 표준에 의해 허가되지 않은 VALUES구 또는 query 로 일부의 열이 채워집니다.
query 의 가능한 제한이 SELECT 에서 기술되어 있습니다.