IncludeModel

마지막 업데이트: 2026-11-10

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

설명

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

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

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

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

마스터 항목 속성

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

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

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

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

마스터 항목 삭제

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

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

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

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 – 특정 테이블, 측정값 및 차원 로드

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

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 – 모든 측정값 및 차원과 함께 특정 테이블 로드(환경에 있는 데이터 세트)

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

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: * 와일드카드 구문은 지원되지 않습니다.테이블을 명시적으로 나열해야 합니다.

데이터 제품의 시맨틱 모델

애플리케이션에서 데이터 제품 사용하기

데이터 카탈로그

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.