PostgreSQL 01004 오류 원인과 해결 방법 완벽 가이드

-- 문제가 되는 상황 재현
CREATE TABLE users (
    id      SERIAL PRIMARY KEY,
    username VARCHAR(10) NOT NULL
);

-- 10자 초과 데이터 삽입 시도
INSERT INTO users (username) VALUES ('이것은열글자를초과하는사용자이름입니다');
-- ERROR: value too long for type character varying(10)

-- 해결 1: 삽입 전 길이 확인
SELECT LENGTH('이것은열글자를초과하는사용자이름입니다'); -- 문자 수 반환

-- 해결 2: LEFT()로 명시적 절삭 후 삽입 (데이터 손실 감수)
INSERT INTO users (username)
VALUES (LEFT('이것은열글자를초과하는사용자이름입니다', 10));

-- 해결 3: CASE 구문으로 조건 분기
INSERT INTO users (username)
SELECT
    CASE
        WHEN LENGTH(username_input) > 10
            THEN SUBSTRING(username_input FROM 1 FOR 10)
        ELSE username_input
    END
FROM (SELECT '이것은열글자를초과하는사용자이름입니다' AS username_input) t;

-- 현재 컬럼 정의 확인
SELECT
    column_name,
    data_type,
    character_maximum_length
FROM information_schema.columns
WHERE table_name = 'users'
  AND column_name = 'username';

-- VARCHAR 길이 확장 (PostgreSQL에서는 길이 증가는 테이블 락 없이 즉시 반영)
ALTER TABLE users
    ALTER COLUMN username TYPE VARCHAR(100);

-- 길이 제한이 사실상 불필요한 경우 TEXT 타입으로 변경 (권장)
ALTER TABLE users
    ALTER COLUMN username TYPE TEXT;

-- 변경 후 확인
\d users

-- 데이터베이스 인코딩 확인
SHOW server_encoding;
SELECT pg_encoding_to_char(encoding) FROM pg_database WHERE datname = current_database();

-- 문자 수 vs 바이트 수 비교 확인
SELECT
    '한글테스트' AS sample_text,
    LENGTH('한글테스트')          AS char_length,   -- 문자 수: 5
    OCTET_LENGTH('한글테스트')    AS byte_length;   -- 바이트 수: 15 (UTF-8 기준)

-- 바이트 기준으로 길이를 제한해야 하는 경우
-- (외부 시스템과 연동 시 바이트 제한이 있을 때)
SELECT
    input_text,
    SUBSTRING(input_text FROM 1 FOR
        -- 바이트 30 이내에서 최대한 많은 문자 포함
        LENGTH(CONVERT_TO(input_text, 'UTF8')::text)
    ) AS safe_text
FROM (SELECT '한글이포함된긴문자열데이터입니다' AS input_text) t;

-- pg_column_size로 실제 저장 크기 확인
SELECT pg_column_size('한글테스트'::text) AS storage_size;

-- 권장하는 컬럼 설계 패턴
CREATE TABLE products (
    id           SERIAL PRIMARY KEY,
    product_code TEXT NOT NULL,
    product_name TEXT NOT NULL,
    description  TEXT,

    -- 비즈니스 규칙이 있는 경우에만 CHECK 제약 조건 사용
    CONSTRAINT chk_product_code_length CHECK (LENGTH(product_code) <= 20),
    CONSTRAINT chk_product_name_length CHECK (LENGTH(product_name) <= 200)
);

-- 길이 제한 변경 시 CHECK 제약 조건만 수정하면 됨
ALTER TABLE products
    DROP CONSTRAINT chk_product_name_length;

ALTER TABLE products
    ADD CONSTRAINT chk_product_name_length CHECK (LENGTH(product_name) <= 500);

-- 마이그레이션 또는 대량 적재 전 사전 검증 쿼리
-- 각 컬럼의 최대 길이를 컬럼 정의와 비교
SELECT
    'username'                          AS column_name,
    MAX(LENGTH(username))               AS max_data_length,
    10                                  AS column_limit,
    COUNT(CASE WHEN LENGTH(username) > 10 THEN 1 END) AS violation_count
FROM staging_users

UNION ALL

SELECT
    'email'                             AS column_name,
    MAX(LENGTH(email))                  AS max_data_length,
    255                                 AS column_limit,
    COUNT(CASE WHEN LENGTH(email) > 255 THEN 1 END) AS violation_count
FROM staging_users;

-- 위반 데이터 상세 조회
SELECT id, username, LENGTH(username) AS len
FROM staging_users
WHERE LENGTH(username) > 10
ORDER BY len DESC
LIMIT 20;