DB UDF Installation¶

DB UDF 설치는 애플리케이션 연동이 아니라 데이터베이스 SQL 실행 경로에 DADP를 연결하는 작업이다. 따라서 설치 검증도 SQL 오브젝트 생성 여부와 Engine 연결 여부를 함께 확인해야 한다.

설치 전 준비¶

대상 DB 접속 정보
Engine URL
DBA 권한 또는 ACL 반영 권한
UDF를 소유할 DB 계정

설치 방식¶

공개 문서 기준에서 DB UDF 설치는 두 가지 흐름으로 본다.

Track A: 스크립트 생성 후 수동 반영¶

운영팀 또는 DBA가 검토 가능한 SQL 산출물을 만든 뒤 수동 반영하는 방식이다.

dadp udf generate \
  --db-type oracle \
  --db-user DADPUSER \
  --engine-url http://10.0.1.50:9003 \
  --output-dir ./dadp-udf-scripts

이 방식은 변경관리와 검토 절차가 엄격한 환경에 적합하다.

Track B: CLI 직접 설치¶

CLI가 대상 DB에 직접 연결해 필요한 오브젝트를 설치하는 방식이다.

dadp udf install \
  --db-type oracle \
  --db-host 10.0.1.100 \
  --db-service XEPDB1 \
  --db-user DADPUSER \
  --db-password mypassword \
  --db-dba-user SYSTEM \
  --db-dba-password dbapassword \
  --engine-url http://10.0.1.50:9003

설치 후 검증¶

dadp udf verify \
  --db-type oracle \
  --db-host 10.0.1.100 \
  --db-service XEPDB1 \
  --db-user DADPUSER \
  --db-password mypassword

검증 단계에서는 일반적으로 다음을 확인한다.

설치된 버전 조회
health check 함수 호출
단건 round trip
배치 경로가 있는 경우 배치 검증

설치 완료 기준¶

UDF 관련 SQL 오브젝트가 정상 생성된다.
DB에서 Engine으로의 호출이 성립한다.
verify가 통과한다.
기본 암복호화 round trip이 성공한다.

운영상 주의점¶

DB ACL 또는 외부 네트워크 정책이 누락되면 설치보다 검증 단계에서 더 자주 실패한다.
DB UDF는 Engine URL 정합성에 직접 의존하므로, 런타임 URL 변경 절차를 따로 관리해야 한다.
생성형 설치와 직접 설치는 변경관리 책임이 다르므로 한 환경에서 기준 방식을 먼저 정해야 한다.