HMM ADB-RDS PostgreSQL DB Link 녹화 절차
- Redmine: #730
- 적용 브랜치:
hmm-backoffice - 실행 위치: Oracle ADB Database Actions SQL Worksheet
- 실행 사용자:
ADMIN - 원격 DB: AWS RDS for PostgreSQL
- 원격 데이터베이스/스키마:
postgres/hmm_demo
1. 목적
ADB SQL Worksheet에서 AWS RDS PostgreSQL을 Database Link로 연결하고, HMM 가상 선사 실적을 Oracle 로컬 View로 노출하는 전 과정을 녹화한다.
녹화 순서는 다음과 같이 고정한다.
- 사전 점검
- PostgreSQL 접속 Credential 생성
- 대상 호스트 ACL 등록과 조회
- Oracle 관리형 PostgreSQL Database Link 생성
- 원격 테이블 직접 조회
- Select AI에서 사용할 로컬 View와 메타데이터 생성
- 행 수와 최신 실적 검증
2. 기준 자료
사내 교육자료를 실행 구문의 1차 기준으로 사용한다.
/Users/joungminko/devkit/fy26_ai/fy26_ai_internal_training/2회차/proxy_database/README.md- PostgreSQL 절차:
3.2 PostgreSQL Database 연결 - 검증된 주의사항:
gateway_params의db_type은 소문자postgresport는 문자열이 아닌 숫자5432- PostgreSQL 스키마, 테이블, 컬럼 이름은 큰따옴표로 감싼다.
- Select AI에는 원격 테이블을 직접 등록하지 않고 메타데이터를 부여한 Oracle View를 등록한다.
3. 연결값과 객체명
| 항목 | 값 |
|---|---|
| RDS host | database-1.czaaygccsncp.ap-northeast-2.rds.amazonaws.com |
| RDS port | 5432 |
| PostgreSQL database | postgres |
| PostgreSQL user | postgres |
| ADB Credential | HMM_RDS_PG_CRED |
| ADB Database Link | HMM_RDS_PG_LINK |
| 원격 schema | hmm_demo |
| 로컬 carrier View | HMM_RDS_CARRIERS_V |
| 로컬 월간 실적 View | HMM_RDS_CARRIER_PERF_V |
| 로컬 최신 실적 View | HMM_RDS_CARRIER_LATEST_V |
비밀번호는 SQL 파일에 저장하지 않는다. 녹화 직전 Worksheet에 붙여 넣은 Credential
구문의 <RDS_PASSWORD>만 실제 값으로 바꾸고, 비밀번호가 보이는 화면은 녹화에서
가리거나 일시 정지한다.
운영 전환 시에는 PostgreSQL master 사용자 대신 hmm_federation_reader만 상속한 전용
LOGIN 사용자를 만들어 Credential을 교체한다.
4. ACL의 역할
사내 교육자료의 Oracle 관리형 heterogeneous Database Link 절차에는
DBMS_NETWORK_ACL_ADMIN 호출이 포함되지 않는다. DB Link 연결은
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK의 관리형 gateway가 수행한다.
이번 데모의 ACL 스크립트는 요청한 네트워크 통제 절차를 명시적으로 보여주고, ADMIN에게
RDS host의 이름 해석과 5432 포트 연결 권한이 등록되었음을 DBA_HOST_ACES로 확인하기
위한 단계다. 이 ACL을 AWS RDS Security Group 허용이나 관리형 gateway의 출발 IP 허용과
동일한 것으로 설명하지 않는다.
resolveACE: 포트 범위를 지정하지 않는다.connectACE:5432만 지정한다.- AWS 측에서는 RDS가 public access 가능해야 하고, Security Group이 Oracle 관리형 gateway에서 오는 접속을 허용해야 한다.
- 로컬
global-bundle.pem은psql검증용이다. 관리형 DB Link 생성 구문에 업로드하거나directory_name으로 지정하지 않는다.
5. View 설계
5.1 HMM_RDS_CARRIERS_V
hmm_demo.carriers의 Select AI용 기준정보 View다. PostgreSQL boolean과
timestamptz 컬럼은 이번 분석 범위에서 제외해 이기종 타입 변환 변수를 줄인다.
5.2 HMM_RDS_CARRIER_PERF_V
hmm_demo.carrier_monthly_performance의 18개월 KPI 144행을 제공한다. 복합 Primary Key는
CARRIER_CODE + PERFORMANCE_MONTH이며 CARRIER_CODE는 carrier View를 참조한다는 관계를
View comment에 기록한다.
5.3 HMM_RDS_CARRIER_LATEST_V
원격 hmm_demo.carrier_performance_latest_v를 노출해 2026-07 최신월 선사 8건을 제공한다.
각 View는 원격 소문자 컬럼을 Oracle의 일반 대문자 식별자로 명시적으로 alias한다. 따라서 후속 SQL과 Select AI metadata에서는 큰따옴표 없이 안정적으로 사용할 수 있다.
6. 녹화용 실행 파일
| 순서 | 파일 | 화면에서 확인할 결과 |
|---|---|---|
| 0 | 73_hmm_rds_pg_00_precheck.sql |
현재 사용자 ADMIN, 기존 객체 유무 |
| 1 | 74_hmm_rds_pg_01_credential.sql |
Credential 1건, 사용자명 postgres |
| 2 | 75_hmm_rds_pg_02_acl.sql |
resolve, connect:5432 ACE |
| 3 | 76_hmm_rds_pg_03_dblink.sql |
HMM_RDS_PG_LINK 1건 |
| 4 | 77_hmm_rds_pg_04_remote_query.sql |
선사 8건, 월간 실적 144건 |
| 5 | 78_hmm_rds_pg_05_views.sql |
Oracle 로컬 View 3개 |
| 6 | 79_hmm_rds_pg_06_verify.sql |
8 / 144 / 8, 위험도 3종 |
| 재촬영 전 | 80_hmm_rds_pg_99_cleanup.sql |
View, DB Link, Credential만 제거 |
7. 성공 기준
ALL_CREDENTIALS에서HMM_RDS_PG_CRED가 조회된다.DBA_HOST_ACES에서 RDS host의resolve,connect가 조회된다.USER_DB_LINKS에서HMM_RDS_PG_LINK가 조회된다.- 원격 직접 조회가 선사 8건과 실적 144건을 반환한다.
- 로컬 View 3개가
VALID상태다. - 최신 View가 8건을 반환하고
GREEN,AMBER,RED가 모두 존재한다. - Credential password가 SQL 파일, Git diff, 화면 출력에 남지 않는다.
8. 실패 시 판별
| 증상 | 우선 확인 |
|---|---|
ORA-01031 |
ADMIN으로 실행했는지 확인 |
| Credential already exists | 재촬영 전 cleanup 실행 여부 확인 |
| Database link already exists | 재촬영 전 cleanup 실행 여부 확인 |
ORA-28500, ORA-02063, timeout |
RDS 상태, public access, Security Group, endpoint/port 확인 |
| relation does not exist | "hmm_demo"."..." 큰따옴표와 객체명 확인 |
| 인증 실패 | Credential의 PostgreSQL 사용자/비밀번호 확인 |
| View comment 대상 오류 | 로컬 View/컬럼은 큰따옴표 없는 대문자 식별자 사용 |
9. 제외 범위
- 이번 단계에서는 ADB 직원과 선사의 담당 배정 테이블 및 VPD 정책을 만들지 않는다.
- Select AI profile과 MCP tool 등록은 로컬 View 검증 후 후속 단계에서 수행한다.
- 실제 실행은 녹화를 진행하는 사용자가 SQL Worksheet에서 수행한다.