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_NAMECOLUMN_NAMECOMMENTS
EMPLOYEESEMP_ID사원 고유 번호
EMPLOYEESNAME사원 이름
EMPLOYEESJOIN_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 내 모든 테이블의 컬럼 코멘트를 한 번에 확인 가능하죠.

쿼리 자동화나 문서화가 필요할 때 유용하게 사용해 보세요!