DB 연결
DB 연결 화면(사이드바 → 데이터 엔지니어링 → DB 연결)에서는 GenD가 Trino를 통해 Federation 쿼리를 수행할 외부 데이터베이스 연결을 등록, 수정, 삭제할 수 있습니다. 모든 연결 정보는 HashiCorp Vault를 통해 암호화되어 안전하게 관리됩니다.
화면 구성
커넥터 목록
등록된 데이터 소스가 카드 또는 테이블 형태로 표시됩니다. 각 커넥터에는 다음 정보가 포함됩니다.
| 항목 | 설명 |
|---|---|
| 이름 | 커넥터 식별 이름 (예: production-postgres, analytics-mysql) |
| 타입 | 데이터베이스 종류 (PostgreSQL, MySQL 등) |
| 호스트 | 데이터베이스 서버 주소 |
| 연결 상태 | Connected (녹색) / Disconnected (빨간색) 배지 |
| 등록일 | 커넥터가 최초 등록된 날짜 |
연결 상태 배지
상태는 등록 · 수정 · 수동 연결 테스트 시점에 실제 원격 스키마 조회(reachability probe)로 검증되어 갱신됩니다. 주기적 자동 재확인은 없으므로, 배지 아래의 마지막 확인 시각으로 상태의 신선도를 판단하세요. 최신 상태가 필요하면 카드의 ⚡ 연결 테스트를 실행합니다.
- Connected (녹색) — 마지막 확인 시점에 데이터 소스 접근 가능
- Disconnected/Error (빨간색) — 마지막 확인 시점에 연결 실패 (네트워크, 인증, 서버 다운 등)
지원 데이터 소스 타입
GenD는 Trino 커넥터를 통해 다양한 데이터 소스를 지원합니다.
| 타입 | 커넥터 | 주요 용도 |
|---|---|---|
| PostgreSQL | postgresql | OLTP, 메타데이터 저장소 |
| MySQL | mysql | OLTP, 레거시 시스템 연동 |
| MariaDB | mariadb | MySQL 호환 데이터 소스 |
| SQL Server | sqlserver | 엔터프라이즈 OLTP/OLAP |
| Oracle | oracle | 엔터프라이즈 데이터베이스 |
| MongoDB | mongodb | NoSQL 문서 데이터베이스 |
Vault 기반 보안
커넥터의 인증 정보(비밀번호, 인증서 등)는 GenD API 서버에 평문으로 저장되지 않습니다.
- 등록 시 — 사용자가 입력한 인증 정보를 HashiCorp Vault에 암호화 저장
- 조회 시 — 비밀번호 필드는 마스킹(
****)되어 표시 - 사용 시 — Trino가 쿼리 실행 시점에 Vault에서 인증 정보를 동적으로 조회
주요 기능
- 멀티 소스 Federation — 여러 데이터 소스를 단일 SQL로 조인
- 연결 상태 표시 — 실제 원격 스키마 조회 기반 연결 테스트 + 마지막 확인 시각 표시
- Vault 암호화 — 인증 정보를 HashiCorp Vault로 안전하게 관리
- CRUD 관리 — 커넥터의 등록, 수정, 삭제, 테스트 연결 지원
- 카탈로그 자동 등록 — 커넥터 등록 시 Trino 카탈로그에 자동 반영
샘플 데이터 예시
커넥터 목록 화면에 표시되는 데이터 예시입니다.
이름 타입 호스트 상태
──────────────────────────────────────────────────────────────────────
production-postgres PostgreSQL pg-primary.db.svc:5432 Connected
analytics-mysql MySQL mysql-ro.db.svc:3306 Connected
legacy-oracle Oracle oracle.corp.net:1521 Disconnected
mongo-logs MongoDB mongo.db.svc:27017 Connected
AI Agent Chat으로 수행하기
이 페이지의 작업을 AI에게 자연어로 요청할 수 있습니다. 페이지 상단의 AI에게 요청 버튼을 클릭하거나, AI 에이전트 채팅에서 직접 질문하세요.
예시:
- "등록된 데이터 소스 목록 보여줘"
- "PostgreSQL 커넥터 상태 확인해줘"
자세한 내용은 AI Agent Chat 가이드를 참조하세요.