# 데이터 제품의 시맨틱 모델 관리

데이터 제품 내에서 시맨틱 모델을 생성하고 편집하여 분석 애플리케이션에서 사용할 수 있는 데이터 구조, 관계, 측정값 및 차원을 정의할 수 있습니다.

시맨틱 모델은 데이터 제품에서 시각적 모델링 인터페이스를 사용하여 생성됩니다.데이터 제품의 의미 체계 모델은 데이터에 액세스할 수 있는 모든 분석 개발자가 사용할 수 있습니다.데이터 제품이 활성화되면 Data Marketplace를 통해 의미 체계 모델을 사용할 수 있게 되며, 이는 프로덕션 사용 사례에 사용할 준비가 되었음을 나타냅니다.

## 전제 조건

의미 체계 모델을 만들기 전에 다음 사항을 확인하세요:

* 데이터 제품을 생성했으며 여기에 추가할 수 있는 데이터 세트가 하나 이상 있습니다.

  정보 메모의미 체계 모델을 작업하기 전에 데이터 제품에 데이터 세트를 추가하거나, 의미 체계 모델을 개발하면서 데이터 세트를 추가할 수 있습니다.

  [데이터 제품 만들기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/Creating-data-products.htm)을(를) 참조하십시오.

* 데이터 제품을 편집할 수 있는 권한이 있습니다.

  [데이터 제품 역할 및 권한](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/data-products-roles-and-permissions.htm)

* 데이터 제품의 데이터 세트에는 의미 체계 모델에 포함하려는 테이블과 필드가 포함되어 있습니다.

## 의미 체계 모델에 정보 추가하기

데이터 제품에서 의미 체계 모델을 개발하려면:

1. 런처 메뉴 the 카탈로그 icon에서 를 선택하고 의미 체계 모델 작업을 수행할 데이터 제품을 클릭합니다.

2. 의미 체계 모델 편집기를 열려면 데이터 제품의 의미 체계 모델 탭을 클릭합니다.

   ![의미 체계 모델 편집기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-editor.png)

의미 체계 모델 편집기는 관계, 측정값 및 차원을 정의할 수 있는 시각적 캔버스와 함께 열립니다.

테이블 헤더를 클릭하면 데이터 및 해당 품질의 미리보기가 표시됩니다.

### 데이터 세트에서 테이블 추가하기

테이블은 의미 체계 모델의 기반입니다.각 테이블은 데이터 제품 내 데이터 세트의 데이터를 나타냅니다.

기본적으로 의미 체계 모델 편집기에는 데이터 제품에 이미 존재하는 테이블이 표시되지만, 필요에 따라 언제든지 테이블을 더 추가할 수 있습니다.

테이블을 추가하려면:

1. 의미 체계 모델 편집기에서 테이블 탭으로 이동한 다음 데이터 추가를 클릭합니다.

   ![테이블 추가](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-add-tables.png)

2. 열리는 카탈로그 창에서 추가하려는 테이블이 포함된 데이터 세트를 하나 이상 선택하고 확인을 클릭합니다.

테이블이 캔버스에 표시됩니다.의미 체계 모델에 추가 테이블을 추가하려면 이 프로세스를 반복합니다.

### 관계 정의

관계는 일치하는 필드를 기반으로 테이블을 연결하여 데이터 전반에 걸친 연관 쿼리를 가능하게 합니다.캔버스에서 테이블을 연결하는 선으로 표시됩니다.

관계를 만들려면 다음과 같이 할 수 있습니다:

* 관계 만들기 버튼을 사용하세요.

  1. 관계를 생성하려는 테이블의 헤더를 클릭합니다.또는 관계를 생성할 특정 필드를 클릭합니다.

  2. 열리는 오른쪽 패널에서 Relationship + 버튼을 클릭합니다.

     ![관계 생성 버튼](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-relationship-table.png)

  3. 드롭다운 메뉴를 사용하여 연결할 두 테이블의 이름과 일치하는 필드의 이름을 선택합니다.

  4. 이름을 추가하고 관계 카디널리티(관계 유형)를 선택합니다.관계 유형 수정은 선택 사항입니다.

     필드 간의 관계 유형에는 다음이 포함될 수 있습니다:

     * **일대일**: 첫 번째 테이블의 한 레코드가 두 번째 테이블의 한 레코드와 일치합니다.
     * **일대다**: 첫 번째 테이블의 레코드 하나가 두 번째 테이블의 여러 레코드와 일치합니다.
     * **다대다**: 첫 번째 테이블의 여러 레코드가 두 번째 테이블의 여러 레코드와 일치할 수 있습니다.
     * **다대일**: 첫 번째 테이블의 여러 레코드가 두 번째 테이블의 레코드 하나와 일치합니다.

     ![관계 적용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-relationship-table_2.png)

  5. 설명을 추가합니다(선택 사항).

  6. 적용을 클릭합니다.

* 끌어서 놓기를 사용하세요.

  1. 필드 위에 마우스 커서를 올리고 필드 측면에 나타나는 노드 중 하나를 클릭한 채로 유지합니다.

  2. 노드를 다른 테이블의 일치하는 필드로 드래그한 후 놓아 관계를 생성합니다.

     ![필드를 드래그하여 관계 만들기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-relationship-drag-and-drop.png)

* 제안 사항을 검토하고 검증합니다.

  Qlik은(는) 다음에 대한 관계를 자동으로 제안합니다:

  * 테이블 간에 동일하거나 유사한 이름을 가진 필드입니다.

    ![관계 제안](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-relationship-suggestions.png)

  * Qlik Talend Data Integration 데이터 파이프라인의 다운스트림인 데이터 제품의 경우, 의미 체계 모델을 편집할 때 원본 파이프라인의 원래 관계가 제안으로 제공됩니다.

    이러한 제안은 시작점입니다.파이프라인에 모델링된 모든 내용이 항상 반영되는 것은 아니므로, 이를 검토하고 누락된 관계를 수동으로 추가하십시오. 제한 사항에 대한 자세한 내용은 [Data Integration 파이프라인의 관계 제안 제한 사항](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-known-issues.htm#PipelineSuggestions)을(를) 참조하세요.

    ![Data Integration 파이프라인의 다운스트림에 있는 데이터 제품의 관계 제안](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-relationship-suggestions-data-pipeline.png)

  다음과 같이 하십시오.

  1. 왼쪽 패널의 제안 탭을 엽니다.

  2. 제안된 관계를 검토하십시오.다음을 수행할 수 있습니다.

     * 제안을 수락합니다.

     * 제안에 대해 더 자세히 알아보려면 추론을 확장하세요.예를 들어, 필드 이름 일치에서 비롯된 것인지 또는 업스트림 Qlik Talend Data Integration 데이터 파이프라인에 정의된 관계인지 여부입니다.

     * 제안 닫기.

정보 메모소비 애플리케이션에서 관계가 올바르게 작동하도록 연결하는 필드의 데이터 유형이 호환되고 일치하는 값이 포함되어 있는지 확인하십시오.

### 차원 만들기

차원은 분석 애플리케이션에서 데이터를 분류하고 그룹화하는 데 사용되는 필드입니다.

차원을 만들려면:

1. 왼쪽 패널의 차원 탭을 클릭하고 차원 생성을 클릭합니다.

   ![차원 만들기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-dimension.png)

2. 제품 이름과 같은 차원의 이름을 입력합니다.

3. Field 드롭다운 목록을 사용하여 `Product`와 같은 차원의 기준 필드를 선택합니다.또는 Fx 버튼을 클릭하여 전체 기능을 갖춘 식 편집기를 열 수 있습니다.표현식 작성에 대한 자세한 내용은 [표현식 작성](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/managing-semantic-models.htm#Expressions)을(를) 참조하십시오.

4. 선택 사항으로, 차원의 용도를 문서화하기 위한 설명을 입력하고 태그를 추가합니다.

5. 선택적으로, 용어집 용어 아래에서 용어집 용어 연결을 클릭하여 차원을 하나 이상의 용어집 용어에 연결할 수 있습니다.

   1. 목록에서 기존 용어를 선택하거나, 새 용어 만들기를 선택하여 차원에 연결될 새 용어를 추가합니다.

   2. 용어와 차원 간의 관계를 선택하십시오:

      * 정의: 용어에는 차원의 정의가 포함됩니다.단일 용어만 정의로 설정할 수 있습니다.

      * 관련: 이 용어는 차원과 관련이 있습니다.여러 용어를 관련 용어로 설정할 수 있습니다.

   3. 완료되면 선택을 클릭합니다.

   4. 더 추가를 클릭하여 필요에 따라 용어를 더 추가하세요.

6. 적용을 클릭합니다.

   ![새 차원 만들기 대화 상자](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-dimension_2.png)

차원이 의미 체계 모델에 추가되며 소비 애플리케이션에서 마스터 차원으로 표시됩니다.

### 측정값 만들기

측정값은 의미 체계 모델을 사용하는 애플리케이션에서 마스터 항목으로 표시되는 계산된 지표입니다.

측정값을 만들려면:

1. 왼쪽 패널의 측정값 탭을 클릭하고 측정값 만들기를 클릭합니다.

   ![측정값 만들기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-measure.png)

2. 총 매출과 같이 측정값의 이름을 입력합니다.

3. 집계 및 필드 드롭다운 목록을 사용하여 측정값의 기반이 되는 식의 매개변수(예: `Sum` 및 `Amount`)를 선택합니다.또는 Fx 버튼을 클릭하여 전체 기능을 갖춘 식 편집기를 열 수 있습니다.표현식 작성에 대한 자세한 내용은 [표현식 작성](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/managing-semantic-models.htm#Expressions)을(를) 참조하십시오.

4. 선택 사항으로, 측정값의 목적을 문서화하기 위한 설명을 입력하고 태그를 추가합니다.

5. 측정값의 숫자 서식에 대한 옵션을 선택하세요:

   * 자동
   * 숫자
   * Money
   * 날짜
   * 기간
   * 측정값 표현식:

   정보 메모사용자 지정 옵션을 사용할 수 없습니다.

6. 선택 사항으로, 용어집 용어 아래에서 용어집 용어 연결을 클릭하여 측정값을 하나 이상의 용어집 용어에 연결합니다.

   1. 목록에서 기존 용어를 선택하거나 새 용어 만들기를 선택하여 측정값에 연결될 새 용어를 추가하십시오.

   2. 용어와 측정값 간의 관계를 선택하십시오:

      * 정의: 용어에는 측정값의 정의가 포함됩니다.단일 용어만 정의로 설정할 수 있습니다.

      * 관련: 이 용어는 측정값과 관련이 있습니다.여러 용어를 관련 용어로 설정할 수 있습니다.

   3. 완료되면 선택을 클릭합니다.

   4. 더 추가를 클릭하여 필요에 따라 용어를 더 추가하세요.

7. 적용을 클릭합니다.

   ![새 측정값 만들기 대화 상자](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-create-measure_2.png)

측정값이 의미 체계 모델에 추가됩니다.애플리케이션이 의미 체계 모델을 사용할 때 측정값은 시각화에서 직접 사용할 수 있는 마스터 측정값으로 표시됩니다.

팁 메모분석 개발자가 목적을 쉽게 이해할 수 있도록 측정값에 선택 해제되고 설명적인 이름을 사용하세요.적절한 경우 "Average Order Value" 또는 "Total Sales Count"와 같이 이름에 집계 함수를 포함합니다.

### 표현식 작성

수식 편집기에서는 Qlik 분석 구문을 사용하여 사용자 지정 측정값 및 차원 수식을 작성할 수 있습니다.편집기 왼쪽 패널에서 필드와 함수를 사용할 수 있습니다.

![의미 체계 모델 편집 인터페이스의 식 편집기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-exp-editor.png)

식에서 필드 이름 사용 시 고려 사항

관계에 사용되는 필드를 참조할 때 식에서는 관계에 의해 정의된 새 필드 이름을 사용해야 합니다.예를 들어, 관계가 이름이 서로 다른 두 필드를 연결하는 경우 새 필드 이름에는 원래 필드 이름의 조합이 사용됩니다.예를 들어, Date 필드와 Order Date 필드 간의 관계는 새 필드 이름 OpenDate-Date(으)로 이어질 수 있습니다.

이러한 새 필드 이름은 표현식 편집기의 필드 섹션에 표시됩니다.의미 체계 모델 캔버스에서 필드를 클릭하여 새 필드 이름을 확인할 수도 있습니다.새 필드 이름은 Qlik 애플리케이션의 필드 이름으로 표시됩니다.

![의미 체계 모델에서 관계 기반 필드의 예상 필드 이름 확인](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Resources/Images/semantic-model-qlik-application-field-name.png)

## 의미 체계 모델 편집

의미 체계 모델을 편집하기 위한 다음 작업은 데이터 제품 활성화 전 또는 후에 수행할 수 있습니다.

* 왼쪽 패널의 테이블 탭을 사용하여 테이블을 추가합니다.
* 테이블을 선택한 후 오른쪽 패널에서 관계를 생성, 편집 또는 삭제할 수 있습니다.
* 왼쪽 패널의 차원 및 측정값 탭을 사용하여 차원과 측정값을 추가, 편집 또는 삭제합니다.
* 표현식 또는 설명을 업데이트합니다.

의미 체계 모델의 변경 사항은 다음 다시 로드 시 소비 애플리케이션에서 사용할 수 있게 됩니다.애플리케이션이 와일드카드 선택기와 함께 자동 포함 모드를 사용하는 경우 새 필드, 차원 및 측정값이 자동으로 포함됩니다.

## 표현식 유효성 검사 중

전체 식 편집기를 사용하여 측정값 및 차원을 만들거나 편집할 때, 올바른 구문을 사용하고 유효한 필드를 참조하는지 확인하기 위해 식의 유효성이 검사됩니다.

표현식에 오류가 있는 경우:

* 측정값 또는 차원에 경고 표시기가 표시되어 있습니다.
* 오류 메시지에는 "Field not found" 또는 "Invalid syntax"와 같이 문제가 설명되어 있습니다.
* 오류 위치에서 식이 강조 표시됩니다.

유효성 검사 오류를 해결하려면:

1. 오류 메시지를 검토하여 문제를 파악하십시오.
2. 문제를 해결하려면 식을 편집하십시오.
3. 함수 이름과 구문이 Qlik 표현식 구문 규칙을 팔로우하는지 확인하세요.
4. 식의 유효성을 다시 검사하려면 측정값 또는 차원을 저장하십시오.

정보 메모유효성 검사 오류가 있는 측정값 및 차원은 저장할 수 있지만, 이를 사용하는 애플리케이션에서 올바르게 작동하지 않을 수 있습니다.데이터 제품을 프로덕션 사용 사례에 사용할 수 있도록 설정하기 전에 모든 유효성 검사 오류를 해결하십시오.

## 데이터 제품 활성화

데이터 제품의 의미 체계 모델이 프로덕션 사용 사례에 사용할 준비가 되면 활성화할 수 있습니다.[데이터 마켓플레이스에 데이터 제품 활성화](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Marketplace/Consuming-in-data-marketplace.htm)을(를) 참조하십시오.