실습 소개
본 실습에서는
사용자 질의와 데이터 항목이 잘 매핑 되도록 필드명, 역할, 유의어, 계산 항목 등 설계 기준을 학습합니다.
주요 내용은 다음과 같습니다.
- 업무 DB 연결 설정
- 분석 주제별 카테고리 생성
- 개발자 계정 생성
실습하기 전에
초기 환경 구성을 위해 TRINITY 접속 URL, 관리자 계정 정보, 연결할 DB 정보, 카테고리명, 생성할 개발자 계정 정보를 확인합니다.
데이터 모델링
답변 정확도를 높이려면 단순히 DB 컬럼을 등록하는 것이 아니라, 사용자가 질문하는 방식에 맞게 분석 데이터 모델을 설계해야 합니다.
스키마 정의 Tip
1. 메타 필드명은 사용자가 자연스럽게 질문할 수 있는 용어로 정의
실제 DB 컬럼명은 사용자에게 직관적이지 않으므로, 취합된 사용자 질의를 토대로 자주 사용하는 용어로 정의
2. 자주 사용하는 계산 필드는 사전 생성하여 질의 시 즉시 활용될 수 있도록 구성
계산식으로 도출 가능한 필드는 계산필드로 생성하고, 사용자 질의와의 유사도가 높게 매칭되도록 구성
3. 메타 필드는 질의에 실제로 사용할 필드만 선정하며, 항목이 중복되지 않도록 구성
조인 관계에 있는 테이블 간 필드 선택 시, 조인 대상 컬럼이 중복 조회되지 않도록 기준을 정해 설계
사용자 질의를 기준으로 분석하여, 필요한 필드만 선정하여 의미 있는 데이터만 조회되도록 구성
4. 날짜 컬럼 추가(년도, 년월, 일자, 분기, 주차 등…)
다양한 포맷의 날짜 컬럼을 추가하여 질의 시 결과가 정상적으로 나올 수 있게 유도
※ 가급적 DB 컬럼으로 추가 해두고 INDEX 사용하는 것이 퍼포먼스에 유리합니다.
5. 날짜 컬럼은 Period 타입, 포맷 설정하기
년도, 년월, 일자 등 날짜의 비교 계산을 위해서는 Period 타입, 포맷을 설정
6. 하나의 키워드로 여러 필드가 함께 조회되어야 할 경우
상품 대/중/소 분류로 구분된 필드를 하나의 자연어로 조회되어야 할 경우 계층구조 항목 추가를 통해 구성
7. 메타 구성 시 분석 및 질의 효율을 높이기 위해 관련 데이터를 최대한 조인하여 단일 메타로 구성
사용자 질의에 필요한 정보를 하나의 메타에서 바로 조회할 수 있어, 복잡한 쿼리 분기 없이 쿼리 규칙 정의 및 프롬프트 설계가 수월
8. 필드명은 서로 다른 테이블 간에도 의미가 명확하게 구분될 수 있도록 중복되지 않게 정의시)
• 매장 테이블 : 관리담당자 → 매장관리담당자
• 고객 테이블 : 관리담당자 → 고객관리담당자
Role 정의 Tip
본문
Role이 아이템의 동작을 결정한다
Dimension(조회축) — 그룹·표시 기준(지점, 연령대). GROUP BY 대상
Measure(측정값) — 수치+집계(SUM/COUNT/AVG). 묶을 때 자동 집계
Period(기간) — 날짜서식(YYYYMMDD/YYYY) → 월별·전년대비 해석의 근거
Filter(조건 전용·신설) — WHERE로만, SELECT/GROUP BY 금지(SAP push-down 등)
FieldGroup(묶음) — '전체금액'=수신/요구불/저축성… 전개
증상 → 처리 예
'합계가 안 나옴' → 수신이 Dimension → role=Measure로 변경
'연/월 조회 0건’ → 기간 은 Period 로 처리
시멘틱 정의 활용 Tip
샘플값 생성
본문
자동 유의어 생성
본문
도메인 규칙 (메타 설명 = 시스템 프롬프트)
메타 단위로 비즈니스 규칙을 자연어로 주입 (예: '지점명은 사무소명 우선')
필드 설명으로 항목별 의미·서열 명시 (예: 등급 '탑클래스>골드>로얄>그린>블루…')
유의어 / 값학습
유의어 synonyms — 사용자 단어↔항목 (예: '콕뱅'→콕뱅크가입여부)
값학습 value_learning — 값↔컬럼 (예: '로얄'이 어느 컬럼 값인지 ES 색인)
동적필터 / 대시보드 방향성
동적필터 dynamic_filter_sql — 항목에 자동 WHERE (예: '유효 계좌만')
대시보드 방향성 dashboard_rule — 메타별 기본 현황 구성 override
비즈니스 로직 적용 필드 추가
계산필드 추가/편집
본문
필드그룹 추가/편집
본문
필드 묶음/편집
코드(식별)와 명칭(표시)을 한 쌍으로 묶습니다. 조건은 코드로, 표시는 명칭 우선.
명칭으로 조건을 걸어도 규칙 기반으로 코드에 매핑됩니다 (LLM 무관). 묶을 때 코드↔명 매핑을 자동 학습합니다.
필터 = 코드 SELECT = 명칭 우선 코드 = 옵션
계층 묶음/편집
차원·기간을 상위→하위 레벨로 묶은 계층입니다. 조회 시 드릴다운(연›분기›월) 경로로 사용됩니다.
값 개수(값학습)·이름 패턴·샘플값 포함관계로 레벨 순서를 자동 판정합니다. 결과는 제안이며 위/아래 버튼이나 트리 드래그로 수정할 수 있습니다.
계층 묶음 — 연도→분기→월처럼 단계별로 — 위아래 단계가 있는 항목들을 골라 마우스 오른쪽 버튼으로 계층 하나로 묶습니다.
단계 순서는 끌어서 바꾸고, '자동 계층' 버튼을 누르면 실제 데이터를 살펴 알맞은 순서를 근거와 함께 제안합니다. 큰 단위에서 작은 단위로 파고들며 보는 분석의 토대가 됩니다.
