Arbiter

DB 스키마 품질 점검 CLI 도구

공공 SI 감리 현장의 폐쇄망 환경에서 단일 바이너리로 동작하는 DB 스키마·데이터 품질 점검 도구입니다.

특징

• 단일 바이너리 — 설치 불필요, 다운로드 후 바로 실행
• 폐쇄망 대응 — 외부 네트워크 불필요 (DDL 파일 스캔 모드)
• 49개 내장 룰 — 네이밍, 제약조건, 인덱스, 데이터타입, 공공SI, 행안부 표준, 데이터 품질
• 3개 DB 지원 — Oracle, PostgreSQL, MySQL
• 다양한 출력 — JSON, HTML (인라인 CSS), XLSX
• 감리 추적 — 1차/2차 감리 결과 비교 (diff)

다운로드

Releases 페이지에서 OS에 맞는 바이너리를 다운로드하세요.

OS	파일명	아키텍처
Linux	arbiter-linux-amd64	x86_64
macOS (Apple Silicon)	arbiter-darwin-arm64	ARM64
macOS (Intel)	arbiter-darwin-amd64	x86_64
Windows	arbiter-windows-amd64.exe	x86_64

# Linux/macOS 실행 권한 부여
chmod +x arbiter-linux-amd64
./arbiter-linux-amd64 --help

빠른 시작

DDL 파일 스캔 (폐쇄망 기본 모드)

# Oracle DDL 파일 스캔 → XLSX 보고서
arbiter scan -i ./schema.sql -d oracle -f xlsx -o report.xlsx

# 전체 룰 적용
arbiter scan -i ./schema.sql -d oracle -r default

# 공공SI 룰만 적용
arbiter scan -i ./schema.sql -d oracle -r public-sector

# 카테고리 선택 (콤마 구분)
arbiter scan -i ./schema.sql -d oracle -r NAM,CON,IDX,TYP

DB 직접 연결 (데이터 품질 점검 포함)

# Oracle 연결 — 전체 점검
arbiter connect --driver oracle \
  --dsn "oracle://user:pass@host:1521/sid" \
  -f xlsx -o report.xlsx

# 데이터 품질 룰만
arbiter connect --driver oracle \
  --dsn "oracle://user:pass@host:1521/sid" \
  -r DQ

# 참조 무결성 + 데이터 품질
arbiter connect --driver postgres \
  --dsn "host=192.168.1.1 port=5432 dbname=mydb user=dba password=xxx" \
  -r RI,BR,DQ

감리 결과 비교

# 1차 감리 결과와 2차 감리 결과 비교
arbiter diff --before report-1st.json --after report-2nd.json -o diff.xlsx

룰 목록 조회

arbiter rules list
arbiter rules list --category dq
arbiter rules list --severity critical

내장 룰 카테고리

카테고리	코드	룰 수	설명
Naming	NAM	9	테이블·컬럼·제약조건 네이밍 규칙
Constraint	CON	5	PK·FK·NOT NULL·CHECK 제약
Index	IDX	4	인덱스 품질·중복·누락
Data Type	TYP	4	데이터타입 적절성
Public Sector	PUB	6	공공SI 특화 (개인정보, 감사컬럼)
Standard	STD	3	행안부 공통표준 점검
Domain	DOM	2	도메인 정합성 점검
Referential	RI	2	참조 무결성 (DB 연결 필요)
Business Rule	BR	3	비즈니스 룰 점검 (DB 연결 필요)
Data Quality	DQ	12	데이터 품질 심화 (DB 연결 필요)

출력 형식

• JSON — CI/CD 파이프라인 연동, 프로그래밍 처리
• XLSX — 감리 보고서 제출용 (요약·위반목록·테이블별·규칙설명 4개 시트)
• HTML — 단일 파일, 인라인 CSS (폐쇄망 브라우저에서 바로 열기)

라이선스

이 소프트웨어의 바이너리는 자유롭게 사용할 수 있습니다.