|sf-web-interface|를 사용하여 의미 체계 뷰 생성 및 관리

|sf-web-interface|에서 의미 체계 뷰 를 만들고 관리할 수 있습니다.

의미 체계 뷰 생성하기

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

마법사를 사용하여 의미 체계 뷰 만들기

참고

의미 체계 뷰를 만들려면 의미 체계 뷰를 만드는 데 필요한 권한 에 설명된 권한이 있는 역할을 사용해야 합니다.

  1. 다음 방법 중 하나로 의미 체계 뷰를 만드는 마법사에 액세스합니다.

  2. 마법사의 Getting started 단계에서 다음을 수행합니다.

    1. Location to store 에서 모델을 저장할 데이터베이스와 스키마를 선택합니다.

    2. Name 에서 의미 체계 뷰의 이름을 입력합니다.

      문자 또는 밑줄로 시작하고 문자, 숫자, 밑줄 또는 달러 기호로만 구성된 이름을 지정해야 합니다.

    3. (선택 사항) Description 에는 의미 체계 뷰에서 사용할 수 있는 데이터를 설명합니다.

    4. Next 을 선택합니다.

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

    1. All 탭에서 의미 체계 뷰에서 사용할 데이터가 포함된 테이블 또는 뷰를 선택합니다. 다음 사항에 유의하세요.

      • 1개 이상의 테이블 또는 뷰를 선택해야 합니다.

      • 성능 향상을 위해 10개 이상의 테이블을 선택하지 마십시오.

      • 선택한 테이블 및 뷰 목록을 보려면 Selected 탭을 선택합니다.

    2. Next 을 선택합니다.

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

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

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

      성능 향상을 위해 열을 50개 이상 선택하지 마십시오.

    2. Create and Save 을 선택합니다.

  5. Logical tables 아래에서:

    1. 각 테이블 또는 뷰에 정의된 팩트, 차원 및 메트릭을 검토합니다.

    2. 비즈니스 친화적인 이름과 설명을 제공합니다.

    3. 필요한 추가 팩트, 차원 및 메트릭을 추가하십시오.

  6. Relationships 아래에서:

    1. 생성기에 정의된 모든 관계를 확인합니다.

    2. 필요에 따라 관계 속성을 수정했습니다.

    3. 필요한 추가 관계를 추가합니다.

  7. 의미 체계 뷰를 변경한 경우 :ui:`Save`를 선택합니다.

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

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

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

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

      1. |sf-web-interface-link|에서 :ui:`Data` |ra| Databases 를 선택합니다.

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

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

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

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

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

      7. Upload 을 선택합니다.

    • Cortex Analyst:

      1. |sf-web-interface-link|에서 :ui:`AI & ML` |ra| Cortex Analyst 를 선택합니다.

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

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

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

의미 체계 뷰 편집하기

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

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

  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. 다음 방법 중 하나로 의미 체계 뷰에 액세스합니다.

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

  3. Done 을 선택합니다.

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

의미 체계 뷰 쿼리

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

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

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

  • 명확한 설명 제공:

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

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

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

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

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

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

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

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

  • 실제 질문으로 테스트:

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

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

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

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

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

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

문제 해결하기

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

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

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

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