DataHub 테이블·컬럼 설명 완성도 현황 조사

질문

DataHub 의 Table Description 보강 계획을 세우기 위해, 현재 테이블·컬럼 단위 설명 작성 상태가 어느 수준인지 파악한다.

방법 / 데이터

Databricks 노트북으로 전체 테이블·컬럼의 Description 작성 여부를 쿼리해 집계했다. 상세 집계 데이터는 별도 Google Sheet 에 있다.

• 쿼리: Databricks 노트북 (원문에 노트북 링크로 연결. 이번 실행에서는 열지 않았다)
• 상세 데이터: https://docs.google.com/spreadsheets/d/1tPc-tHIFT5QGOZsgQT7D_9hLJyQHZ9w7YpCqelWrDPI/edit?usp=sharing

Table Description 판단 기준 — 아래 템플릿(제목 + 리스트 형식)에 맞춰 작성됐는지로 나눈다.

판정	기준
양호	템플릿에 맞춰 작성 완료 (제목 + 리스트 형식)
미흡	작성되었으나 템플릿에 맞지 않음
누락	전혀 작성되지 않음

Table Description Template:

## 테이블 설명
- 이 테이블의 목적과 간단한 설명
- 저장되어 있는 데이터의 주된 특징

Column Description 은 테이블별로 컬럼 Description 이 작성된 컬럼의 비율(완성도)을 0-9%부터 100%까지 10%p 구간으로 나눠 집계했다.

확인된 사실 / Findings

1. Table Description 현황 (전체 3258건)

상태	개수	비율
양호	107	3.3%
미흡	134	4.1%
누락	3017	92.6%
총계	3258	100%

2. Column Description 완성도 구간별 분포 (전체 3258건)

완성도 구간	개수	비율
0-9%	2237	68.7%
10-19%	19	0.6%
20-29%	15	0.5%
30-39%	15	0.5%
40-49%	13	0.4%
50-59%	15	0.5%
60-69%	18	0.6%
70-79%	34	1.0%
80-89%	126	3.9%
90-99%	373	11.4%
100%	393	12.1%
총계	3258	100%

아직 모르는 것

• 이 조사가 실제로 실행된 날짜가 원문에 없다.
• 이 현황 결과를 바탕으로 어떤 보강 계획·우선순위가 수립됐는지는 이 원문에 없다 — 후속 결정은 「관련 문서」의 워크플로우 재구축 결정에서 다룬다.

관련 문서

• 테이블 문서 작성 시 사용하는 템플릿과 작성 방법 — technology-data/data-platform/datahub-table-documentation-tagging-guide.md
• 이 현황 파악을 선행 작업으로 인용한 후속 결정 — technology-data/data-platform/datahub-metadata-quality-workflow-decision.md