Skip to content

Latest commit

 

History

History
107 lines (79 loc) · 6.09 KB

README.md

File metadata and controls

107 lines (79 loc) · 6.09 KB

LionSQL 스크립트 도구 가이드 (Scripts Directory)

LionSQL의 테스트, 데이터 시딩, 자동화 검증을 위한 보조 스크립트 도구 모음입니다.


1. 확장 통합 스모크 테스트 (scripts/verify_report.sh)

notes/TEST_VERIFICATION_REPORT.ko.md에 기술된 13대 핵심 아키텍처 및 무결성 도메인을 단일 스크립트로 신속하게 일괄 검증하는 확장 스모크 테스트 도구입니다.

1.1 기본 전제 조건

bin/ 디렉터리에 핵심 바이너리가 컴파일되어 있어야 합니다:

go build -tags wiredtiger -buildvcs=false -o bin/lionsql ./cmd/lionsql
go build -tags wiredtiger -buildvcs=false -o bin/tpcc-runtime ./cmd/tpcc_runtime

1.2 실행 방법

# 1. 기본 실행 (In-Memory OCC 초고속 검증, 약 3초 소요)
./scripts/verify_report.sh

# 2. WiredTiger 영속 B+Tree 엔진 기반 전체 검증
./scripts/verify_report.sh --engine=wiredtiger

# 3. 상세 디버깅 로깅 모드
./scripts/verify_report.sh -v

# 4. 도움말 확인
./scripts/verify_report.sh --help

1.3 자동 검증 13대 도메인

Phase 검증 도메인 주요 점검 내용
Phase 1 TDS 7.3 핸드셰이크 & 라이프사이클 DDL/DML, T-SQL 저장 프로시저 컴파일/실행, 원자적 롤백
Phase 2 복합 엔터프라이즈 T-SQL 쿼리 3-Way JOIN, 윈도우 함수(ROW_NUMBER), CTE, OFFSET...FETCH 페이징
Phase 3 고동시성 TPC-C VDBE 스트레스 4개 워커 고동시성 New-Order/Payment 트랜잭션 1초 연속 부하 (13,000+ TPS)
Phase 4 TDS 프로토콜 극한 경계 25KB 초과 PLP 대용량 청크 스트리밍 및 SHA-256 무손실 일치
Phase 5 이종 프로토콜 트라이브릿지 PGWire, TDS, HTTP REST 인터페이스 간의 실시간 스토리지 카탈로그 일치
Phase 6 ACID 크래시 복구성 kill -9 (SIGKILL) 돌발 사살 후 콜드 재기동 시 50건 100% 무손실 복구
Phase 7 Always On HA 복제 및 페일오버 복제 카탈로그 일치 및 Replica 노드 읽기 전용 가드레일
Phase 8 디커플드 HTAP 분석 파이프라인 CDC 트랜잭션 이벤트 스트림 기반 벡터 집계 쿼리
Phase 9 CBO 비용 모델 및 커버링 인덱스 EXPLAIN 기반 Index-Only Scan 선택 및 테이블 힙 조회 0건 입증
Phase 10 반정형 JSON B-Tree 인덱스 ((doc->>'city')) 함수형 인덱스 탐색 및 쿼리 플랜 가속 매칭
Phase 11 세분화된 SQL RBAC 보안 거버넌스 SETUSER Default Deny 원칙 및 비인가 테이블 접근 100% 차단
Phase 12 선언적 스키마 마이그레이션 CLI lionsql migrate new -> status (Pending) -> up (Applied) -> down (Pending)
Phase 13 롤링 테이블 파티셔닝 toYYYYMM 자동 파티셔닝, EXPLAIN 파티션 프루닝, DROP PARTITION O(1) 파기

2. 데모 시드 데이터 (scripts/demo_seed.sql)

LionSQL 초기 기동 후 실습용 전자상거래/ERP 예제 데이터베이스(고객, 상품, 주문, 재고, 계좌 등)를 적재하기 위한 SQL 시드 스크립트입니다:

./bin/lionsql sql "source scripts/demo_seed.sql;"
# 또는 서버 기동 시 -seed 플래그 사용:
./bin/lionsql serve -seed

3. 원클릭 릴리스 자동화 파이프라인 (scripts/release.sh)

버전 SSOT 동기화, 커밋 로그 수집, Keep a Changelog 분류, 크로스 컴파일(Unix 및 Windows .exe), Git Tag 생성 및 GitHub 원격 푸시를 한 번에 원자적으로 수행하는 릴리스 도구입니다.

상세한 아키텍처 및 동작 원리는 **doc/RELEASE_AUTOMATION_GUIDE.ko.md**를 참조하십시오.

# 1. 릴리스 미리보기 (Dry-Run)
./scripts/release.sh v0.90.0-beta4 --dry-run

# 2. 정식 릴리스 수행 (빌드 -> CHANGELOG/버전 갱신 -> 커밋 -> 태깅 -> GitHub 푸시)
./scripts/release.sh v0.90.0-beta4

4. 원클릭 통합 벤치마크 및 검증 스위트 (scripts/run_all_benchmarks.sh)

doc/BENCHMARK.md에 기술된 7대 핵심 성능 및 정합성/내구성 벤치마크를 단일 명령으로 일괄 측정하고 터미널 및 마크다운 리포트로 자동 생성하는 올인원 스위트입니다.

4.1 주요 기능

  1. 바이너리 자동 빌드: lionsql, bench, tpcc-kernel, tpcc-runtime, tpcc-client, sqllogictest 전수 일괄 컴파일 (--skip-build로 스킵 가능).
  2. Phase 1 (ACID 송금 저장 프로시저): cmd/bench 기반 자산 보존 법칙 검증 및 P50/P95/P99 지연 시간 측정.
  3. Phase 2 (스토리지 커널 TPC-C): cmd/tpcc_kernel 기반 스토리지 계층 SPI CRUD 극한 처리량 측정.
  4. Phase 3 (VDBE 런타임 TPC-C): cmd/tpcc_runtime 기반 T-SQL 저장 프로시저 바이트코드 가상머신 종합 처리량 측정.
  5. Phase 4 (클라이언트-서버 네트워크 TPC-C): 백그라운드 서버 구동 후 PGWire(:5433) 및 TDS(:1433) 실측 처리량 측정 및 프로세스 무잔여 사살.
  6. Phase 5 (SQLLogicTest 코어 호환성): cmd/sqllogictest 기반 32개 코어 SLT 파일(조인, 집계, CTE, 윈도우 함수 등) 전수 검증.
  7. Phase 6 (크래시 내구성 & 콜드 리스타트): 돌발 kill -9 사살 후 콜드 재기동 시 데이터 무손실 검증.
  8. Phase 7 (종합 매트릭스 & 리포트 저장): 시스템 메타데이터 캡처 및 터미널 요약표/마크다운 파일(notes/benchmark_runs/) 저장.

4.2 실행 방법

# 1. 일상 개발용 고속 측정 (기본값, 약 30~60초)
./scripts/run_all_benchmarks.sh

# 2. 공식 릴리스용 10~15초 정밀 측정 + 마크다운 리포트 저장
./scripts/run_all_benchmarks.sh --full --save-report

# 3. 스토리지 엔진 상호 비교 (In-Memory OCC vs WiredTiger)
./scripts/run_all_benchmarks.sh --engine=all

# 4. 워크로드 간 쿨다운 갭 지정 (소켓 드레인 및 CPU 써멀 회복, 기본값: 5초)
./scripts/run_all_benchmarks.sh --engine=all --cooldown=5