# IncludeModel

IncludeModel 문은 테이블, 관계, 측정값 및 차원을 포함한 데이터 제품과 해당 의미 체계 모델을 로드합니다.의미 체계 모델의 측정값과 차원이 애플리케이션에 자동으로 마스터 항목으로 표시됩니다.

IncludeModel data\_product\_name [InEnvironment environment\_name] [FromSpace data\_product\_space | FromCurrentSpace | FromPersonalSpace] [WithTables Table table\_name1 Fields fieldlist Connection dataset\_connection {, Table table\_nameN Fields fieldlist Connection dataset\_connection,... }] [WithMeasures measurelist] [WithDimensions dimensionlist]

인수 및 키워드

| 인수 또는 키워드 | 설명 |
| --- | --- |
| data\_product\_name | 로드할 데이터 제품의 이름입니다. |
| [FromSpace](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | 데이터 제품을 로드할 공간을 지정하는 키워드입니다.<br><br>필요에 따라 다음 중 하나를 사용하십시오.이러한 키워드 옵션이 모두 생략되면 IncludeModel 문은 개인 공간에서 데이터 제품을 찾습니다.<br><br><ul> <li> <p><span>FromSpace</span>: <code>data_product_space</code>(으)로 지정된 스페이스에 있는 데이터 제품을 로드합니다.</p> </li> <li> <p><span>FromCurrentSpace</span>: 현재 스페이스에 있는 데이터 제품을 로드합니다.</p> </li> <li> <p><span>FromPersonalSpace</span>: 개인 공간에 있는 데이터 제품을 로드합니다.</p> </li> </ul> |
| data\_product\_space | FromSpace을(를) 사용하여 로드할 특정 스페이스를 명시적으로 지정하는 경우, 로드하려는 데이터 제품의 스페이스를 지정합니다.FromPersonalSpace 또는 FromCurrentSpace을(를) 사용하는 경우에는 적용되지 않습니다.<br><br>[스크립트에서 따옴표 사용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm)에 설명된 인용 규칙을 따르십시오.예:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | `environment_name`(으)로 지정된 환경에서 데이터 제품을 사용하도록 지정하는 키워드입니다.<br><br>데이터 제품이 환경에 위치하지 않는 경우 필요하지 않습니다. |
| environment\_name | 해당하는 경우, 로드하려는 데이터 제품이 포함된 환경의 이름입니다.<br><br>[스크립트에서 따옴표 사용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm)에 설명된 인용 규칙을 따르십시오.예:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | 후속 `Table` 문에 정의된 테이블을 사용하도록 지정하는 키워드입니다. |
| [Table](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | 테이블 사용을 지정하는 키워드입니다.`Table` 문당 하나의 테이블을 로드합니다. |
| table\_name | 데이터 모델에서 사용할 테이블의 이름을 지정합니다.<br><br>[스크립트에서 따옴표 사용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm)에 설명된 인용 규칙을 따르십시오.예:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | 테이블에서 지정된 필드(fieldlist)를 사용하여 데이터 모델에 통합하도록 지시하는 키워드입니다. |
| fieldlist | 이전 `Table` 문에서 참조된 테이블의 필드 목록입니다.<br><br>테이블의 모든 필드를 사용하려면 `*`을(를) 사용하거나, 특정 필드를 쉼표로 구분한 목록으로 제공할 수 있습니다.<br><br>예:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | `dataset_connection`에 지정된 데이터 세트를 사용하도록 지정하는 키워드입니다. |
| dataset\_connection | 참조된 테이블을 포함하는 데이터 세트를 로드할 수 있는 연결입니다.<br><br>연결 위치에 따라 다음 형식 중 하나를 사용하십시오:<br><br><ul> <li> <p><span>environment:space:connection</span> — 환경(<span>Qlik Cloud</span>와(과) <span>Qlik Talend Cloud</span> 간에 동기화되는 데이터 컨테이너) 내에 위치한 파일에 사용됩니다.환경은 공간(특히 <span>데이터 공간</span>)과 연결됩니다.</p> <p>환경에 대한 자세한 내용은 <a href="https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">환경 동기화 및 관리</a>을(를) 참조하세요.</p> </li> <li> <p><span>space:connection</span> — 스페이스를 최상위 스토리지 컨테이너로 사용하거나 로드 애플리케이션과 동일한 환경에 있는 연결에 사용됩니다.이는 <span>공유</span>, <span>관리</span> 또는 데이터 스페이스에 있는 연결일 수 있습니다.</p> <p>예를 들어, <span>Sales Analysis</span>(이)라는 이름의 스페이스에 위치하며 <span>Qlik Cloud</span>(<span>DataFiles</span> 연결) 내에 로컬로 저장된 데이터 세트의 경우 다음을 사용합니다: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — 연결 이름만.이는 사용자의 <span>개인 공간</span>에 있는 연결을 의미합니다.이 경우 연결은 단순히 다음과 같습니다: <span>DataFiles</span></p> </li> </ul><br><br>예:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | 데이터 프로덕트(measurelist)에서 지정된 측정값을 마스터 측정값으로 변환하도록 지시하는 키워드입니다. |
| measurelist | 마스터 측정값으로 변환할 데이터 제품 의미 체계 모델의 측정값 목록입니다.<br><br>`*`을(를) 사용하여 모든 측정값을 변환하거나, 쉼표로 구분된 특정 측정값 목록을 제공할 수 있습니다.<br><br>예:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | 데이터 제품(dimensionlist)의 지정된 차원을 마스터 차원으로 변환하도록 지시하는 키워드입니다. |
| dimensionlist | 마스터 차원으로 변환할 데이터 제품 의미 체계 모델의 차원 목록입니다.<br><br>`*`을(를) 사용하여 모든 차원을 변환하거나, 쉼표로 구분된 특정 차원 목록을 제공할 수 있습니다.<br><br>예:<br><br>`[Product Name], [Region], [Customer]` |

## 설명

IncludeModel 문은 일반적으로 데이터 제품을 해당 의미 체계 모델과 함께 로드하도록 선택할 때 데이터 카탈로그에서 자동으로 생성됩니다.또한 문을 직접 작성하거나 생성된 문을 편집하여 포함할 필드, 측정값 및 차원을 사용자 지정할 수 있습니다.

의미 체계 모델에 정의된 관계는 로드된 테이블에 자동으로 적용되어 데이터 모델에 연결을 만듭니다.

측정값 및 차원에 대한 작업은 테이블과 필드가 로드된 후 데이터 로드 종료 시 적용됩니다.해당 단계 이전에 로드가 실패하면 측정값 또는 차원 작업이 적용되지 않습니다.

정보 메모IncludeModel 문을 사용하려면 데이터 제품이 포함된 스페이스에서 데이터 소비 가능 또는 보기 가능 권한이 있어야 합니다.

### 마스터 항목 속성

시맨틱 모델에서 상속된 마스터 항목의 속성 대부분은 소비 애플리케이션에서 읽기 전용입니다.시각화와 관련된 속성과 같은 일부 다른 마스터 항목 속성은 애플리케이션 내에서 여전히 편집할 수 있습니다.

읽기 전용 동작은 사용자 인터페이스에만 적용됩니다—API를 통해 여러 마스터 항목 속성을 설정할 수 있습니다:

* 의미 체계 모델에서 구성할 수 있지만 소비 애플리케이션의 사용자 인터페이스에서는 읽기 전용인 속성입니다.여기에는 제목, 설명 및 태그가 포함됩니다.

* 의미 체계 모델에서 구성되지 않고 사용하는 애플리케이션의 사용자 인터페이스에 노출되지 않는 속성입니다.

의미 체계 모델에 정의된 속성의 변경 사항은 애플리케이션이 다시 로드될 때 덮어써집니다.

### 마스터 항목 삭제

게시되지 않은 응용 프로그램에서 상속된 마스터 항목을 삭제할 수 있지만, IncludeModel 스크립트에서 여전히 참조되는 경우 다음 다시 로드 시 다시 나타납니다.영구적으로 제거하려면 먼저 스크립트에서 제거하세요.상속된 마스터 항목을 복제할 수도 있습니다.복제는 일반적인 애플리케이션 마스터 항목이며 완전히 편집할 수 있습니다.

## 예제 1 – 모든 측정값 및 차원과 함께 특정 테이블 로드

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### 스크립트 불러오기

이 예제에서는 데이터 제품 및 해당 의미 체계 모델에서 특정 테이블과 해당 관계를 로드합니다.또한 특정 테이블에서 모든 필드를 로드하기 위해 와일드카드(\*)를 사용하며, 의미 체계 모델의 모든 측정값과 차원은 애플리케이션에서 마스터 항목으로 정의되어야 합니다.

```
IncludeModel [Sales Performance Data] FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;
```

이 IncludeModel 문의 구성 요소는 다음과 같습니다.

* 데이터 제품 이름: `Sales Performance Data`

* 데이터 제품 스페이스: `Sales Analysis Space`

* 테이블: `Transactions` 및 `Products`

* 필드: 모두

* 측정값 및 차원: 모두

두 테이블이 관계와 함께 로드됩니다.의미 체계 모델의 모든 측정값과 차원이 애플리케이션에 마스터 항목으로 표시됩니다.

## 예제 2 – 특정 테이블, 측정값 및 차원 로드

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### 스크립트 불러오기

이 예제에서는 데이터 제품 및 해당 의미 체계 모델에서 특정 테이블과 해당 관계를 로드합니다.특정 테이블에서 모든 필드를 로드하기 위해 와일드카드(\*)를 사용합니다.모든 측정값과 차원을 마스터 항목으로 자동 정의하는 대신, 특정 측정값과 차원을 마스터 항목으로 정의합니다.

```
IncludeModel [Customer Analytics] FromSpace [sales]
WithTables 
    Table [Customers] Fields * Connection [sales:DataFiles],
    Table [Orders] Fields * Connection [sales:DataFiles]
WithMeasures [Total Revenue], [Customer Count]
WithDimensions [Customer Name];
```

이 IncludeModel 문의 구성 요소는 다음과 같습니다.

* 데이터 제품 이름: `Customer Analytics`

* 데이터 제품 스페이스: `sales`

* 테이블: `Customers` 및 `Orders`

* 필드: 모두

* 측정값: `Total Revenue` 및 `Customer Count`

* 크기: `Customer Name`

두 테이블이 관계와 함께 로드됩니다.의미 체계 모델의 각 특정 측정값과 차원이 애플리케이션에 마스터 항목으로 표시됩니다.

## 예제 3 – 모든 측정값 및 차원과 함께 특정 테이블 로드(환경에 있는 데이터 세트)

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### 스크립트 불러오기

이 예제에서는 환경 내에 포함된 데이터 공간에 위치한 데이터 제품에서 특정 테이블과 해당 의미 체계 모델 관계를 로드합니다([환경 동기화 및 관리](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm) 참조).또한 특정 테이블에서 모든 필드를 로드하기 위해 와일드카드(\*)를 사용하며, 의미 체계 모델의 모든 측정값과 차원은 애플리케이션에서 마스터 항목으로 정의되어야 합니다.

```
IncludeModel [Sales Performance Data]
    InEnvironment 'Production'
    FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;
```

이 IncludeModel 문의 구성 요소는 다음과 같습니다.

* 데이터 제품 이름: `Sales Performance Data`

* 데이터 제품 환경: `Production`

* 데이터 제품 스페이스: `Sales Analysis Space`

* 테이블: `Transactions` 및 `Products`

* 필드: 모두

* 측정값 및 차원: 모두

두 테이블이 관계와 함께 로드됩니다.의미 체계 모델의 모든 측정값과 차원이 애플리케이션에 마스터 항목으로 표시됩니다.

## IncludeModel 스크립트 제한 사항

WithTables: \* 와일드카드 구문은 지원되지 않습니다.테이블을 명시적으로 나열해야 합니다.

[데이터 제품의 시맨틱 모델](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[애플리케이션에서 데이터 제품 사용하기](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[데이터 카탈로그](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)