데이터베이스·스키마·테이블 만들기

PostgreSQL 안에서 데이터는 계층 구조로 정리됩니다. 가장 바깥에 데이터베이스(database), 그 안에 스키마(schema), 그 안에 테이블(table)·뷰·함수가 있습니다. 3편에서는 이 세 계층을 직접 만들고, 적절한 이름을 짓고, 안전하게 지우는 법까지 정리합니다.

계층 구조 — DB ⊃ 스키마 ⊃ 테이블

CREATE DATABASE

postgres=# CREATE DATABASE myshop
             OWNER junai_app
             ENCODING 'UTF8'
             LC_COLLATE 'ko_KR.UTF-8'
             LC_CTYPE   'ko_KR.UTF-8'
             TEMPLATE template0;
CREATE DATABASE

-- 접속
postgres=# \c myshop
You are now connected to database "myshop"
myshop=#

한국어 정렬·대소문자 처리에 LC_COLLATE/LC_CTYPE 가 영향을 줍니다. 한국어 환경이라면 ko_KR.UTF-8 을 권장. TEMPLATE template0 은 "빈 베이스에서 시작" 이라는 뜻으로, locale 충돌을 피하는 안전한 기본값입니다.

CREATE SCHEMA — 모듈 분리

myshop=# CREATE SCHEMA shop;        -- 상품·주문 모듈
myshop=# CREATE SCHEMA auth;        -- 회원·세션 모듈
myshop=# CREATE SCHEMA log;         -- 로그 보관

-- 스키마 안에 테이블
myshop=# CREATE TABLE shop.products (...);
myshop=# CREATE TABLE auth.users    (...);

-- 매번 shop. 을 안 적으려면 search_path 설정
myshop=# SET search_path TO shop, public;
myshop=# CREATE TABLE orders (...);   -- shop.orders 가 됨

스키마는 "네임스페이스" 라고 생각하면 됩니다. shop.users 와 auth.users 가 같은 DB 안에서 충돌 없이 공존할 수 있게요. 작은 서비스는 public 하나만 써도 충분합니다.

CREATE TABLE — 첫 테이블

CREATE TABLE shop.products (
  id          BIGSERIAL PRIMARY KEY,
  name        TEXT       NOT NULL,
  slug        TEXT       NOT NULL UNIQUE,
  price       NUMERIC(10,2) NOT NULL CHECK (price >= 0),
  stock       INTEGER    NOT NULL DEFAULT 0,
  attributes  JSONB      NOT NULL DEFAULT '{}'::jsonb,
  created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
  updated_at  TIMESTAMPTZ
);

-- 빠른 조회용 인덱스
CREATE INDEX ix_products_created ON shop.products (created_at DESC);
CREATE INDEX ix_products_attrs   ON shop.products USING GIN (attributes);

이 한 정의 안에 4편(자료형)·5편(CRUD)·16편(인덱스) 의 미리보기가 다 들어 있습니다.

• BIGSERIAL — 자동 증가 정수 PK (1, 2, 3...)
• NOT NULL — 비어 있을 수 없음
• UNIQUE — 같은 값 중복 금지
• CHECK (price >= 0) — 값 제약
• DEFAULT — 입력 안 하면 기본값
• JSONB — 구조 자유 데이터(12편 에서 자세히)
• TIMESTAMPTZ — 시간대 인식 시각

명명 규칙 — 미래의 나를 위해

이름은 한 번 정하면 바꾸기 어렵습니다. 처음부터 일관되게.

DROP — 안전하게 지우기

-- 테이블
DROP TABLE shop.products;                   -- 없으면 에러
DROP TABLE IF EXISTS shop.products;         -- 없어도 통과 (안전)

-- 참조하는 외래키도 같이
DROP TABLE shop.products CASCADE;           -- ⚠️ 다른 곳도 같이 날아감

-- 스키마 통째
DROP SCHEMA shop CASCADE;                   -- ⚠️ 안의 모든 테이블 삭제

-- 데이터베이스 (현재 접속 중인 DB 는 못 지움)
\c postgres
DROP DATABASE myshop;