Snowsight 를 사용하여 의미 체계 뷰 생성 및 관리

Snowsight 에서 의미 체계 뷰 를 만들고 관리할 수 있습니다.

의미 체계 뷰 생성하기

Snowsight 에서 마법사를 사용하거나 의미 체계 모델 사양 을 업로드하여 의미 체계 뷰를 만들 수 있습니다.

참고

To create a semantic view, you must use a role with the following privileges:

  • CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.

  • USAGE on the database and schema where you are creating the semantic view.

  • SELECT on the tables and views used in the semantic view.

Using the AI-assisted generator to create a semantic view

AI 지원 생성기를 사용하여 여러 소스의 의미 체계 정보를 결합하는 의미 체계 뷰를 생성합니다. YAML 사양을 사용하여 의미 체계 뷰를 수동으로 만드는 대신 Snowsight 내의 모델 생성기를 사용하면 시간을 절약할 수 있습니다. 의미 체계 뷰를 만드는 프로세스에는 다음 정보가 필요합니다.

  • 뷰에 대한 기본 정보가 포함된 설명

  • 컨텍스트(예: 예제 SQL 쿼리)

  • 사용 중인 데이터 소스(하나 이상의 테이블 또는 뷰)

  • 사용 중인 열

AI 지원 생성기는 다음과 같은 방식으로 입력을 처리합니다.

  • 예제 SQL 쿼리

    • 쿼리 목록의 유효성을 검사하고 유효하지 않은 쿼리를 삭제합니다.

    • 쿼리에서 모든 테이블과 열을 추출하고 의미 체계 뷰에 추가하기 전에 검토를 위해 제시합니다.

    • 쿼리에서 관계를 추출합니다.

    • 유효한 쿼리를 의미 체계 뷰에 검증된 쿼리로 추가합니다.

  • 테이블 메타데이터

    • 모든 테이블 및 열 설명을 추출합니다.

    • 메타데이터를 분석하거나 고유 값을 계산하여 의미 체계 뷰에 기본 키와 고유 키를 추가해 카디널리티 및 관계 유형을 결정합니다.

  • 쿼리 기록

    • 과거의 SQL 쿼리를 의미 체계 뷰에 대한 제안으로 표시합니다. AI 지원 생성기는 선택한 테이블과 열의 범위에 맞는 가장 일반적인 유형의 쿼리를 식별합니다.

    • 의미 체계 뷰에 유효한 관계와 열 유형을 찾습니다.

    • Cortex Analyst 는 의미 체계 모델을 생성하는 데 사용되는 역할이 액세스할 수 있는 쿼리 기록을 사용하여 관계 및 검증된 쿼리 제안을 모두 생성합니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 AI & ML » Cortex Analyst 를 선택합니다.

  3. At the top of the navigation menu, select Create new » Create new Semantic View.

  4. 생성 후 의미 체계 뷰를 저장할 위치를 선택합니다.

  5. Enter a name for the semantic view.

  6. :ui:`Description`에는 의미 체계 모델에 대한 정보를 지정합니다.

  7. Next 을 선택합니다.

  8. 컨텍스트를 제공하려면 다음 정보를 추가합니다.

    • :ui:`SQL Queries`의 경우, 뷰의 일부로 사용하려는 예제 질문 및 해당 SQL 쿼리를 제공합니다.

  9. For Select tables, provide the data source that you’re using to create the semantic view.

    하나 이상의 테이블 또는 뷰를 제공해야 합니다. 지정할 수 있는 테이블이나 뷰에는 제한이 없지만, Snowflake는 10개를 초과하지 않는 것을 권장합니다.

  10. Next 을 선택합니다.

  11. :ui:`Select columns`의 경우 의미 체계 뷰를 만드는 데 사용할 열을 선택합니다.

    모든 열 또는 특정 열을 선택할 수 있습니다. 성능상의 이유로 Snowflake는 50개 이상의 열을 사용하지 않는 것을 권장합니다.

  12. 각 열의 샘플 값을 의미 체계 뷰에 추가할지 여부를 선택합니다. 샘플 값은 Cortex Analyst 결과의 정확도를 개선하는 데 도움이 됩니다.

  13. 테이블과 열에 대해 AI에서 생성된 설명을 의미 체계 뷰에 추가할지 여부를 선택합니다. AI에서 생성된 설명은 열 이름 및 샘플 값을 기반으로 합니다.

  14. Create and save 을 선택합니다. 의미 체계 뷰 페이지에서 뷰 생성기가 수행하는 단계에 대한 세부 정보를 포함하여 뷰 생성 진행 상황을 볼 수 있습니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.

  15. 선택 사항: 개인 키가 암호화된 경우 암호 구문을 설정하려면 개인 키 암호 구문에 대한 환경 변수를 설정합니다. 추가로 수정하려면 Snowsight 를 사용하여 뷰를 편집하거나 YAML 파일을 직접 편집합니다.

Cortex Analyst 는 생성 후 의미 체계 뷰를 개선하기 위한 제안을 자동으로 생성합니다. 제안 사항이 표시되는 데는 몇 분 정도 소요될 수 있으며, 이를 검토하고 필요에 따라 뷰에 적용할 수 있습니다.

YAML 사양을 업로드하여 의미 체계 뷰 만들기

  1. Cortex Analyst 에서 의미 체계 뷰를 만들려는 경우 YAML 파일에 대한 스테이지를 만듭니다 .

  2. 다음 방법 중 하나로 YAML 파일을 업로드합니다.

    • 데이터베이스 오브젝트 탐색기

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 Catalog » Database Explorer 를 선택합니다.

      3. 의미 체계 뷰를 만들 데이터베이스와 스키마를 선택합니다.

      4. Create » Semantic View » Upload YAML file 를 선택합니다.

      5. 업로드할 YAML 파일을 선택합니다.

      6. Select database, schema and stage 아래에서 YAML 파일을 업로드할 데이터베이스, 스키마, 스테이지를 선택합니다.

      7. YAML 파일을 스테이지의 특정 경로에 업로드하려면 해당 경로를 지정합니다.

      8. Upload 을 선택합니다.

    • Cortex Analyst:

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 AI & ML » Cortex Analyst 를 선택합니다.

      3. Create new » Upload YAML file 를 선택합니다.

      4. 업로드할 YAML 파일을 선택합니다.

      5. Convert and save 을 선택합니다.

의미 체계 뷰 편집하기

참고

Snowsight 에서 의미 체계 뷰를 편집하면 기존 뷰가 효과적으로 대체됩니다. 기존 의미 체계 뷰를 대체하려면 다음 권한이 부여된 역할을 사용해야 합니다.

  • CREATE SEMANTIC VIEW on the schema where you are creating the semantic view.

  • USAGE on the database and schema where you are creating the semantic view.

  • SELECT on the tables and views used in the semantic view.

의미 체계 뷰를 편집하려면 다음과 같이 하십시오.

  1. 다음 방법 중 하나로 의미 체계 뷰에 액세스합니다.

    • 데이터베이스 오브젝트 탐색기

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 Catalog » Database Explorer 를 선택합니다.

      3. 의미 체계 뷰가 포함된 데이터베이스와 스키마를 선택합니다.

      4. Semantic views 을 선택합니다.

      5. 의미 체계 뷰를 선택합니다.

      6. Semantic information 탭을 선택합니다.

    • Cortex Analyst:

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 AI & ML » Cortex Analyst 를 선택합니다.

      3. Semantic views 탭을 선택합니다.

      4. Select database to see semantic views 아래에서 편집하려는 의미 체계 뷰가 포함된 데이터베이스와 스키마를 선택합니다.

      5. 편집하려는 의미 체계 뷰를 선택합니다.

  2. 의미 체계 뷰를 변경합니다. 다음과 같은 유형의 변경을 수행할 수 있습니다.

    • 의미 체계 뷰의 이름 또는 설명을 수정하려면:

      1. 의미 체계 뷰의 이름 옆에 있는 Edit 을 선택합니다.

      2. 이름이나 설명을 변경합니다.

      3. Apply 을 선택합니다.

    • 의미 체계 뷰에 새 논리 테이블을 추가하려면:

      1. 데이터베이스 오브젝트 탐색기에서 + Logical Table 을 선택하거나 Cortex Analyst 에서 + 를 선택합니다.

      2. 마법사의 Select a table 단계에서 다음을 수행합니다.

        1. 의미 체계 뷰에서 사용할 데이터가 포함된 테이블 또는 뷰를 선택합니다.

        2. Next 을 선택합니다.

      3. 마법사의 Select columns 단계에서 다음을 수행합니다.

        1. 뷰에 포함할 열을 선택합니다.

          테이블 또는 뷰의 모든 열을 선택하려면 해당 테이블 또는 뷰를 선택합니다.

        2. Generate logical table 을 선택합니다.

    • 의미 체계 뷰에서 논리 테이블의 이름, 설명, 동의어 또는 기본 키를 변경하려면:

      1. 데이터베이스 오브젝트 탐색기에서 논리 테이블 이름 옆에 있는 추가 옵션 » Edit Logical Table 을 선택하거나 Cortex Analyst 에서 논리 테이블 이름 옆에 있는 Edit 을 선택합니다.

      2. 이름, 설명, 동의어, 기본 키를 변경합니다.

        설명이나 동의어를 지정하지 않은 경우 Generate fields 를 선택하여 이러한 필드를 자동으로 채울 수 있습니다.

      3. Save 을 선택합니다.

    • 팩트, 차원 또는 메트릭을 추가하려면:

      1. 새 항목을 추가하기 위한 양식을 엽니다.

        • 데이터베이스 오브젝트 탐색기에서 추가 옵션 를 선택한 다음, Fact, Dimension 또는 Metric 을 선택합니다.

        • Cortex Analyst 에서 Facts, Dimensions 또는 Metrics 옆에 있는 + 를 선택합니다.

      2. 새 팩트, 차원 또는 메트릭에 대한 정보를 입력하고 Add 를 선택합니다.

    • 팩트, 차원 또는 메트릭을 수정하거나 제거하려면:

      1. Facts, Dimensions 또는 Metrics 를 선택하여 팩트, 차원 또는 메트릭 목록을 표시합니다.

      2. 변경하려는 팩트, 차원 또는 메트릭에서:

        • Edit 을 선택하여 항목을 수정합니다.

        • 추가 옵션 » Remove fact, Remove dimension 또는 Remove metric 을 선택하여 항목을 제거합니다.

    • 관계를 추가하려면:

      1. 새 항목을 추가하기 위한 양식을 엽니다.

        • 데이터베이스 오브젝트 탐색기에서 + Relationship 을 선택합니다.

        • Cortex Analyst 에서 Relationships 옆에 있는 + 를 선택합니다.

      2. 관계의 이름을 입력하고 관계에서 테이블을 선택한 다음, 테이블을 조인하는 데 사용할 열을 선택합니다.

      3. Add 을 선택합니다.

  3. 이 뷰에서 Cortex Analyst 를 사용할 예정이라면 다음 사항을 고려합니다.

    • Verified Queries 섹션에 샘플 쿼리를 추가합니다. 이 섹션은 Cortex Analyst 에서만 사용할 수 있습니다.

      • 다음은 Cortex Analyst가 의미 체계 뷰를 사용하는 방법을 이해하는 데 도움이 되는 쿼리 예시입니다.

      • 데이터의 일반적인 사용 사례를 나타내는 쿼리를 추가하십시오.

    • 테이블, 팩트, 차원 또는 메트릭에 동의어를 추가하십시오.

      • 사용자가 쿼리에서 사용할 수 있는 대체 용어입니다.

      • 동의어 도움말 Cortex Analyst 는 사용자 질문을 올바르게 해석합니다.

    • 사용자 지정 지침 추가.

      • 이는 데이터를 해석하는 방법에 대한 추가적인 컨텍스트를 제공합니다.

      • 고려해야 할 비즈니스 규칙이나 제약 조건을 포함하십시오.

  4. Save 을 선택합니다.

다른 역할에 의미 체계 뷰를 사용할 수 있는 권한 부여

다른 역할에 의미 체계 뷰를 보고 쿼리할 수 있는 권한을 부여하려면:

  1. 다음 방법 중 하나로 의미 체계 뷰에 액세스합니다.

    • 데이터베이스 오브젝트 탐색기

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 Catalog » Database Explorer 를 선택합니다.

      3. 의미 체계 뷰가 포함된 데이터베이스와 스키마를 선택합니다.

      4. Semantic views 을 선택합니다.

      5. 의미 체계 뷰를 선택합니다.

      6. 추가 옵션 » Share 를 선택합니다.

    • Cortex Analyst:

      1. Snowsight 에 로그인합니다.

      2. 탐색 메뉴에서 AI & ML » Cortex Analyst 를 선택합니다.

      3. Semantic views 탭을 선택합니다.

      4. 의미 체계 뷰를 선택합니다.

      5. Share 을 선택합니다.

  2. 의미 체계 뷰를 보고 쿼리할 권한을 부여할 역할을 선택합니다.

  3. Done 을 선택합니다.

그러면 선택한 역할에 의미 체계 뷰에 대한 SELECT 및 REFERENCES 권한을 부여합니다.

의미 체계 뷰 쿼리

데이터베이스 오브젝트 탐색기에서 의미 체계 뷰를 보는 경우 추가 옵션 » Query with SQL 을 선택하여 워크시트를 열고 해당 뷰에 대한 쿼리를 구성할 수 있습니다.

쿼리를 구성하는 방법에 대한 내용은 의미 체계 뷰 쿼리 섹션을 참조하세요.

의미 체계 뷰 생성을 위한 모범 사례

  • 명확한 설명 제공:

    • 모든 이름과 설명에 비즈니스 용어를 사용하십시오.

    • 기술 전문가가 아닌 사용자도 이해할 수 있을 정도로 상세하게 설명하십시오.

  • 대표적인 사용자 질문을 포함:

    • 모델 생성기가 사용자의 의도를 더 잘 이해하는 데 도움이 될 수 있는 질문을 포함하십시오.

    • 다양한 질문 방식을 포함하십시오.

  • 생성된 제안을 신중하게 검토:

    • 질문이 사용 사례와 관련이 있는지 확인하십시오.

    • 제안된 관계가 비즈니스 이해도와 일치하는지 확인하십시오.

  • 실제 질문으로 테스트:

    • 의미 체계 뷰를 생성한 후에는 실제 비즈니스 질문으로 테스트해 보십시오.

    • 모델이 이러한 질문을 얼마나 잘 지원하는지에 따라 의미 체계 뷰를 구체화하십시오.

  • 의미 체계 뷰를 반복해서 개발:

    • 간단한 별표 스키마로 시작하십시오.

    • Core 테이블과 메트릭으로 시작한 다음 확장하십시오. 간단하게 정리할 수 있는 3가지 테이블을 제안합니다.

    • 비즈니스 사용자의 피드백을 받아 의미 체계 뷰를 개선하십시오.

문제 해결하기

  • 의미 체계 뷰가 뷰 목록에 나열되지 않으면 페이지 자체가 아니라 모델 목록을 새로 고칩니다.

  • 의미 체계 뷰의 관계에 오류가 발생하면 이러한 관계가 실제 데이터 구조와 일치하는지 확인하십시오.

  • 쿼리 속도가 느리면 테이블 또는 열의 수를 줄이십시오.

  • 의미 체계 뷰를 사용할 때 Cortex Analyst 가 예상치 못한 결과를 생성하는 경우 의미 체계 뷰에서 팩트, 차원 및 메트릭을 검토하십시오.

언어: 한국어