열 설명 및 사용 지침 사용자 지정

업데이트 세트를 통해 인스턴스 간에 사용자 지정을 이전할 수 있도록 시맨틱 열 구성 테이블에 사용자 지정 열 설명 및 사용 지침을 생성합니다.

시작하기 전에

필요한 역할: sn_query_gen.admin 이상

이 태스크 정보

시맨틱 계층은 쿼리 생성 열 설명과 사용 지침을 사용하여 AI가 각 필드가 나타내는 내용과 쿼리 방법을 이해하도록 돕습니다. sys_documentation 테이블에서 자동 생성된 설명을 재정의하고 쿼리 구성을 안내하는 사용 지침을 추가할 수 있습니다.

이 절차에서는 시맨틱 열 구성 테이블을 사용합니다. 이러한 방식으로 만들어진 사용자 지정은 업데이트 세트를 통해 인스턴스 간에 이전될 수 있으며 차원 테이블에 직접 설정된 설명 및 사용 지침을 무효화할 수 있습니다. 더 간단한 단일 인스턴스 테스트의 경우 대신 차원 [sn_query_gen_dimension] 테이블에서 직접 시맨틱 레이블 및 시맨틱 사용 지침 필드를 편집할 수 있습니다. 이러한 변경 사항은 플러그인 업그레이드에 포함된 차원 테이블의 변경 사항으로 무효화될 수 있습니다.

사용자 지정 설명을 제공하거나, 쿼리 지침에 대한 사용 지침을 추가하거나, 의미 체계 계층에서 전체 테이블을 제거하지 않고 특정 열을 비활성화하려는 경우 열 구성을 사용합니다.

프로시저

1. 다음으로 이동 쿼리 작성 > 시맨틱 열 구성.
2. 새로 만들기를 선택합니다.
3. 시맨틱 열 구성 양식에서 다음 정보를 입력합니다.

   표 1. 시맨틱 열 구성 양식

   필드	설명
   테이블 이름	열이 속한 테이블입니다. 시맨틱 계층에 활성 엔터티가 있어야 합니다.
   열 이름	구성할 열입니다. 표시 레이블이 아닌 데이터베이스 열 이름을 사용하십시오.
   시맨틱 설명	비즈니스 용어에서 열이 나타내는 내용에 대한 사용자 지정 설명입니다. sys_documentation에서 자동 생성된 설명을 재정의합니다. 최대 2,000자입니다.
   시맨틱 사용 지침	쿼리 생성 중에 이 열을 사용하는 방법에 대한 AI 지침입니다. 기본 연산자, 예상 값 형식 및 필터링 동작을 포함합니다. 최대 2,000자입니다.
   활성	열 구성이 적용되는지 여부입니다. 선택을 취소하면 열이 자동 생성된 상태로 대체됩니다.

4. 제출을 선택합니다.
   시스템이 구성을 시맨틱 계층의 해당 차원 기록에 자동으로 동기화합니다.

결과

사용자 지정 열 구성이 활성 상태이며 이 열과 관련된 쿼리를 처리할 때 사용됩니다 쿼리 생성 . 이 사용자 지정은 시맨틱 열 구성 테이블에 저장되므로 업데이트 세트에 포함하거나 다른 인스턴스로 이전할 수 있습니다. 자세한 내용은 System update sets 문서를 참조하십시오.

열 구성

다음 예시에서는 효과적인 열 설명과 사용 지침을 보여줍니다.

표 2. 열 구성 예시

열	유형	시맨틱 설명	사용 지침
creation_type	선택	데이터 세트가 생성된 방법을 나타냅니다. 값: 'Curated'(직접 선택), 'Derived'(기존 데이터 세트에서 변환), 'Synthetic'(인위적으로 생성).	비워 두기 — 선택 값은 시스템에서 자동으로 채워집니다.
dataset_creation_date	날짜	자산 기록이 인스턴스에 추가된 시기와는 무관하게, 데이터 세트 자체가 처음 생성 또는 컴파일된 날짜입니다.	YYYY-MM-DD 형식의 날짜 연산자(>=, <=, BETWEEN)를 사용합니다.
base_datasets	참조	이 데이터 세트가 파생되거나 구축되는 다른 AI 데이터 세트 자산 목록으로, 데이터 세트 계보를 나타냅니다.	참조 필드 비어 있음 을 사용하여 원본/루트 데이터 세트를 찾습니다. 비어 있지 않음을 사용하여 파생된 데이터 세트를 찾습니다.

다음에 수행할 작업

이 필드 쿼리 생성 와 관련된 질문을 하고 올바른 필터가 생성되는지 확인하여 열 구성을 테스트합니다.