기본 키는 각 행을 식별하는 컬럼 또는 컬럼 묶음입니다. 값은 고유하고 NULL이 아니어야 하며, 테이블당 하나만 둘 수 있습니다. PostgreSQL에서는 보통 identity 컬럼으로 데이터베이스가 생성하게 합니다. id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY처럼 씁니다.
id는 1과 2입니다. 키를 정의하면 users_pkey라는 고유 인덱스도 함께 만들어집니다.
identity 컬럼: ALWAYS와 BY DEFAULT
identity 컬럼은 행에 번호를 매기는 SQL 표준 방식이며 PostgreSQL 10부터 쓸 수 있습니다. 두 가지 형태가 있습니다.
GENERATED ALWAYS AS IDENTITY는 INSERT가OVERRIDING SYSTEM VALUE를 쓰지 않는 한,INSERT에서 직접 넣은 값을 거부합니다. 더 안전한 기본 선택입니다.GENERATED BY DEFAULT AS IDENTITY는 값을 주지 않았을 때만 생성된 값을 씁니다.
BY DEFAULT에서 id를 직접 넣으면 시퀀스가 뒤처지고, 다음에 생성되는 id가 충돌합니다. 명시적인 id로 행을 가져온 뒤에는 setval로 시퀀스를 가장 큰 id 뒤로 옮기세요.
setval 줄이 없으면 마지막 INSERT는 id 1을 받아 중복 키 오류로 실패합니다. 이 줄이 있으면 새 행은 4를 받습니다.
SERIAL과 identity 비교
serial(4바이트)과 bigserial(8바이트)은 진짜 타입이 아닙니다. 시퀀스를 만들고 컬럼의 기본값을 그 시퀀스의 nextval()로 설정하는 줄임말입니다.
이 컬럼은 기본값이 nextval('legacy_id_seq'::regclass)인 평범한 integer입니다. INSERT가 id를 직접 쓰는 것을 막을 방법이 없고, 시퀀스에 별도 권한이 필요합니다. identity 컬럼은 두 문제를 모두 해결하므로 새 테이블에서는 identity를 쓰세요. serial도 여전히 동작하며, 오래된 스키마와 튜토리얼에서 자주 보게 됩니다.
커질 수 있는 테이블에는 bigint(또는 bigserial)를 쓰세요. integer 키는 약 21억 개에서 바닥납니다.
UUID 기본 키
gen_random_uuid()는 무작위 버전 4 UUID를 돌려줍니다. PostgreSQL 13부터 내장되어 있어 확장이 필요 없습니다.
실행할 때마다 다른 id가 나오며, 텍스트로는 각각 36자입니다. uuid 타입은 16바이트에 저장하므로 text 대신 uuid를 쓰세요. PostgreSQL 18에는 인덱스 순서대로 들어가는 시간순 UUID를 만드는 uuidv7()이 추가됩니다. PostgreSQL 17에서는 애플리케이션에서 생성하세요.
복합 기본 키
키는 여러 컬럼에 걸칠 수 있으며, CREATE TABLE에서 별도 줄로 씁니다. 각 쌍이 한 번만 나와야 하는 연결 테이블의 자연스러운 키입니다.
반복된 쌍 (1, 10)은 건너뛰므로 개수는 3입니다. 기존 테이블에 키를 추가하려면 ALTER TABLE t ADD PRIMARY KEY (col)을 쓰세요. 다른 변경은 ALTER TABLE 페이지에서 다룹니다. 다른 테이블은 외래 키로 이 키를 가리킵니다.
자주 묻는 질문
PostgreSQL에 AUTO_INCREMENT가 있나요?
그 이름으로는 없습니다. 표준 방식은 PostgreSQL 10부터 쓸 수 있는 identity 컬럼, id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY입니다. 예전의 serial과 bigserial 타입도 시퀀스와 기본값으로 같은 일을 합니다.
PostgreSQL id 시퀀스에 빈 번호가 생기는 이유는 무엇인가요?
시퀀스는 INSERT가 나중에 실패하거나 트랜잭션이 롤백되어도 값을 내주며, 그 값은 다시 쓰이지 않습니다. 빈 번호는 정상이고 문제가 없으니, id가 연속이라고 가정하지 마세요.
PostgreSQL에서 기본 키를 만들면 인덱스도 생기나요?
네. 기본 키(그리고 모든 UNIQUE 제약 조건)는 고유 B-tree 인덱스를 자동으로 만들며, 기본 키 인덱스의 이름은 tablename_pkey입니다.
기본 키로 UUID와 bigint 중 무엇을 써야 하나요?
bigint identity 키는 더 작고(8바이트 대 16바이트) 인덱스 순서대로 들어갑니다. UUID는 데이터베이스를 거치지 않고 어디서든 만들 수 있고, 행이 몇 개인지 드러내지 않습니다. 무작위 UUID는 INSERT가 인덱스 여기저기에 흩어지므로 큰 테이블에서는 비용이 더 듭니다.