Menu

PostgreSQL CREATE TABLE 사용법: 문법과 예제

CREATE TABLE은 테이블의 컬럼, 타입, 제약 조건을 정의합니다. identity 키, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS, LIKE를 다룹니다.

이 페이지에는 실행 가능한 에디터가 있습니다. 편집하고 실행하면 결과를 바로 볼 수 있습니다.

CREATE TABLE name (column type constraints, ...)은 테이블을 만듭니다. 각 컬럼에는 이름과 데이터 타입을 주고, 그 뒤에 PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE, CHECK 같은 제약 조건을 선택적으로 붙입니다.

id 컬럼은 스스로 번호를 매기고, INSERT에서 plan을 빼면 'free'가 들어가며, created_at에는 INSERT 시각이 기록됩니다. 자주 쓰는 컬럼 타입은 데이터 타입 페이지에 정리되어 있습니다.

컬럼 제약 조건

제약 조건효과
PRIMARY KEY고유하고 NULL 불가, 테이블당 하나
NOT NULL컬럼에 반드시 값이 있어야 함
DEFAULT exprINSERT에서 컬럼을 빼면 쓰는 값
UNIQUE두 행이 같은 값을 가질 수 없음(NULL은 여러 개 허용)
CHECK (expr)식이 거짓인 행을 거부
REFERENCES t (col)다른 테이블을 가리키는 외래 키

PostgreSQL 15부터 UNIQUE NULLS NOT DISTINCT는 NULL을 같은 값으로 취급하므로, 그 컬럼에 NULL을 가진 행은 하나만 있을 수 있습니다.

여러 컬럼에 걸친 규칙

둘 이상의 컬럼에 거는 제약 조건은 컬럼 정의 뒤에 별도 줄로 씁니다. CONSTRAINT name으로 이름을 붙이면 오류 메시지를 읽기 쉽고, 나중에 이름으로 삭제할 수 있습니다.

쿼리는 제약 조건 세 개를 보여 줍니다. 이름 없는 제약 조건에는 bookings_guests_check와 bookings_pkey라는 이름이 자동으로 붙었습니다.

테이블이 없을 때만 만들기

IF NOT EXISTS를 쓰면 두 번째 CREATE TABLE은 오류 대신 알림(notice)만 냅니다. 이름만 확인합니다. logs라는 테이블이 다른 컬럼으로 이미 있다면 아무것도 바뀌지 않습니다.

쿼리 결과나 다른 테이블로 테이블 만들기

CREATE TABLE ... AS는 SELECT 결과로 테이블을 만들며, 결과의 컬럼과 타입을 그대로 씁니다. LIKE는 다른 테이블의 정의를 행 없이 복사하고, INCLUDING ALL을 붙이면 기본값, 제약 조건, identity, 인덱스까지 가져옵니다.

big_orders에는 행이 하나 있습니다. orders_archive는 orders의 컬럼과 제약 조건을 가지며 행은 없습니다.

생성 컬럼

생성 컬럼은 같은 행의 다른 컬럼으로 계산되며, INSERT로 값을 쓸 수 없습니다. PostgreSQL 17에서는 STORED여야 합니다. 값은 쓸 때 계산되어 디스크에 저장됩니다.

합계는 13.5와 20입니다.

임시 테이블과 unlogged 테이블

CREATE TEMP TABLE은 현재 세션에서만 보이고 세션이 끝나면 삭제되는 테이블을 만듭니다. 긴 스크립트의 중간 결과에 알맞습니다. CREATE UNLOGGED TABLE은 write-ahead log(WAL)를 건너뛰므로 쓰기가 빠릅니다. 장애 후에는 테이블이 비워지고 복제본에도 복사되지 않으므로, 다시 만들 수 있는 데이터에만 쓰세요.

CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);

이미 만든 테이블을 바꾸려면 ALTER TABLE을 쓰세요. 모든 옵션은 CREATE TABLE 레퍼런스에 있습니다.

자주 묻는 질문

PostgreSQL 테이블 이름은 대소문자를 구분하나요?

따옴표 없는 이름은 소문자로 바뀌므로 CREATE TABLE Users는 users를 만듭니다. "Users"처럼 따옴표로 감싼 이름은 대소문자가 유지되고, 이후 모든 쿼리에서 따옴표를 붙여야 합니다. 그래서 소문자 snake_case 이름이 일반적입니다.

PostgreSQL에서 테이블 구조는 어떻게 확인하나요?

psql에서 \d table_name이 컬럼, 타입, 기본값, 인덱스, 제약 조건을 보여 줍니다. SQL로는 information_schema.columns WHERE table_name = 'table_name'을 조회하세요.

PostgreSQL에서 테이블은 어떻게 복사하나요?

CREATE TABLE copy AS TABLE original;은 컬럼과 행을 복사하지만 제약 조건과 인덱스는 복사하지 않습니다. CREATE TABLE copy (LIKE original INCLUDING ALL);은 기본값, 제약 조건, 인덱스를 포함한 구조를 복사하고 행은 복사하지 않습니다.

PostgreSQL에서 테이블은 어떻게 삭제하나요?

DROP TABLE table_name;은 테이블과 데이터를 지웁니다. DROP TABLE IF EXISTS table_name;은 테이블이 없을 때 오류를 내지 않고, CASCADE는 그 테이블에 의존하는 뷰와 외래 키도 함께 지웁니다.

Coddy 프로그래밍 언어 일러스트

Coddy로 코딩 배우기

시작하기