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

-- 문제가 되는 쿼리 (BIT(8) 컬럼에 3비트 삽입 → 경고 발생)
CREATE TABLE bit_test (
    id      SERIAL PRIMARY KEY,
    flags   BIT(8) NOT NULL
);

-- 경고 발생: implicit zero bit padding
INSERT INTO bit_test (flags) VALUES (B'101');

-- 해결책 1: 길이를 정확히 맞춰 삽입
INSERT INTO bit_test (flags) VALUES (B'10100000');

-- 해결책 2: lpad 함수를 활용해 동적으로 우측 패딩 처리
-- (문자열 기반으로 비트를 만들 때 유용)
INSERT INTO bit_test (flags)
SELECT (rpad(bit_str, 8, '0'))::BIT(8)
FROM (VALUES ('101')) AS t(bit_str);

-- 결과 확인
SELECT id, flags, flags::TEXT AS flags_text
FROM bit_test;

-- 문제 상황: 다양한 길이의 비트 문자열이 섞인 스테이징 테이블
CREATE TABLE staging_bits (
    raw_bits TEXT
);

INSERT INTO staging_bits (raw_bits)
VALUES ('1'), ('1010'), ('110011'), ('10101010');

-- 경고 발생하는 방식 (길이 불일치 캐스팅)
SELECT raw_bits::BIT(8) FROM staging_bits;

-- 해결책: rpad로 8자리로 정규화한 후 캐스팅
SELECT
    raw_bits,
    rpad(raw_bits, 8, '0')::BIT(8) AS normalized_bits
FROM staging_bits;

-- 길이 검증 로직 포함 버전 (길이 초과 데이터도 방어)
SELECT
    raw_bits,
    CASE
        WHEN length(raw_bits) > 8
            THEN left(raw_bits, 8)::BIT(8)          -- 초과분 절삭
        WHEN length(raw_bits) < 8
            THEN rpad(raw_bits, 8, '0')::BIT(8)     -- 부족분 패딩
        ELSE
            raw_bits::BIT(8)                          -- 정확히 8자리
    END AS safe_bits
FROM staging_bits;

-- 비트 연산 결과 길이 확인
SELECT
    B'10100000' & B'11110000' AS and_result,
    bit_length(B'10100000' & B'11110000') AS result_length;

-- substring으로 비트를 자른 뒤 저장 시 길이 불일치 방지
-- substring 결과가 8비트보다 짧을 수 있으므로 패딩 명시
WITH computed AS (
    SELECT substring(B'10110001' FROM 1 FOR 5) AS partial_bits
)
INSERT INTO bit_test (flags)
SELECT
    CASE
        WHEN bit_length(partial_bits) < 8
            THEN (partial_bits::TEXT || repeat('0', 8 - bit_length(partial_bits)))::BIT(8)
        ELSE partial_bits::BIT(8)
    END
FROM computed;

-- 저장된 데이터 확인
SELECT id, flags, flags::TEXT, bit_length(flags) AS len
FROM bit_test
ORDER BY id;

-- CHECK 제약 조건으로 정확한 비트 길이 강제
ALTER TABLE bit_test
ADD CONSTRAINT chk_flags_length
CHECK (bit_length(flags) = 8);

-- 또는 테이블 생성 시부터 적용
CREATE TABLE bit_strict (
    id      SERIAL PRIMARY KEY,
    flags   BIT(8) NOT NULL,
    CONSTRAINT chk_exact_length CHECK (bit_length(flags) = 8)
);

-- 로그 레벨 설정 확인 (postgresql.conf 또는 세션 레벨)
SET client_min_messages = 'WARNING';
SHOW client_min_messages;

-- 안전한 비트 변환 래퍼 함수
CREATE OR REPLACE FUNCTION safe_to_bit(
    p_bit_str  TEXT,
    p_length   INT
)
RETURNS BIT
LANGUAGE plpgsql
AS $$
DECLARE
    v_padded TEXT;
BEGIN
    IF length(p_bit_str) > p_length THEN
        RAISE EXCEPTION '비트 문자열 길이(%)가 지정 길이(%)를 초과합니다.',
            length(p_bit_str), p_length;
    ELSIF length(p_bit_str) < p_length THEN
        v_padded := rpad(p_bit_str, p_length, '0');
        RAISE NOTICE '비트 패딩 적용: % → %', p_bit_str, v_padded;
    ELSE
        v_padded := p_bit_str;
    END IF;

    RETURN v_padded::BIT(64);  -- 최대 64비트 지원 예시
END;
$$;

-- 사용 예시
SELECT safe_to_bit('101', 8);    -- NOTICE 발생 + 10100000 반환
SELECT safe_to_bit('10101010', 8); -- 정상 처리