운영 · X13
데이터 계약, 거버넌스, 보안
"데이터 품질·거버넌스"는 공고 72건(77%)에 나오는, 가장 흔한 요구 중 하나입니다. 여기서는 그중 손에 잡히는 세 가지를 실행했습니다. 테이블 모양을 약속하는 dbt 모델 계약, 개인정보 열 표시, DB 권한입니다.
모델 계약: 열 이름과 타입을 약속
대시보드나 AI 에이전트가 읽는 테이블은 열 이름 하나만 바뀌어도 망가집니다. dbt 계약(contract)을 걸면 약속과 다른 테이블은 아예 만들지 않습니다.
models:
- name: fct_status_summary
description: 상태별 주문 수와 매출. 대시보드와 AI 에이전트가 읽는 공개 테이블.
config:
contract: {enforced: true} # 아래 열 이름·타입과 다르면 빌드 실패
meta: {owner: data-eng, consumers: [bi_dashboard]}
columns:
- name: status_ko
data_type: varchar
constraints: [{type: not_null}]
- name: counts_as_revenue
data_type: boolean
- name: orders
data_type: bigint
- name: gross_amount
data_type: hugeint# 열 이름 orders를 order_cnt로 바꾸고 빌드
This model has an enforced contract that failed.
| column_name | definition_type | contract_type | mismatch_reason |
| ----------- | --------------- | ------------- | --------------------- |
| order_cnt | bigint | | missing in contract |
| orders | | bigint | missing in definition |
# 이름은 그대로 두고 count(*)::double 로 타입만 바꾸면
| orders | double | bigint | data type mismatch |
# 원래대로 되돌리면
Summary: 1 total | 1 success
두 경우 모두 테이블을 만들기 전에 멈췄고, 어떤 열이 어떻게 다른지 표로 알려 줬습니다. 열을 바꿔야 한다면 계약 yml을 같이 고쳐야 하므로, 그 PR을 보는 사람이 "이 테이블을 쓰는 쪽에 알렸나"를 확인할 수 있습니다. meta에는 담당자와 사용처를 적어 두었습니다.
개인정보 열 표시
# models/staging/_staging.yml
- name: stg_customers
columns:
- name: name
config:
meta: {pii: true} # 개인정보 열 표시
어떤 열이 개인정보인지 적어 두면 문서 사이트(D06)와 manifest에 남아, 권한 검토나 마스킹 대상 목록을 만들 때 씁니다. 실제로 가리는 일은 X02처럼 DB의 뷰·권한으로 합니다.
권한은 DB에서
X02에서 확인한 것처럼 분석가는 이름을 가린 뷰만, 부산 담당자는 부산 행만 보게 할 수 있습니다. 접속 정보 관리와 비용은 12장, 계보와 시맨틱 레이어는 13장에서 다뤘습니다.
| 공고에 나오는 말 | 실제로 하는 일 | 이 교안 |
|---|---|---|
| 데이터 품질 관리 | 테스트·모니터링·신선도 | 08, D04~D06, X12 |
| 데이터 표준·카탈로그 | 이름 규칙, 설명, 담당자, 계보를 문서로 | D06, 13 |
| 데이터 계약 | 공개 테이블의 모양을 약속하고 깨지면 멈춤 | 이 장 |
| 접근 제어·개인정보 | 역할별 권한, 마스킹, 행 수준 보안, 삭제 요청 반영 | X02, X06, 12 |
이것만 기억하세요
거버넌스는 문서가 아니라 실행되는 규칙입니다. 공개 테이블에는 계약을, 개인정보 열에는 표시를, 권한은 DB에서 겁니다.