Oracle DB를 사용하다 보면
“이 컬럼이 무슨 뜻이지?”, “누가 설명 좀 써놨나?” 궁금하신 적 있으시죠? 🤔
오라클에서는 각 테이블의 컬럼에 코멘트(Comment)를 추가할 수 있고,
그 정보는 메타 테이블(ALL_COL_COMMENTS 등)을 통해 쉽게 조회할 수 있습니다.
이번 글에서는 오라클에서 컬럼의 설명(코멘트)을 조회하는 SQL을
실무에서 바로 사용할 수 있도록 예시와 함께 정리해드릴게요! 📘
📌 1. 오라클에서 컬럼 코멘트(Comment)란?
Oracle에서는 테이블과 컬럼에 대해 간단한 설명 또는 주석을 COMMENT 문으로 등록할 수 있습니다.
이 정보는 SQL 작성 시 컬럼 이해를 돕거나, 문서화 시 매우 유용하게 쓰이죠. ✍️
🔍 2. 컬럼 코멘트 조회 SQL (ALL_COL_COMMENTS 사용)
SELECT
table_name,
column_name,
comments
FROM
all_col_comments
WHERE
table_name = 'YOUR_TABLE_NAME'
AND owner = 'YOUR_SCHEMA_NAME'; -- 대문자 필수✅ all_col_comments: 전체 사용자들의 컬럼 코멘트를 볼 수 있는 뷰
✅ user_col_comments: 내 계정에서 만든 테이블만 조회할 경우 사용
📎 TIP: Oracle에서는 테이블명과 컬럼명, 스키마명을 대문자로 넣는 것이 일반적
📊 3. 예시 결과
| TABLE_NAME | COLUMN_NAME | COMMENTS |
| EMPLOYEES | EMP_ID | 사원 고유 번호 |
| EMPLOYEES | NAME | 사원 이름 |
| EMPLOYEES | JOIN_DATE | 입사일 (YYYY-MM-DD) |
🧠 4. 컬럼 코멘트가 없는 경우?
- 코멘트를 별도로 작성하지 않았다면, COMMENTS 칼럼이 NULL로 표시됩니다.
- 코멘트를 등록하려면 다음과 같이 COMMENT ON COLUMN 문을 사용합니다.
COMMENT ON COLUMN employees.emp_id IS '사원 고유 번호';이후 다시 조회하면 해당 코멘트가 정상적으로 표시됩니다 ✅
✅ 5. 실무 활용 팁
- 📌 데이터 모델링 문서 작성 시, 코멘트를 SQL로 추출하면 자동화 가능
- 📌 다른 개발자와 협업할 때 컬럼 의미 공유에 유용
- 📌 DB 리버스 엔지니어링 시에도 COMMENT 조회는 필수!
🏁 마무리 요약
Oracle에서는 컬럼 설명을 COMMENT로 등록 및 조회할 수 있습니다.
ALL_COL_COMMENTS, USER_COL_COMMENTS 뷰를 활용하면
DB 내 모든 테이블의 컬럼 코멘트를 한 번에 확인 가능하죠.
쿼리 자동화나 문서화가 필요할 때 유용하게 사용해 보세요!