공식 OpenSQL 17.8 호환성 및 성능 검증 추가 구현

[Gimini-3]

목적

로컬 PostgreSQL 17 + pgvector 검증과 별도로 Rocky Linux 9.7 Single 구성의 공식 OpenSQL 17.8 환경에서 DocGrid의 Migration, Vector 검색, Worker Claim·Lease와 전체 문서 인덱싱 호환성을 검증한다.

범위

• 공식 검증 전용 Spring Profile과 Gradle Task를 추가한다.
• 접속 정보는 환경 변수로만 주입하고 저장소·로그·결과 문서에 Secret을 남기지 않는다.
• Flyway 전체 Migration과 Hibernate Schema Validation을 검증한다.
• PostgreSQL 17.8과 pgvector 0.8.1, vector(1024) Column과 HNSW Index를 확인한다.
• Vector 저장, vector_dims, <=> Cosine 검색과 HNSW 실행 계획을 검증한다.
• FOR UPDATE SKIP LOCKED 기반 다중 Worker Claim 단일성을 실제 DB에서 검증한다.
• Lease 갱신·만료 복구와 최종 실패·재시도 전이를 실제 DB에서 검증한다.
• MinIO·BGE-M3를 연결한 전체 문서 인덱싱 E2E를 공식 DB 대상으로 재실행한다.
• Claim 처리량과 Vector 검색 p50·p95, Connection Pool 대기와 Lock 경합을 측정한다.
• 실행 환경·절차·실측 결과와 차이를 docs/test-results/에 기록한다.

환경

Rocky Linux 9.7 x86-64
OpenSQL PostgreSQL 17.8
pgvector 0.8.1
Single 구성
발급 라이선스 적용

안전 경계

• 설치 번들, 라이선스, 다운로드 링크·비밀번호는 Git에 추가하지 않는다.
• 운영 DB가 아닌 검증 전용 Database 또는 Schema만 사용한다.
• Test Schema 이름은 환경 변수로 명시하고 종료 시 그 Schema만 제거한다.
• HA, Patroni, etcd, OpenProxy 구성은 범위에서 제외한다.
• 공식 원격 환경이 준비되지 않은 실행은 로컬 PostgreSQL 17.8 기준선으로만 기록하며 공식 판정으로 표시하지 않는다.

완료 조건

• 공식 OpenSQL 17.8에서 전용 호환성 Test가 모두 통과한다.
• Flyway, Hibernate, Vector/HNSW, <=>, SKIP LOCKED, Claim·Lease·Retry가 통과한다.
• 실제 BGE-M3 문서 인덱싱과 검색 E2E가 공식 DB를 사용해 통과한다.
• Claim·Vector 검색 측정값과 실행 계획을 재현 가능한 결과 문서로 남긴다.
• Secret·설치 번들·라이선스가 Git 변경과 로그에 포함되지 않는다.

[kangcheolung]

Branch 124 created!

[Gimini-3]

PR #126에서 공식 OpenSQL 3.17.8.7 배포본의 기능 호환성 검증 도구와 컨테이너 실행 결과를 병합했습니다.

다만 PR 본문과 검증 결과에 기록한 대로 현재 실행은 Apple Silicon 호스트의 linux/amd64 에뮬레이션 컨테이너 경계입니다. 이 이슈의 최종 완료 조건인 공급사 지원 Rocky Linux 9.7 x86-64 VM·물리 서버·원격 서버 인수 검증은 아직 남아 있어 이슈를 다시 엽니다.

남은 완료 조건:

• 공급사 지원 x86-64 호스트에서 scripts/opensql/verify-host.sh 통과
• 같은 환경에서 ./gradlew openSqlVerification 전체 통과
• VM·서버 성능 결과를 컨테이너 결과와 분리해 docs/test-results/에 기록
• 설치 모드·라이선스 적용 여부를 공급사 설치 기록으로 확인

설치 번들, 라이선스와 접속 Secret은 계속 저장소 밖에서 관리합니다.