GenD 10분 퀵스타트
이 가이드를 따라하면 10분 안에 GenD의 핵심 기능을 체험합니다.
사전 준비
- GenD 클러스터 접속 URL (기본:
http://localhost:3000) - 관리자 계정 (
admin/admin)
Step 1: 로그인 (1분)
브라우저에서 GenD URL에 접속하면 Keycloak SSO 로그인 화면이 나타납니다.
- Username or email에
admin입력 - Password에
admin입력 - Sign In 클릭
로그인에 성공하면 GenD 홈 화면으로 이동합니다.
Step 2: 홈 대시보드 확인 (1분)
홈 화면에서 플랫폼 상태를 확인합니다.
- SQL Editor — 쿼리 에디터로 바로 이동
- Catalog Explorer — 데이터 카탈로그 탐색
- Cluster Status — Trino, PostgreSQL 연결 상태 (녹색 = Connected)
- Recent — 최근 실행한 쿼리 목록
하단 상태바에서 Trino: Connected, PostgreSQL: Connected를 확인합니다.
Step 3: 카탈로그 탐색 (2분)
좌측 사이드바에서 Catalog을 클릭합니다.
GenD에 등록된 데이터 소스가 트리 구조로 표시됩니다.
현재 등록된 카탈로그
| 카탈로그 | 설명 |
|---|---|
| iceberg | Iceberg 데이터 레이크 (SeaweedFS S3) |
| nessie | Nessie 카탈로그 (Git-like 버전 관리) |
| sourcedb | PostgreSQL 소스 데이터베이스 |
| system | Trino 시스템 메타데이터 |
| tpcds | TPC-DS 벤치마크 (빌트인) |
| tpch | TPC-H 벤치마크 (빌트인) |
테이블 상세 보기
tpch > tiny > customer를 클릭하면 컬럼 목록과 데이터 타입을 확인할 수 있습니다.
- Columns 탭: 컬럼명, 데이터 타입, Nullable 여부
- Sample Data 탭: 미리보기 데이터 (SELECT * LIMIT 10)
- About this table: 카탈로그, 스키마, 컬럼 수 요약
- Open in SQL Editor: 클릭하면 해당 테이블을 SQL 에디터에서 바로 조회
Step 4: 첫 번째 쿼리 실행 (3분)
좌측 사이드바에서 SQL Editor를 클릭합니다.
에디터에 다음 쿼리를 입력합니다:
SELECT c.name, c.mktsegment, o.orderstatus, COUNT(*) AS order_count
FROM tpch.tiny.customer c
JOIN tpch.tiny.orders o ON c.custkey = o.custkey
GROUP BY c.name, c.mktsegment, o.orderstatus
ORDER BY order_count DESC
LIMIT 10
Run all 버튼을 클릭합니다 (또는 Ctrl+Enter).
결과:
- 10 rows 반환, 약 1.5초 소요
customer테이블과orders테이블을 JOIN하여 고객별 주문 현황을 분석- 컬럼 헤더에 데이터 타입이 함께 표시됩니다 (varchar, bigint 등)
이것이 Trino SQL입니다! 같은 방식으로 서로 다른 카탈로그(PostgreSQL + Iceberg + MySQL)의 테이블도 하나의 SQL로 조인할 수 있습니다.
Step 5: 주요 메뉴 둘러보기 (3분)
GenD의 사이드바 메뉴를 둘러봅니다:
| 섹션 | 메뉴 | 설명 |
|---|---|---|
| SQL | SQL Editor | Monaco 기반 SQL 에디터 + 자동완성 |
| Data Engineering | Data Sources | PostgreSQL, MySQL 등 커넥터 관리 |
| Data Ingestion | PDF, DOCX, CSV 파일 업로드 → 벡터 저장 | |
| Pipelines | Dagster 파이프라인 관리 | |
| AI Intelligence | Schema Graph | 테이블 관계 그래프 시각화 |
| Documents | RAG 문서 관리 | |
| Glossary | 비즈니스 용어집 | |
| Governance | Data Quality | 4축 DQ 스코어링 |
| Admin | PII Management | 개인정보 탐지 + 마스킹 |
| Access Policies | RBAC/ABAC 접근 제어 | |
| Compliance | 규제 준수 현황 |
다음 단계
축하합니다! GenD의 기본 사용법을 익혔습니다.
더 깊이 학습하려면:
- Federation SQL 튜토리얼 — 4개 카탈로그 크로스 조인
- AI Text-to-SQL 튜토리얼 — 자연어로 SQL 생성
- 데이터 거버넌스 튜토리얼 — PII 마스킹 + 접근 제어
- 샘플 데이터 가이드 — 대한카드 시나리오 데이터 시딩