의미 체계 뷰 편집기¶
Snowsight 의 의미 체계 뷰 편집기는 :doc:`의미 체계 뷰 <overview>`를 생성하고 편집하기 위한 시각적 인터페이스를 제공합니다. :doc:`Autopilot <autopilot>`에 의해 생성된 뷰를 구체화하거나, 처음부터 구축하거나 업로드된 YAML 사양을 편집하는 경우 편집기는 데이터에 대한 비즈니스 개념, 메트릭 및 관계를 정의하는 데 도움이 됩니다.
의미 체계 뷰 편집기를 사용하면 다음을 수행할 수 있습니다.
물리적 데이터베이스 테이블에 매핑되는 논리적 테이블 정의
차원(범주형 특성), 팩트(행 수준 데이터) 및 메트릭(집계된 측정값) 생성
테이블 간의 관계 설정
검증된 쿼리를 Cortex Analyst 의 예제로 추가
쿼리 생성을 위한 사용자 지정 지침 제공
검색 가능성 향상을 위한 동의어 및 설명 구성
편집기에 액세스하기¶
데이터 카탈로그 또는 Cortex Analyst 를 통해 의미 체계 뷰 편집기에 액세스할 수 있습니다.
데이터 카탈로그를 통해¶
데이터 카탈로그를 통해 기존 의미 체계 뷰에 액세스하려면 다음을 수행합니다.
Cortex Analyst를 통해¶
Cortex Analyst 를 통해 의미 체계 뷰에 액세스하려면 다음을 수행합니다.
의미 체계 뷰 메타데이터 편집¶
의미 체계 뷰 이름과 설명은 사용자가 뷰의 목적을 발견하고 이해하는 데 도움이 됩니다.
의미 체계 뷰 이름 또는 설명을 편집하려면 다음을 수행합니다.
편집기에서 페이지 상단의 의미 체계 이름 옆에 있는 :ui:`Edit`를 선택합니다.
Name 또는 Description 필드를 업데이트합니다.
Save 을 선택합니다.
팁
다음을 설명하는 명확하고 자세한 설명을 작성합니다.
이 뷰가 답변할 수 있는 비즈니스 질문
포함되는 데이터 소스
이 뷰를 사용해야 하는 사용자
예: “연도별 추세를 포함한 제품 및 고객 전반의 수익 분석. 이 뷰를 사용하여 리전, 제품 카테고리 및 고객 세그먼트별로 판매 실적을 분석합니다.”
논리 테이블 관리¶
논리 테이블은 비즈니스 엔터티(예: 고객, 주문 또는 제품)를 나타내며 물리적 데이터베이스 테이블 또는 뷰에 매핑됩니다. 각 의미 체계 뷰에는 하나 이상의 논리 테이블이 포함됩니다.
논리 테이블 추가¶
의미 체계 뷰에 논리 테이블을 추가하려면 다음을 수행합니다.
편집기에서 :ui:`+ Logical Table`을 선택합니다.
데이터베이스에서 물리적 테이블 또는 뷰를 찾아 선택합니다.
Next 을 선택합니다.
테이블에서 포함할 열을 선택합니다.
Generate logical table 을 선택합니다.
편집기는 선택한 열을 기반으로 차원과 팩트를 자동으로 생성합니다.
논리 테이블 편집¶
기존 논리 테이블을 수정하려면 다음을 수행합니다.
테이블 이름 옆에 있는 Edit`(또는 :ui:`More options » Edit Logical Table)를 선택합니다.
테이블 속성을 수정합니다.
Name: 이 테이블의 비즈니스 친화적인 이름
Description: 이 테이블이 나타내는 내용에 대한 설명
Synonyms: 대체 이름(쉼표로 구분)
Primary Key: 행을 고유하게 식별하는 열
Save 을 선택합니다.
팁
Generate fields 버튼을 사용하면 AI가 데이터와 열 이름을 기반으로 설명과 동의어를 자동으로 채울 수 있습니다. 이를 통해 초기 설정 프로세스의 속도를 크게 높일 수 있습니다.
팩트, 차원 및 메트릭 관리하기¶
각 논리 테이블 내에서 사용자가 쿼리할 수 있는 비즈니스 개념(차원, 팩트, 메트릭)을 정의합니다.
콘텐츠 타입 이해하기¶
차원: 컨텍스트를 제공하는 범주형 특성(예: 고객 이름, 제품 카테고리 또는 주문 날짜)
팩트: 행 수준의 정량적 데이터(예: 판매 금액, 수량 또는 단가)
메트릭: SUM, AVG, COUNT와 같은 함수에서 계산된 집계 측정값(예: 총 수익, 평균 주문 금액)
차원, 팩트 또는 메트릭 추가하기¶
논리 테이블에 새 항목을 추가하려면 다음을 수행합니다.
편집기에서 논리 테이블로 이동합니다.
Dimensions, Facts 또는 Metrics 옆에 있는 :ui:`+`를 선택합니다.
필수 세부 정보를 입력합니다.
Name: 이 항목에 대한 설명이 포함된 이름
Expression: 값을 계산하는 SQL 식
Data Type: 결과의 데이터 타입
Add 선택
항목 편집 또는 제거¶
기존 차원, 팩트 또는 메트릭을 수정하거나 삭제하려면 다음을 수행합니다.
고급 기능¶
파생 메트릭: 여러 테이블의 메트릭을 결합하는 뷰 수준 메트릭을 생성할 수 있습니다. 자세한 내용은 파생 메트릭 정의하기 섹션을 참조하십시오.
비공개 액세스 한정자: 팩트 또는 메트릭을 비공개로 표시하여 다른 계산에서 계속 사용하면서 쿼리에서 숨길 수 있습니다. 자세한 내용은 팩트 또는 메트릭을 비공개로 표시 섹션을 참조하십시오.
메트릭의 기본 조인 경로: 두 논리 테이블 간에 다중 관계 경로 <label-semantic_views_create_logical_tables_relations>`가 있는 경우, :ui:`Preferred join path 메뉴에서 사용할 관계를 선택할 수 있습니다.
관계 관리하기¶
관계는 논리적 테이블을 함께 조인하는 방법을 정의하여 여러 테이블에 걸친 쿼리를 활성화합니다. 각 관계는 한 테이블의 어떤 열이 다른 테이블의 열을 참조하는지 정의합니다.
관계 추가하기¶
두 논리 테이블 간의 관계를 생성하려면 다음을 수행합니다.
편집기에서 Relationships 옆에 있는 :ui:`+`를 선택합니다.
관계에 대한 설명이 포함된 Name 이름을 입력합니다(예: “orders_to_customers”).
:ui:`Left Table`을 선택합니다(외래 키가 있는 테이블).
:ui:`Right Table`을 선택합니다 (참조되는 테이블).
각 테이블에 대한 :ui:`Join Columns`를 지정합니다.
Left Column: 왼쪽 테이블의 외래 키 열
Right Column: 오른쪽 테이블의 기본 키 또는 고유 열
Add 을 선택합니다.
이제 관계가 관계 목록에 표시되고 Cortex Analyst 를 활성화하여 해당 테이블을 조인하는 쿼리를 생성합니다.
참고
의미 체계 뷰의 경우 일반적으로 조인 유형(왼쪽 외부, 내부) 또는 관계 유형(일대일, 다대일)을 지정할 필요가 없습니다. 이는 쿼리 시 데이터 및 기본 키 정의에서 자동으로 유추됩니다.
관계 편집 또는 제거하기¶
관계를 수정하거나 삭제하려면 다음을 수행합니다.
Cortex Analyst의 고급 기능¶
Cortex Analyst 의 정확도와 안정성을 개선하려면 검증된 쿼리, 동의어, 사용자 지정 지침을 통해 컨텍스트와 지침을 추가할 수 있습니다.
유효성 검사된 쿼리¶
검증된 쿼리는 올바른 SQL 답변이 포함된 질문 예제를 제공합니다. 다음의 두 가지 용도로 사용됩니다.
Cortex Analyst 가 유사한 질문에 답변하는 방법을 이해할 수 있도록 지원
사용자가 시작하는 데 권장되는 질문 제공
검증된 쿼리를 추가합니다.
Verified Queries 옆에 있는 :ui:`+`을 선택합니다.
자연어 입력 :ui:`Question`을 입력합니다(예: “매출 기준 상위 10개 제품”).
질문에 올바르게 답변하는 해당 :ui:`SQL Query`를 입력합니다.
(선택 사항) :ui:`Use as onboarding question`을 확인하여 사용자에게 제안으로 표시합니다.
Add 을 선택합니다.
팁
다음에 대해 검증된 쿼리를 추가합니다.
사용자가 자주 묻는 일반적인 비즈니스 질문
특정 논리가 필요한 복잡한 쿼리
극단적인 사례 또는 비정상적인 계산
뷰의 기능을 보여주는 질문
동의어¶
참고
AI를 사용하여 동의어를 자동 생성하는 대신 수동으로 추가합니다. 내부 용어, 약어 또는 레거시 이름과 같은 도메인별 대체 용어에 중점을 둡니다. 자동 생성된 동의어는 의미 체계 뷰의 품질을 저하시키는 경우가 많습니다.
동의어는 사용자가 대체 용어를 사용하여 데이터를 검색하고 쿼리하는 데 도움이 됩니다. 예를 들어, 사용자는 “customers”를 “clients” 또는 “accounts”로 지칭할 수 있습니다.
테이블 또는 필드에 동의어를 추가합니다.
동의어를 추가하려는 테이블, 차원, 팩트 또는 메트릭으로 이동합니다.
:ui:`Edit`를 선택하여 항목의 속성을 엽니다.
Synonyms 필드에서 대체 용어를 쉼표로 구분하여 입력합니다.
Save 을 선택합니다.
동의어 예제:
“customer_name” 차원의 경우: “client name, account name, buyer name”
“revenue” 메트릭의 경우: “sales, income, earnings”
“orders” 테이블의 경우: “sales orders, purchases”
사용자 지정 지침¶
사용자 지정 지침은 SQL 생성 및 질문 분류를 위해 Cortex Analyst 에 구체적인 지침을 제공합니다. 사용자 지정 지침을 사용하여 다음을 수행할 수 있습니다.
비즈니스 규칙 및 제약 조건 정의
기본 동작 지정
모호한 질문 처리
특정 유형의 질문 거부
다음을 통해 사용자 지정 지침을 추가합니다.
편집기에서 Custom Instructions 섹션을 선택합니다.
자연어로 지침을 입력합니다. 예제:
“달리 명시하지 않는 한 항상 활성 고객별로 필터링(status = ‘ACTIVE’)”
“모든 화폐 값을 소수점 둘째 자리까지 반올림”
“수익에 대해 질문할 때 총수익을 명시적으로 요청하지 않는 한 net_revenue 메트릭 사용”
“리전을 지정하지 않고 사용자에 대한 질문을 하는 경우 사용자에게 어떤 리전인지 명확히 하도록 요청”
Save 을 선택합니다.
의미 체계 뷰의 사용자 지정 지침에 대한 자세한 내용은 |cortex-analyst|용 사용자 지정 지침 제공하기 섹션을 참조하세요.
YAML 파일 업로드하기¶
기존 의미 체계 뷰 YAML 사양 또는 레거시 의미 체계 모델 YAML 파일이 있는 경우 새 의미 체계 뷰를 생성하거나 기존 뷰를 업데이트할 수 있습니다.
YAML 파일을 업로드하려면 다음을 수행합니다.
탐색 메뉴에서 AI & ML » Cortex Analyst 를 선택합니다.
Create new » :ui:`Upload YAML file`을 선택합니다.
YAML 파일을 찾아 선택합니다.
편집기에서 생성된 의미 체계 뷰 구조를 검토합니다.
:ui:`Convert and save`를 선택하여 의미 체계 뷰를 스키마 수준 오브젝트로 생성합니다.
편집기는 YAML 사양을 네이티브 Snowflake 의미 체계 뷰로 변환한 다음 시각적 인터페이스를 사용하여 편집할 수 있습니다.
YAML 사양 형식에 대한 자세한 내용은 의미 체계 뷰의 YAML 사양 섹션을 참조하세요.
프로그래밍 방식으로 사양을 의미 체계 뷰로 변환하는 방법에 대한 자세한 내용은 YAML 사양에서 의미 체계 뷰 만들기 섹션을 참조하세요.