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

22027
2026년 08월 17일 | DBMS Error 가이드

이 글에서 다루는 내용

22027 에러의 원인 분석, 해결 SQL, 예방 방법을 실무 관점에서 정리합니다.

22027 trim error 는?

PostgreSQL 에러 코드 22027(trim_error)은 문자열 처리 함수, 특히 TRIM, LTRIM, RTRIM 등의 함수를 사용할 때 잘못된 인수나 지원되지 않는 형식이 전달될 경우 발생하는 오류입니다. 이 에러는 SQL 표준의 TRIM 함수에서 제거할 문자 집합(trim characters)이나 대상 문자열이 올바르지 않은 형식으로 제공될 때 주로 발생합니다. 실무에서는 데이터 마이그레이션, ETL 파이프라인, 또는 복잡한 문자열 정제(cleansing) 쿼리를 수행하는 과정에서 자주 마주치게 되는 에러입니다.

주요 발생 원인

TRIM 함수에 잘못된 문자셋 또는 NULL 값 전달

TRIM 함수는 제거할 문자 집합(trim characters)을 명시적으로 지정할 수 있는데, 이 인수에 NULL 값이나 예상치 못한 바이트 시퀀스가 포함된 경우 에러가 발생합니다. 특히 외부 시스템에서 가져온 데이터를 그대로 TRIM 함수의 인자로 사용할 때, 값이 NULL이거나 빈 문자열이 아닌 잘못된 형식의 값일 경우 문제가 생깁니다. 이런 상황은 자동화된 데이터 수집 파이프라인에서 입력값을 충분히 검증하지 않았을 때 빈번히 발생합니다.

멀티바이트 문자(UTF-8 등) 처리 시 잘못된 인코딩 사용

PostgreSQL은 기본적으로 UTF-8 인코딩을 사용하지만, 외부 데이터 소스에서 가져온 데이터가 다른 인코딩(EUC-KR, Latin-1 등)으로 저장되어 있는 경우 TRIM 계열 함수가 문자 경계를 제대로 인식하지 못해 에러를 발생시킬 수 있습니다. 특히 멀티바이트 문자의 중간 바이트를 trim 문자로 지정하거나, 손상된(corrupted) 문자열 데이터에 TRIM을 적용할 때 이 문제가 두드러집니다. 레거시 시스템과 연동하거나 CSV 파일을 임포트하는 시나리오에서 자주 발생합니다.

SQL 표준 TRIM 구문과 PostgreSQL 함수형 TRIM 혼용 문제

PostgreSQL은 SQL 표준 방식인 TRIM(LEADING 'x' FROM col)과 함수형 방식인 TRIM('x', col) 두 가지 구문을 모두 지원하지만, 인수 순서나 키워드를 잘못 작성하면 파서가 의도치 않은 방식으로 해석하여 trim error를 유발할 수 있습니다. 특히 다른 RDBMS(Oracle, MySQL 등)에서 마이그레이션된 SQL 쿼리를 그대로 PostgreSQL에서 실행할 때 구문 차이로 인한 에러가 발생하는 경우가 많습니다. 이런 에러는 개발 환경에서는 발견되지 않다가 운영 환경에서 특정 데이터 값이 입력될 때 비로소 드러나는 경우도 있어 더욱 주의가 필요합니다.

해결 방법

원인 1: NULL 또는 잘못된 값 전달 해결

TRIM 함수 호출 전에 COALESCE나 NULLIF를 활용하여 NULL 값 또는 비정상 값을 사전에 처리합니다.

-- 문제가 되는 쿼리 예시
SELECT TRIM(both some_column FROM target_column)
FROM raw_data_table;

-- 해결: COALESCE로 NULL 방어 처리
SELECT TRIM(both COALESCE(some_column, ' ') FROM COALESCE(target_column, ''))
FROM raw_data_table;

-- 또는 CASE WHEN을 활용한 방어적 처리
SELECT
  CASE
    WHEN some_column IS NULL OR target_column IS NULL THEN target_column
    ELSE TRIM(both some_column FROM target_column)
  END AS cleaned_value
FROM raw_data_table;

-- NULL 행을 제외하고 처리하는 방법
SELECT TRIM(both some_column FROM target_column)
FROM raw_data_table
WHERE some_column IS NOT NULL
  AND target_column IS NOT NULL
  AND some_column <> '';

원인 2: 인코딩 문제 해결

손상된 문자열 데이터를 먼저 정제하거나, convert_from / encode 함수를 활용하여 인코딩을 통일한 뒤 TRIM을 적용합니다.

-- 현재 데이터베이스 인코딩 확인
SHOW server_encoding;
SHOW client_encoding;

-- 인코딩 불일치 확인 및 변환
SELECT convert_from(
  convert_to(target_column, 'UTF8'),
  'UTF8'
) AS safe_column
FROM raw_data_table;

-- 유효하지 않은 UTF-8 바이트 시퀀스 필터링 후 TRIM 적용
SELECT TRIM(
  regexp_replace(target_column, '[^\x20-\x7E\u00A0-\uFFFF]', '', 'g')
) AS cleaned_column
FROM raw_data_table;

-- 손상된 문자 포함 여부 사전 점검
SELECT *
FROM raw_data_table
WHERE target_column != convert_from(convert_to(target_column, 'UTF8'), 'UTF8');

-- 안전하게 ASCII 범위만 TRIM 처리
SELECT TRIM(both E'\x00' FROM target_column) AS clean_value
FROM raw_data_table
WHERE octet_length(target_column) = char_length(target_column); -- 순수 ASCII만 처리

원인 3: SQL 구문 오류 해결

PostgreSQL 표준 구문에 맞게 TRIM 함수를 올바르게 재작성합니다.

-- 잘못된 구문 예시 (다른 DB에서 마이그레이션된 쿼리)
-- Oracle 스타일 (PostgreSQL에서 동작하지 않을 수 있음)
SELECT TRIM(' ' FROM ' Hello World ') FROM dual;

-- 올바른 PostgreSQL SQL 표준 구문
SELECT TRIM(LEADING ' ' FROM '   Hello World   ');   -- 왼쪽 공백 제거
SELECT TRIM(TRAILING ' ' FROM '   Hello World   ');  -- 오른쪽 공백 제거
SELECT TRIM(BOTH ' ' FROM '   Hello World   ');      -- 양쪽 공백 제거
SELECT TRIM('   Hello World   ');                    -- 기본값: BOTH + 공백

-- 함수형 구문 사용 시 올바른 인수 순서
SELECT btrim('   Hello World   ', ' ');  -- 양쪽
SELECT ltrim('   Hello World   ', ' ');  -- 왼쪽
SELECT rtrim('   Hello World   ', ' ');  -- 오른쪽

-- 실제 운영 테이블에 적용하는 예시
UPDATE customer_table
SET customer_name = TRIM(BOTH ' ' FROM customer_name)
WHERE customer_name IS NOT NULL
  AND customer_name <> TRIM(BOTH ' ' FROM customer_name);

-- 배치 처리 시 함수로 래핑하여 안전하게 처리
CREATE OR REPLACE FUNCTION safe_trim(input_text TEXT)
RETURNS TEXT
LANGUAGE plpgsql
AS $$
BEGIN
  IF input_text IS NULL THEN
    RETURN NULL;
  END IF;
  RETURN TRIM(BOTH ' ' FROM input_text);
EXCEPTION
  WHEN OTHERS THEN
    RETURN input_text; -- 에러 발생 시 원본 반환
END;
$$;

-- safe_trim 함수 사용
SELECT safe_trim(customer_name) AS cleaned_name
FROM customer_table;

예방 방법

입력 데이터 검증 및 방어적 함수 래퍼 사용

운영 환경에서 외부 데이터를 다루는 모든 쿼리에는 반드시 입력값 검증 로직을 포함해야 합니다. 위의 safe_trim 함수처럼 예외 처리 블록(EXCEPTION WHEN OTHERS)을 포함한 래퍼 함수를 만들어 두면, 예상치 못한 데이터가 들어와도 파이프라인 전체가 중단되지 않고 안전하게 처리됩니다. 또한 ETL 작업 전에 데이터 품질 점검 쿼리를 실행하여 NULL, 빈 문자열, 비정상 인코딩 데이터를 사전에 필터링하는 습관을 들이는 것이 좋습니다.

“`sql

— ETL 전처리 단계에서 데이터 품질 점검

SELECT

COUNT(*) AS total_rows,

COUNT(*) FILTER (WHERE target_column IS NULL) AS null_count,

COUNT(*) FILTER (WHERE target_column = ”) AS empty_count,

COUNT(*) FILTER (WHERE target_column ~ ‘[^\x20-\x7E]’) AS non_ascii_count

FROM raw_data_table;

“`

데이터베이스 인코딩 통일 및 CHECK 제약 조건 활용

데이터베이스 생성 시 인코딩을 UTF-8로 명시적으로 설정하고, 문자열 컬럼에 CHECK 제약 조건을 추가하여 비정상 데이터가 저장되지 않도록 방어합니다. 이렇게 하면 TRIM 에러를 포함한 다양한 문자열 처리 에러를 근본적으로 예방할 수 있습니다.

“`sql

— DB 생성 시 인코딩 명시

CREATE DATABASE mydb

ENCODING ‘UTF8’

LC_COLLATE ‘ko_KR.UTF-8’

LC_CTYPE ‘ko_KR.UTF-8’;

— CHECK 제약으로 비정상 문자열 차단

ALTER TABLE customer_table

ADD CONSTRAINT chk_customer_name_valid

CHECK (customer_name = TRIM(customer_name) AND customer_name <> ”);

“`