Datahub 처음 사용자 가이드

목적

데이터 허브(Datahub)는 회사 전반의 데이터 자산(테이블, 컬럼, 파이프라인, 대시보드 등)을 한 곳에 모아 검색·탐색·이해할 수 있게 해주는 플랫폼이다. 메타데이터를 서로 연결해 데이터의 흐름과 맥락을 파악할 수 있고, "내가 필요한 데이터가 어디 있지?"라는 질문을 줄여 자율적인 데이터 탐색 문화를 만드는 것이 목표다.

주요 기능은 다음과 같다.

• 메타데이터 검색 & 탐색 — 테이블·컬럼·스키마·파이프라인·대시보드 등 모든 데이터 자산을 통합 검색하고, 설명·태그·오너·생성일 등으로 필터링할 수 있다
• 데이터 문서화 & 컨텍스트 제공 — 데이터 자산에 설명·주석·태그·담당자 등을 붙여 문서화하고, 변경 이력도 추적할 수 있다
• 데이터 계보 추적(Data Lineage) — 테이블 간 변환 흐름을 ETL → 테이블 → BI 툴까지 시각적으로 보여준다
• 오너십 및 책임자 지정 — 테이블·대시보드·파이프라인마다 담당자를 명시해 문의 대상을 명확히 한다
• 품질 상태 및 신뢰도 표시 — freshness, null 비율, 에러 로그 등 품질 정보를 표시한다
• 자동 스키마 수집 및 동기화 — 데이터브릭스에서 주기적으로 스키마를 수집해 최신 상태를 유지한다

이 가이드를 따라 하면 Datahub 에 로그인해 Domains·Explore your data·Platforms 세 가지 방식으로 데이터를 탐색하고, 필요하면 나만의 View 를 만들어 팀원과 공유할 수 있다.

사전 조건

• Google Workspace 계정(회사 이메일) — 별도의 계정 신청 없이 Google SSO 로그인으로 바로 접속 가능하다
• 기본 Role 은 Reader 다. 권한 변경이 필요하면 별도로 요청한다
• 미리디 오피스 내에서만 접속 가능하다. 재택 등 사외에서 접속할 때는 Open VPN 이 정상 연결된 후에만 로그인할 수 있다

수행 방법

로그인

1. Datahub 접속 주소로 이동한다 — (확인 필요) 원문에는 실제 URL 대신 "Share Invite Link" 표시만 있고 링크 값은 텍스트로 확인되지 않는다
2. Google Workspace 계정으로 Google SSO 로그인을 진행한다
3. 최초 로그인 시 기본 Role 은 Reader 로 부여된다

홈 화면 구성

로그인이 완료되면 홈 화면에서 데이터에 접근하는 방식이 다른 3개 섹션을 볼 수 있다.

섹션	언제 쓰는가
Domains	도메인별로 데이터를 찾고 싶을 때
Explore your data	카탈로그 기준으로 자유롭게 데이터를 탐색하고 싶을 때
Platforms	특정 데이터 소스(Databricks, Tableau 등)에서만 탐색하고 싶을 때

Domains 로 탐색하기

• Entities 탭 — 미리디의 Domain 별로 카탈로그·스키마·테이블을 확인한다. type·platform·domain owner 등으로 필터링할 수 있고, Advanced 를 누르면 커스텀 필터링도 가능하다
• Documentation 탭 — 해당 Domain 의 테이블 정보로 생성된 간단한 문서(포함된 테이블 수, Domain 의 특징과 사용 용도, 태그, 주요 테이블 정보 등)를 확인한다. Edit 권한이 있으면 내용을 수정하거나 추가할 수 있다

Explore your data 로 탐색하기

Domains 에서 본 테이블 리스트를 도메인이 아니라 카탈로그 별로 나누어 조회한다. 데이터셋을 클릭하면 data source 별 토글(Databricks 카탈로그, Tableau 대시보드 등)이 나타난다.

카탈로그 별 특징:

• 🥉 Bronze — 원본 데이터를 그대로 수집
• 🥈 Silver — 정제·정규화된 분석 준비 데이터
• 🥇 Gold — 비즈니스에 바로 쓰는 집계·최종 데이터

테이블 하나를 선택하면 Schema · Documentation · Lineage · Queries 4개 탭을 확인할 수 있다.

• Schema 탭 — 컬럼과 컬럼 코멘트를 확인한다. 컬럼별 태그와 글로서리텀 작업은 원문 작성 시점 기준으로 비어 있으며, 추후 채워질 예정이다
• Documentation 탭 — 테이블의 상세 설명, Tableau 대시보드, 주요 쿼리, 연관 테이블, 관련 wiki 문서 등을 확인한다
• Lineage 탭 — 해당 테이블의 Upstream/Downstream 정보를 확인한다. Visualize Lineage 를 클릭하면 시각화된 화면으로 이동한다. 업스트림/다운스트림은 상대적인 개념이다 — 예: A → B → C 흐름에서 B 입장에서는 A 가 업스트림, C 가 다운스트림이고, C 입장에서는 B 가 업스트림이며 A 는 그보다 앞선 조상이다
• Queries 탭 — 데이터브릭스에서 해당 테이블을 사용한 쿼리 내역을 확인한다

Platforms 로 탐색하기

플랫폼(예: Databricks, Tableau) 별로 바로 필터를 걸어 동일한 데이터를 빠르게 조회할 수 있다. 예를 들어 'Tableau' 를 클릭하면 태블로 관련 데이터만 자동으로 필터링된다.

• 태블로는 별도의 문서 페이지가 없다. View in Tableau 를 클릭하면 바로 Tableau server 로 이동하고, 로그인하면 관련 대시보드를 확인할 수 있다
• 태블로 차트를 클릭하면 Schema 탭에서 Field·Description·Tags 가 채워져 있는 경우 확인할 수 있다
• 테이블과 동일하게 Tableau 도 Lineage 탭에서 Visualize Lineage 를 클릭해 해당 대시보드와 연결되는 upstream/downstream 정보를 시각화해서 볼 수 있다

맞춤형 데이터 View 생성하기

View 는 수많은 메타데이터가 쌓인 Datahub 안에서 내 업무 도메인과 관련된 테이블·메타데이터만 모아 검색 범위를 줄여주는 기능이다. 동료에게 공유하면 동료의 검색 시간도 줄일 수 있다.

1. 메인 검색 화면에서 View all 을 선택하면 드롭다운 메뉴에서 기존에 생성된 View 를 선택하거나 새 View 를 만들 수 있다
2. +Create new view 를 선택해 View 생성 화면으로 이동한다
3. View 의 이름과 설명을 입력한다
4. Type 을 선택한다 — 타인과 공유하려면 Public, 나만 보려면 Private
5. Filters 에서 필요한 테이블을 모을 조건을 설정한다 — 예: Container 를 선택하고 settlement 키워드로 검색하는 필터. 여러 개의 Filter 조건을 추가해 조합할 수 있다
6. 생성된 View 를 메인 검색 창에서 선택하면, 도메인·Dataset 등의 목록이 설정한 조건에 맞게 추려져 표시된다

실패 / 예외 / Escalation

• 초기 로그인 후 No role 로 부여된 경우 DP 팀에 문의하면 권한을 수정해준다
• Role 변경(Reader 이외 권한)이 필요하면 별도로 요청한다 — 처리는 DP 팀이 지원한다
• 사외에서 Open VPN 연결 없이는 로그인이 불가능하다

관련 문서

• 문의: 슬랙 채널 #데이터플랫폼_이슈, 또는 @data.dp.oncall 멘션
• Datahub 활용을 위한 추가 가이드가 원문에 링크로 안내되어 있다 — 이번 실행에서는 열지 않았다 (판정 로그의 related_candidates 참고)