[ORACLE] ORA-01747 : 부적절한 열 이름 오류 해결 가이드

[ORACLE] ORA-01747

1. ORA-01747 오류란 무엇인가?

Oracle Database를 사용하다 보면 종종 마주치는 오류 중 하나가 ORA-01747: 부적절한 열 이름입니다. 이 오류는 SQL이나 PL/SQL 문에서 컬럼 이름이나 식별자(identifier)를 잘못 사용했을 때 발생합니다. 특히, INSERT, UPDATE, SELECT문에서 컬럼명 위치에 상수값이나 잘못된 문법이 사용되었을 때 주로 나타납니다.

2. ORA-01747 오류 발생 예시와 원인

다음은 오류가 발생하는 대표적인 예시입니다:

UPDATE employees
SET 'salary' = 5000
WHERE employee_id = 101;
      

오류 원인: 컬럼 이름인 salary가 따옴표('')로 묶여 문자열 상수로 처리되었습니다. 오라클은 이를 열 이름으로 인식하지 못합니다.

또 다른 예:

INSERT INTO customers ('name', 'email') VALUES ('홍길동', 'hong@test.com');
      

오류 원인: 컬럼명을 작은따옴표('')로 감싸면 문자열로 간주되어 ORA-01747 오류가 발생합니다.

3. 해결 방법과 실무 적용 팁

• 컬럼명에는 작은따옴표(')가 아닌 큰따옴표(") 또는 따옴표 없이 사용해야 함
• 컬럼명을 예약어(예: DATE, NUMBER, USER)로 지정하지 말 것
• 컬럼명을 시작할 때 숫자로 시작하지 말 것
• 테이블이나 컬럼 이름에 공백, 특수문자 포함 금지

위 UPDATE 구문의 올바른 형태는 다음과 같습니다:

UPDATE employees
SET salary = 5000
WHERE employee_id = 101;
      

4. 자주 혼동되는 구문 비교

잘못된 구문	설명	올바른 구문
SET 'salary' = 5000	컬럼명을 문자열로 인식	SET salary = 5000
INSERT INTO emp ('name')	작은따옴표는 문자열용	INSERT INTO emp (name)
UPDATE "TABLE" SET col=1	예약어 사용	UPDATE employees SET col=1

5. 실무에서의 예방 전략

다음과 같은 예방 전략을 통해 ORA-01747 오류를 방지할 수 있습니다:

1. SQL 자동 포매터 사용: JetBrains DataGrip, SQL Developer 등에서 쿼리 정리
2. 명명 규칙 통일: 프로젝트마다 컬럼/테이블 이름 규칙을 명확히 정의
3. SQL Linter 도구 도입: 예를 들어 SQLFluff를 활용하면 사전 문법 검사 가능
4. 쿼리 리뷰 프로세스 운영: 실무자 검수 과정에서 오류 조기 발견

6. 개발자들이 자주 하는 실수

다음은 실무에서 자주 발생하는 오류 사례입니다:

• 컬럼 이름과 값의 위치를 헷갈려서 SQL 문을 작성
• 동적 SQL에서 변수와 컬럼을 혼동
• 툴에서 자동 완성으로 잘못된 명칭을 선택
• 한글 Windows 환경에서 복사 붙여넣기 시 공백/문자 손상

7. 결론

ORA-01747 오류는 Oracle SQL 초보자부터 숙련자까지 자주 마주하는 일반적인 오류지만, 원인과 패턴을 파악하면 충분히 예방 가능합니다. 오류 메시지를 무작정 복사해서 검색하기보다는, SQL 문법의 구조적 이해와 디버깅 능력 향상이 오히려 효율적인 개발을 이끕니다. 실무에서는 명명 규칙의 일관성과 쿼리 작성 습관이 무엇보다 중요합니다.

8. 참고 출처

• Oracle 공식 문서: https://docs.oracle.com/en/database/
• Oracle Error Message Reference - ORA-01747: https://www.ora-error.com/ora-01747
• Stack Overflow – ORA-01747 관련 토론: https://stackoverflow.com/questions/14301944/ora-01747-invalid-user-table-column