카탈로그 탐색

GenD 카탈로그 탐색기를 사용하여 데이터 소스의 구조를 파악하는 방법을 안내합니다.

사전 준비

• GenD에 로그인되어 있어야 합니다
• 샘플 데이터가 적재되어 있어야 합니다 (make seed-demo)

1단계: 카탈로그 페이지 열기

좌측 사이드바에서 카탈로그 메뉴를 클릭합니다. 트리 뷰에 연결된 카탈로그 목록이 표시됩니다.

2단계: 카탈로그 구조 탐색

트리를 펼쳐 계층 구조를 확인합니다:

iceberg                    ← 카탈로그
  └─ card                  ← 스키마
      ├─ transactions      ← 테이블
      ├─ fraud_labels
      ├─ merchants
      └─ products
sourcedb
  └─ public
      ├─ customers
      ├─ accounts
      └─ credit_assessments

3단계: 테이블 상세 조회

테이블 이름을 클릭하면 컬럼 목록이 표시됩니다:

• 컬럼명: 필드 이름
• 데이터 타입: varchar, integer, timestamp 등
• 설명: 컬럼 코멘트 (설정된 경우)

4단계: SQL 에디터로 이동

탐색 중 조회하고 싶은 테이블을 발견하면, 테이블명을 더블클릭하거나 SQL 에디터 탭으로 전환하여 쿼리를 작성합니다.

-- 예: merchants 테이블 샘플 조회
SELECT * FROM iceberg.card.merchants LIMIT 10;

5단계: Federation JOIN 확인

서로 다른 카탈로그의 테이블을 JOIN할 수 있는지 확인합니다. iceberg.card.transactions와 sourcedb.public.customers는 customer_id로 연결됩니다.

SELECT c.name, t.amount, t.txn_datetime
FROM iceberg.card.transactions t
JOIN sourcedb.public.customers c ON t.customer_id = c.customer_id
LIMIT 5;

---

AI Agent Chat으로 수행하기

위의 모든 단계를 AI Agent Chat에서 자연어로 수행할 수 있습니다. 각 페이지 상단의 AI에게 요청 버튼을 클릭하면 현재 화면을 유지하면서 우측에 AI 채팅 패널이 열립니다.

대화 예시

사용자: "사용 가능한 카탈로그 목록 보여줘"
AI: [list_catalogs 호출] → iceberg, nessie, sourcedb, tpch, tpcds 5개 카탈로그가 등록되어 있습니다.

사용자: "tpch 카탈로그의 테이블 목록 알려줘"
AI: [list_tables 호출] → tiny 스키마에 customer, lineitem, nation, orders, part, partsupp, region, supplier 8개 테이블이 있습니다.

사용자: "customer 테이블의 컬럼 구조 알려줘"
AI: [get_table_columns 호출] → custkey(bigint), name(varchar), address(varchar), nationkey(bigint), phone(varchar), acctbal(double), mktsegment(varchar), comment(varchar) 8개 컬럼입니다.

팁

AI Agent Chat은 44개 플랫폼 도구를 활용하여 데이터 탐색, SQL 생성, 거버넌스 조회 등을 자동으로 수행합니다. 자세한 내용은 AI Agent Chat 가이드를 참조하세요.

다음 단계

• AI Text-to-SQL로 자연어 쿼리 변환 시도
• 분석 쿼리 예제 실행