시맨틱 테이블
AI → 시맨틱 레이어 → 시맨틱 테이블에서 자연어 질의가 사용할 테이블 정보를 정의합니다. 컬렉션과 데이터 연결, 라우팅 설명을 먼저 설정한 뒤 컬럼과 메트릭을 구성합니다.
기본 정보와 데이터 연결
- 시맨틱 테이블 만들기를 누릅니다.
- 이름·별칭·컬렉션·설명·태그를 입력합니다. 이름은 글자로 시작하는 소문자·숫자·밑줄 조합이며 최대 63자입니다.
- 백엔드 유형을 ClickHouse / PostgreSQL / OData v2 / OData v4 중에서 선택합니다.
- 컬렉션을 선택한 뒤 사용할 데이터 연결을 선택합니다.
데이터 연결은 필수입니다. 선택한 컬렉션의 연결, 기본 제공 연결, 전역 연결을 후보로 표시합니다. 같은 이름이면 선택한 컬렉션의 연결을 먼저 사용합니다. 연결을 찾을 수 없거나 사용할 권한이 없으면 저장할 수 없습니다.
라우팅과 작성 지침
- 라우팅 설명: 여러 테이블 중 이 테이블을 선택해야 하는 조건을 문장으로 입력합니다. 하나 이상 필요하며 AI로 초안을 만들 수 있습니다.
- 작성 지침: 이 테이블로 질의를 만들 때 적용할 업무 규칙을 입력합니다.
- 관련 테이블: 같은 컬렉션에서 함께 검색할 테이블을 고릅니다. 라우팅을 돕는 참조이며 조인 관계를 정의하지 않습니다.
불러오지 못한 관련 테이블이 남아 있으면 저장하지 않습니다. 현재 컬렉션에서 다시 선택하거나 참조를 제거합니다.
컬럼 구성
컬럼은 구조화 / JSON 모드로 편집합니다.
- 이름과 범주형 / 시간 종류, 설명, 예시 값을 입력합니다.
- LLM 노출 / 필터 가능 / 정렬 가능 / 그룹 가능을 컬럼별로 설정합니다.
- ClickHouse와 PostgreSQL에는 SQL 계산식을 입력할 수 있습니다. OData v2·v4는 컬럼 계산식을 지원하지 않습니다.
- 값 사전은 없음 / 내장 / 외부 중에서 선택합니다. 외부 값 사전은 같은 컬렉션의 공유 값 사전을 참조합니다.
내장 값 사전에는 정규값과 동의어를 관리합니다. 컬럼을 삭제하면 그 안의 값 사전도 함께 사라지므로 확인 창에서 영향을 검토합니다. 이름 없는 컬럼이나 중복 이름이 있으면 저장할 수 없습니다.
메트릭과 필터
고급 JSON에서 메트릭과 재사용 필터를 배열로 정의합니다.
| 항목 | 내용 |
|---|---|
| 메트릭 | simple, ratio, derived, cumulative, conversion |
| 필터 | 이름과 clauses[]로 구성한 재사용 조건 |
visible: false | 컴파일 참조는 유지하고 LLM 카탈로그에서는 숨김 |
OData v2는 서비스 바인딩 같은 OData 옵션 JSON을 추가로 제공합니다. JSON이 올바르지 않거나 배열이 아니면 저장하지 않습니다.
저장 오류 확인
저장되지 않으면 컬럼 이름 중복·필수 라우팅 설명·데이터 연결 권한·관련 테이블 범위·JSON 형식을 순서대로 확인합니다.