Genie Space 성능 튜닝 가이드

-- 여러 물리 테이블을 하나의 주제별 뷰로 결합
CREATE OR REPLACE VIEW gold.customer_360 AS
SELECT
    c.customer_id,
    c.name,
    c.segment,
    -- 코드값 → 사람이 읽을 수 있는 이름으로 변환
    CASE WHEN c.grade_code IN ('1','2','3') THEN 'VIP'
         WHEN c.grade_code IN ('4','5') THEN '우수'
         ELSE '일반' END AS customer_grade,
    -- 지역코드 → 지역명 (우편번호 테이블 조인)
    z.region_name,
    -- 상품 보유 정보 비정규화
    p.product_count,
    p.total_balance
FROM gold.customers c
LEFT JOIN gold.zipcode_regions z ON c.zipcode = z.zipcode
LEFT JOIN gold.customer_products p ON c.customer_id = p.customer_id;

-- 뷰를 여러 개 만드는 대신
-- CREATE VIEW revenue_by_date AS SELECT SUM(amount)... GROUP BY date
-- CREATE VIEW revenue_by_region AS SELECT SUM(amount)... GROUP BY region
-- CREATE VIEW revenue_by_product AS SELECT SUM(amount)... GROUP BY product

-- Metric View 하나로 해결
CREATE METRIC VIEW order_metrics AS
SELECT
    order_date,
    region,
    product_line,
    MEASURE revenue AS SUM(sale_amount),
    MEASURE order_count AS COUNT(DISTINCT order_id),
    MEASURE avg_order_value AS SUM(sale_amount) / COUNT(DISTINCT order_id)
FROM gold.orders;

-- 사용자가 GROUP BY를 자유롭게 선택
SELECT product_line, MEASURE(revenue) FROM order_metrics GROUP BY 1;

-- 예: 고객 등급, 상품군, 연령대 등
-- 이런 Dimension을 뷰에 미리 포함시키면 Genie가 정확하게 필터링
ALTER VIEW gold.customer_360
  ALTER COLUMN customer_grade SET TAGS ('dimension' = 'true');
ALTER VIEW gold.customer_360
  ALTER COLUMN region_name SET TAGS ('dimension' = 'true');

-- 테이블 설명
COMMENT ON TABLE gold.customer_360 IS 
  '고객 마스터 뷰. 고객 기본정보, 등급, 지역, 상품 보유 현황을 통합';

-- 컬럼 설명 — Genie가 이 설명을 참고하여 SQL 생성
COMMENT ON COLUMN gold.customer_360.customer_grade IS 
  '고객 등급. VIP(1-3등급), 우수(4-5등급), 일반(6등급 이하). 우량 고객은 VIP + 우수를 의미함';

COMMENT ON COLUMN gold.customer_360.region_name IS 
  '고객 관리 지역명. 서울/부산/대구/인천/광주/대전/울산/세종/경기 등 17개 시도';

-- 예시 쿼리: "전분기 대비 VIP 고객 증가율"
-- 자연어: 전분기 대비 이번 분기 VIP 고객 수 증가율 알려줘
SELECT
    current_quarter.vip_count,
    prev_quarter.vip_count AS prev_vip_count,
    ROUND((current_quarter.vip_count - prev_quarter.vip_count) 
          / prev_quarter.vip_count * 100, 1) AS growth_rate_pct
FROM (
    SELECT COUNT(*) AS vip_count
    FROM gold.customer_360
    WHERE customer_grade = 'VIP'
      AND base_month = DATE_FORMAT(CURRENT_DATE(), 'yyyyMM')
) current_quarter
CROSS JOIN (
    SELECT COUNT(*) AS vip_count
    FROM gold.customer_360
    WHERE customer_grade = 'VIP'
      AND base_month = DATE_FORMAT(ADD_MONTHS(CURRENT_DATE(), -3), 'yyyyMM')
) prev_quarter;

-- 고객 이탈 위험도 계산 함수
CREATE OR REPLACE FUNCTION gold.calc_churn_risk(
    last_transaction_date DATE,
    total_transactions INT
)
RETURNS STRING
RETURN CASE
    WHEN DATEDIFF(CURRENT_DATE(), last_transaction_date) > 180 THEN '높음'
    WHEN DATEDIFF(CURRENT_DATE(), last_transaction_date) > 90 THEN '중간'
    ELSE '낮음'
END;

인스트럭션 예시:
"사용자가 '고객 분석'이라고만 말하고 고객 세그먼트를 지정하지 않은 경우,
SQL을 실행하기 전에 반드시 다음을 질문하세요:
'어떤 고객 세그먼트를 분석하시겠어요? (예: VIP, 신규 가입, 이탈 위험)'"

인스트럭션 예시:
"응답 요약 시 다음 규칙을 따르세요:
- 한국어로 응답하세요
- 결과 테이블에서 참조한 테이블명을 반드시 언급하세요
- 금액은 원 단위로 천 단위 콤마를 포함하세요 (예: 1,234,567원)
- 비율은 소수점 1자리까지 표시하세요 (예: 12.3%)
- 결과가 0건이면 '조건에 해당하는 데이터가 없습니다'라고 안내하세요"