Wrapper

Wrapper는 DADP의 공식 JDBC 연동 경로다. 애플리케이션이 기존 JDBC 경로를 유지하면서도 SQL 실행 경계에서 보호를 적용할 수 있도록 설계되었다.

주요 책임

• JDBC 실행 경로 개입
• Hub 기반 인스턴스 등록과 설정 동기화
• Engine 호출을 통한 런타임 실행
• 애플리케이션 코드 변경 최소화

식별과 매핑

Wrapper 운영에서 가장 중요한 개념은 인스턴스 식별과 스키마 식별을 분리해서 보는 것이다.

• hubId와 alias는 Wrapper 인스턴스 축이다.
• datasourceId는 스키마와 정책 매핑 축이다.

이 두 축을 혼동하면, 인스턴스는 살아 있는데 특정 스키마만 반영이 안 되는 문제를 정확히 해석하기 어렵다.

동기화 모델

Wrapper는 제어면 원본을 직접 소유하지 않는다. 실행에 필요한 메타데이터 사본을 로컬에 유지하면서 Engine을 호출한다.

직접 동기화가 어려운 환경에서는 다음 보조 경로가 운영 대안이 될 수 있다.

• collector 기반 스키마 수집 후 Hub 전송
• CLI 기반 정책 또는 설정 동기화
• export-config 기반 로컬 반영

적합한 사용 상황

• 애플리케이션 팀이 JDBC 설정을 제어할 수 있을 때
• SQL 경로 보호를 애플리케이션 코드 변경 없이 적용하고 싶을 때
• 중앙 정책 관리를 유지하면서 애플리케이션 수정량을 줄이고 싶을 때

운영 해석

Wrapper 문제는 보통 다음 범주로 나뉜다.

• 인스턴스 등록 문제
• 스키마 수집 또는 매핑 문제
• 로컬 스냅샷 갱신 문제
• Engine 실행 호출 문제

같은 Wrapper 오류처럼 보여도, 제어면 문제인지 로컬 메타데이터 문제인지 실행면 문제인지 분리해서 봐야 한다.