시맨틱 메타데이터 사용자 지정

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 04월 17일
  • 소요 시간: 5분

    • 시맨틱 메타데이터(설명, 레이블 및 사용 지침)는 자연어 질문을 해석하는 방법을 쿼리 생성 제어합니다. 이러한 메타데이터를 사용자 지정하여 조직의 용어 및 데이터에 대한 정확도를 높입니다.

    시맨틱 계층의 엔터티(테이블)와 차원(필드) 모두 질문을 처리할 때 사용하는 세 개의 메타데이터 필드 쿼리 생성 가 있습니다.

    시맨틱 레이블
    엔터티 또는 차원의 짧은 이름 또는 별칭입니다. 사용자의 질문이 기본 필드 레이블과 일치하지 않을 때 AI 검색이 올바른 테이블 또는 필드를 식별하는 데 도움이 되는 검색 키워드로 기능합니다.
    시맨틱 설명
    엔터티 또는 차원이 비즈니스 용어로 나타내는 내용을 자연어로 설명합니다. 시스템에서 유사한 테이블이나 필드를 구별하는 데 도움이 되는 컨텍스트를 제공합니다.
    시맨틱 사용 지침
    엔터티 또는 차원이 선택되면 LLM 프롬프트에 직접 삽입되는 지침입니다. 시스템에 데이터를 쿼리하는 방법(예: 사용할 연산자, 약어를 처리하는 방법 또는 계층 구조 값을 확장하는 방법)을 교육합니다.

    사용자 지정 시기

    메타데이터는 자동으로 생성되며 베이스라인 상태에서 잘 작동합니다. 일관되고 반복 가능한 문제를 관찰한 경우에만 사용자 지정합니다.

    • 시스템에서 잘못된 테이블을 선택하거나 테이블을 찾을 수 없습니다. 설명 및 레이블을 편집합니다.
    • 잘못된 필드가 선택되었거나 필드가 누락되었습니다 — 설명 및 레이블 편집
    • 조직에서 자동 생성된 레이블과 다른 용어를 사용합니다. 레이블 편집
    • 올바른 테이블 또는 필드가 선택되었지만 쿼리가 잘못 구성되었습니다. 사용 지침 편집
    주:
    수천 개의 차원이 있습니다. 모두 검토하려고 하지 마십시오. 실패한 쿼리에 나타나는 필드에 집중합니다.

    메타데이터를 사용자 지정하는 두 가지 방법

    두 가지 방법을 사용할 수 있습니다. 구성 테이블을 편집하는 것이 기본 접근 방식으로 간주됩니다.

    표 1. 메타데이터 커스터마이제이션 방법
    방법 테이블 사용 시기
    시맨틱 테이블 구성 및 시맨틱 열 구성 테이블의 기록을 편집합니다. 시맨틱 테이블 구성[sn_query_gen_table_config] 및 시맨틱 열 구성[sn_query_gen_column_config] 업데이트 세트와 호환됩니다. 사용자 지정은 업데이트 세트에 포함하거나 인스턴스 간에 이전될 수 있습니다. 엔터티 및 차원 테이블에 설정된 값을 재정의합니다. 엔터티 및 차원 설명과 차원 사용 지침을 지원합니다. 엔터티 레이블 또는 사용 지침을 지원하지 않습니다.
    엔터티 및 차원 테이블의 기록 편집 엔터티 [sn_query_gen_entity] 및 차원 [sn_query_gen_dimension] 더 간단합니다. 단일 인스턴스에서 테스트하기에 적합합니다. 이러한 사용자 지정은 인스턴스 간에 이전할 수 없습니다. 그러나 이 방법은 엔터티 레이블 및 엔터티 수준 사용 지침을 변경하는 유일한 방법입니다. 업그레이드에서 테이블을 업데이트하여 재정의할 수 있습니다.
    주:
    두 방법 모두 sn_query_gen.admin 역할 이상이 필요합니다.

    효과적인 설명 작성

    시맨틱 설명 및 레이블을 작성할 때 다음 지침을 따르십시오.

    • 사용자가 이 데이터를 참조하는 방식에 중점을 두고 설명을 1-2문장으로 유지합니다.
    • 사용자가 말할 수 있는 일반적인 동의어 및 약어 포함
    • 전체 단락은 피하십시오. 간결한 설명이 자세한 설명보다 잘 어울립니다.

    효과적인 사용 지침 작성

    시맨틱 사용 지침을 작성할 때 다음 지침을 따르십시오.

    • 구체적이고 구조적이어야 합니다. 규칙, 예시, 에지 케이스 포함
    • 논리가 복잡한 경우 번호가 매겨진 단계 또는 레이블이 있는 섹션을 사용합니다.
    • 예시 사용자 질문 및 쿼리의 모습 포함
    • 자유 텍스트 필드의 경우 일치 전략(CONTAINS, 정확히 일치) 및 확장 규칙을 지정합니다.
    • 한 엔터티 또는 필드의 요구에 중점을 둔 지침 유지

    사용 지침과 세그먼트

    사용 지침은 LLM이 규칙에 따라 많은 시나리오를 처리할 수 있도록 필드를 동적으로 쿼리하는 방법을 LLM에 알려줍니다. 세그먼트는 특정 필터 값을 하드 코딩합니다. 자유 텍스트 위치와 같은 필드의 경우 가능한 모든 위치 쿼리를 미리 정의할 수 없으므로 사용 지침이 올바른 접근 방식입니다. 세그먼트는 "Sev1" = 우선순위 1과 같은 고정 비즈니스 용어에 더 적합합니다.

    시맨틱 설명

    인시던트 엔터티의 경우 "인시던트 테이블"만 사용하는 대신 "IT 인시던트, 중단, 서비스 중단 및 IT 지원 티켓"과 같은 설명을 사용하여 사용자가 실제로 말하는 용어를 포함합니다.

    사용 지침의 데이터 규칙

    약어를 저장하는 상태 필드의 경우:

    "Values in this field may be full state names or two-letter abbreviations (for example, 'California' or 'CA'). Always query for both forms. For country names, also include common aliases (for example, 'United Kingdom' OR 'UK')."

    사용 지침의 복잡한 쿼리 논리

    다음 사용 지침은 계층적 확장 및 동의어 처리가 있는 자유 텍스트 대략적인 위치 필드에 대한 것입니다.

    필드: 대략적인 위치 - 사용 지침
    대략적인 위치 필드는 정규화되지 않은 자유 텍스트 문자열입니다. 모든 쿼리는 대/소문자를 구분하지 않는 CONTAINS 일치를 사용하고 계층 구조 확장을 처리해야 합니다.
    핵심 쿼리 논리
    1. 지리적 엔터티(인접, 도시, 주, 국가, 지역 또는 대륙)를 식별합니다.
    2. 쿼리하기 전에 광범위한 엔터티를 명시적인 하위 엔터티 목록으로 확장합니다.
    3. 모든 확장된 용어 및 동의어에 대해 OR 논리를 사용합니다.
    확장 규칙
    • 대륙: 해당 대륙 내의 모든 주요 국가 목록으로 확장합니다.
    • 지역: 관련 주 또는 국가로 확장합니다(예: "대서양 연안" - > NC, VA, FL 등).
    • 주/도: 전체 이름과 표준 약어(예: "노스캐롤라이나" 또는 "NC")를 모두 포함합니다.
    • 국가: 일반적인 별칭(예: 'UK' 또는 'United Kingdom')을 포함합니다.
    구현 패턴
    1. 지리적 의도를 추출합니다.
    2. 엔터티 수준을 분류합니다.
    3. 아래로 확장하거나(대륙 > 국가) 동의어(시/도, 약어)를 포함합니다(시/도> 약어).
    4. OR 기반 CONTAINS 필터를 사용하여 단일 쿼리 문자열을 만듭니다.

    패턴을 확인하십시오. 지침은 규칙과 예제를 정의하고 LLM은 사용자가 제공하는 규칙에 따라 많은 관련 쿼리를 동적으로 처리할 수 있습니다. 논리를 한 번 가르치면 모델이 모든 입력에 적용합니다.

    쿼리로 변환된 사용자 질문의 예
    • 사용자: "일본의 항목을 보여주세요" → 쿼리: 위치 "일본"을 포함합니다.

    • 사용자: "아시아 국가의 항목을 보여주세요" → 분해: 아시아 -> [일본, 중국, 인도네시아...] → 쿼리: 위치에 "일본"이 포함되어 있거나, 위치에 "중국"이 포함되어 있거나, 위치에 "인도네시아"가 포함되어 있습니다...

    • 사용자: "노스캐롤라이나의 항목을 보여주세요" → 쿼리: 위치에 "노스캐롤라이나"가 포함되어 있거나 위치에 "NC"가 포함되어 있습니다.
    • 사용자: "유럽의 모든 것을 보여주세요" → 분해: 유럽 > [영국, 스페인, 프랑스, 독일...] → 쿼리: 위치에 "영국"이 포함되어 있거나 위치에 "스페인"이 포함되어 있거나 위치에 "프랑스"가 포함되어 있습니다...