Genie Spaces 연동

​

개요

• 비즈니스 데이터 탐색 (매출, 재고, 고객 분석)
• 셀프 서비스 분석 (비기술 사용자가 직접 데이터 조회)
• KPI/메트릭 확인 (일별/월별 성과 지표)
• 임원 대시보드 대체 (자연어로 원하는 데이터를 즉시 조회)

​

작동 원리

사용자 질문 (자연어)
    ↓
Genie 파싱 & 관련 데이터 소스 식별
    ↓
Unity Catalog 메타데이터 + Knowledge Store 컨텍스트 필터링
    ↓
읽기 전용 SQL 쿼리 생성
    ↓
SQL Warehouse에서 실행
    ↓
결과 반환 (테이블/차트)

• Unity Catalog 테이블/컬럼 메타데이터
• Knowledge Store (작성자가 큐레이션한 공간 수준 컨텍스트)
• 예시 SQL 쿼리 및 SQL 함수
• 텍스트 지시사항 및 대화 이력

참고 Genie는 읽기 전용 SQL만 생성 합니다. INSERT, UPDATE, DELETE 등의 쓰기 쿼리는 절대 실행되지 않으므로 데이터 안전성이 보장됩니다.

​

사전 요구사항

• Databricks SQL 워크스페이스 자격
• SQL Warehouse에 대한 CAN USE 접근
• 데이터 객체에 대한 SELECT 권한

​

생성 및 설정

​

Step 1: Genie Space 생성

1. 좌측 메뉴에서 Genie> New 클릭
2. Unity Catalog에서 데이터 소스 (테이블/뷰) 선택
3. Create 클릭

​

Step 2: Knowledge Store 설정

​

Step 3: Instructions & Examples 추가 (최대 100개)

• 정적 또는 파라미터화된 SQL 쿼리 (자연어 제목 포함)
• Unity Catalog 함수 (복잡한 로직용)
• 텍스트 지시사항 (비즈니스 컨텍스트, 형식 규칙)

참고 예시 등록 팁: “이번 달 매출은?”이라는 질문에 대해 정확한 SQL을 등록해두면, 유사한 질문(“이번 달 수익은?”, “이달 매출 합계는?”)에도 올바른 SQL이 생성됩니다.

​

Step 4: 공간 설정

• 제목, 설명 (마크다운 지원)
• 기본 SQL Warehouse 설정
• 사용자 안내용 샘플 질문 등록
• 태그 분류

​

모니터링 및 개선

• 사용자가 질문한 모든 내용
• 사용자 피드백 (좋아요/싫어요)
• 플래그된 응답

​

Agent Bricks에서의 활용: Supervisor 서브 에이전트로 사용

​

전체 연결 흐름

1. Genie Space 생성 및 Knowledge Store 설정 완료
    ↓
2. Supervisor Agent 생성 화면에서 "Add Sub-Agent" 클릭
    ↓
3. 에이전트 유형으로 "Genie Space" 선택
    ↓
4. 연결할 Genie Space 선택
    ↓
5. Description 작성 (Supervisor가 언제 이 에이전트에 라우팅할지 판단하는 기준)
    ↓
6. 저장 후 테스트 — Supervisor에 데이터 관련 질문을 하면 Genie로 라우팅됨

​

SQL 분석 에이전트로서의 활용 예시

[Supervisor Agent]
├── [KA: HR 정책 문서] — "연차 정책 알려줘" → 문서 기반 답변
└── [Genie: HR 데이터] — "우리 팀 인원 현황" → SQL 실행 후 테이블 반환

• KA: “회사 HR 정책, 복리후생, 규정 관련 질문을 처리합니다”
• Genie: “직원 수, 부서별 인원, 입퇴사 현황 등 HR 데이터를 조회합니다”

​

제한사항과 해결 방법

주의 Genie Space를 Supervisor에 연결하려면 해당 Space의 소유자이거나 CAN MANAGE 권한이 있어야 합니다. 또한 Supervisor의 서비스 프린시펄에게 Genie Space와 관련 테이블에 대한 접근 권한을 부여해야 합니다.

​

SQL 생성 메커니즘 심층 분석

​

SQL 생성 파이프라인 상세

사용자 질문: "지난달 VIP 고객의 평균 주문 금액은?"
    ↓
[1단계: Intent Classification]
    - 질문 유형 분류: 데이터 조회 / 메타데이터 질문 / 대화형 질문
    - "지난달 VIP 고객의 평균 주문 금액" → 데이터 조회로 분류
    ↓
[2단계: Entity Resolution]
    - "VIP 고객" → customers 테이블의 tier = 'VIP' 매핑
    - "주문 금액" → orders 테이블의 order_amount 컬럼 매핑
    - "지난달" → DATE_TRUNC('month', CURRENT_DATE) - INTERVAL 1 MONTH 변환
    - Knowledge Store의 컬럼 설명, 동의어, 비즈니스 용어를 참조
    ↓
[3단계: Schema Selection]
    - 관련 테이블 식별: orders, customers
    - JOIN 관계 확인: orders.customer_id = customers.id
    - 필요한 컬럼 선택: order_amount, tier, order_date
    ↓
[4단계: SQL Generation]
    - Instructions의 SQL 표현식, 예시 쿼리를 참고
    - 읽기 전용 SQL 생성 (SELECT만 허용)
    - 생성된 SQL:
      SELECT AVG(o.order_amount) AS avg_order_amount
      FROM sales.orders o
      JOIN sales.customers c ON o.customer_id = c.id
      WHERE c.tier = 'VIP'
        AND o.order_date >= DATE_TRUNC('month', CURRENT_DATE) - INTERVAL 1 MONTH
        AND o.order_date < DATE_TRUNC('month', CURRENT_DATE)
    ↓
[5단계: SQL Validation]
    - 문법 검증 (Syntax Check)
    - 테이블/컬럼 존재 여부 확인
    - 읽기 전용 여부 확인 (DML 차단)
    ↓
[6단계: Execution & Response]
    - SQL Warehouse에서 실행
    - 결과를 자연어 + 테이블/차트로 포맷팅
    - 실행된 SQL 쿼리도 함께 표시

​

SQL 생성 정확도에 영향을 미치는 요소

​

Genie Space와 Genie Code의 관계

참고 사용 시나리오 구분: 비기술 사용자가 반복적으로 같은 데이터를 조회한다면 Genie Space, 분석가가 탐색적으로 다양한 데이터를 조회한다면 Genie Code 가 적합합니다. 두 기능은 경쟁 관계가 아닌 보완 관계 입니다.

​

데이터 보안: 사용자 권한 기반 SQL 실행

​

권한 실행 모델

[사용자 A: 영업팀 — 자기 리전 데이터만 접근 가능]
    ↓ "이번 달 매출은?"
    ↓ SQL 실행 → SELECT ... WHERE region = '서울' (사용자 A의 UC 권한에 의해 필터)
    ↓ 결과: 서울 리전 매출만 반환

[사용자 B: 재무팀 — 전체 데이터 접근 가능]
    ↓ "이번 달 매출은?"
    ↓ SQL 실행 → SELECT ... (전체 데이터 조회 가능)
    ↓ 결과: 전 리전 매출 반환

​

보안 레이어 구조

주의 Supervisor Agent를 통한 접근 시: Supervisor Agent에서 Genie Space를 서브 에이전트로 사용할 때에도 On-Behalf-Of-User 모드가 적용됩니다. 즉, Supervisor에 질문한 사용자의 권한으로 Genie의 SQL이 실행되므로, 권한 없는 데이터에는 접근할 수 없습니다.

​

보안 설계 시 고려사항

1. 테이블 권한은 UC에서 관리: Genie Space에서 별도 보안 설정을 하는 것이 아니라, UC의 GRANT/REVOKE로 관리
2. Dynamic View 활용: 부서별/리전별로 다른 데이터를 보여줘야 한다면, 행 수준 보안이 적용된 Dynamic View를 생성하여 Genie Space에 등록
3. 민감 컬럼 마스킹: 고객 개인정보(이름, 전화번호 등)는 Column Mask를 적용하여 권한 없는 사용자에게 마스킹

​

멀티테이블 분석 시 성능 고려사항

​

JOIN 복잡도에 따른 정확도 변화

​

성능 최적화 전략

​

대용량 데이터 처리 시 SQL Warehouse 설정

참고 Genie의 쿼리 최적화 팁: Genie가 생성한 SQL이 비효율적이라면, Monitoring 탭에서 해당 쿼리를 확인하고, 더 효율적인 SQL을 Instructions의 예시 쿼리 로 등록하세요. 유사한 질문에 대해 Genie가 최적화된 SQL 패턴을 학습합니다.

​

Genie Space 운영 성숙도 모델

주의 Level 1에서 바로 프로덕션 배포하지 마세요. 최소 Level 2 이상의 컨텍스트 보강을 완료한 후 배포해야 합니다. 컬럼 설명과 JOIN 관계 없이 배포하면 SQL 생성 정확도가 매우 낮아 사용자 신뢰를 잃게 됩니다.