본문으로 건너뛰기

FAQ

GenD 플랫폼 사용 중 자주 묻는 질문과 답변을 정리합니다.

일반​

GenD는 무엇인가요?​

GenD는 Trino 기반 Federation SQL 위에 구축된 AI-Native Data Intelligence Platform입니다. 여러 데이터 소스(PostgreSQL, Iceberg, S3 등)를 단일 SQL 인터페이스로 조회할 수 있습니다.

Federation SQL이란 무엇인가요?​

서로 다른 카탈로그(예: iceberg.card, sourcedb.public)에 있는 테이블을 하나의 SQL 쿼리에서 JOIN할 수 있는 기능입니다. Trino가 이를 처리합니다.

지원하는 데이터 소스는 무엇인가요?​

PostgreSQL, Iceberg(S3/SeaweedFS), Hive Metastore를 기본 지원하며, DB 연결 화면에서 JDBC 기반 소스를 추가할 수 있습니다.

SQL 에디터​

SQL 에디터에서 자동 완성이 안 됩니다​

Monaco Editor 기반이므로 Ctrl+Space로 자동 완성을 트리거할 수 있습니다. 카탈로그 메타데이터가 로드된 후 테이블/컬럼명이 자동 완성됩니다.

쿼리 실행 결과가 잘립니다​

기본 LIMIT이 적용되지 않으므로, 대량 결과 조회 시 LIMIT 절을 명시하세요. 결과 테이블은 가상 스크롤(@tanstack/react-virtual)로 대량 행도 렌더링됩니다.

AI 기능​

NL2SQL은 어떤 모델을 사용하나요?​

AI Provider 설정에 따라 다릅니다. ai_providers 서비스가 LLM 프록시를 추상화하며, 관리자가 프로바이더를 구성합니다.

RAG 검색은 어떻게 동작하나요?​

스키마 메타데이터를 벡터 임베딩으로 변환 후, 자연어 질의를 벡터 검색하여 관련 테이블/컬럼을 찾고 SQL을 생성합니다.

거버넌스​

PII 마스킹은 자동으로 적용되나요?​

PII 마스킹 정책이 활성화된 경우, 쿼리 결과에서 이름/전화번호/카드번호 등이 자동으로 해시 또는 부분 마스킹됩니다. 사이드바 하단 ⚙ 관리 콘솔 → 접근 제어 & 보안 → PII 관리에서 정책을 관리합니다.

ABAC 정책은 어떻게 설정하나요?​

사이드바 하단 ⚙ 관리 콘솔 → 접근 제어 & 보안 → 접근 정책 메뉴에서 속성 기반 접근 제어(ABAC) 정책을 생성합니다. 사용자 역할, 데이터 분류, 시간 조건 등을 조합할 수 있습니다.

인프라​

로컬 개발 환경은 어떻게 구성하나요?​

Kind 클러스터(gend-local)에서 전체 스택을 운영합니다. make seed-demo로 샘플 데이터를 적재할 수 있습니다. 자세한 내용은 시딩 가이드를 참조하세요.

ARM64(Apple Silicon)를 지원하나요?​

네, 모든 컨테이너 이미지와 Helm 차트가 ARM64 호환으로 구성됩니다.