애플리케이션에서 데이터 제품 사용하기
마지막 업데이트: 2026-11-03분석(Analytics) 개발자는 데이터 카탈로그를 사용하여 시맨틱 모델이 포함된 데이터 제품을 분석 응용 프로그램에 로드할 수 있습니다.데이터 카탈로그는 필요한 스크립트를 생성하고 측도 및 차원에 대한 마스터 아이템을 생성합니다.
- Qlik Talend Cloud 엔터프라이즈
- Qlik Talend Cloud 프리미엄
- Qlik Cloud Analytics 프리미엄
- Qlik Cloud Analytics 엔터프라이즈
- Qlik Sense Enterprise SaaS
데이터 제품을 사용할 때 데이터 카탈로그는 선택한 테이블, 관계, 측정값 및 차원을 애플리케이션에 로드하는 IncludeModel 스크립트 문을 생성합니다.의미 체계 모델의 측정값과 차원이 자동으로 마스터 항목으로 표시되어 시각화에 바로 사용할 수 있습니다.
전제 조건
데이터 제품 및 해당 의미 체계 모델을 사용하려면 다음이 필요합니다:
권한
공유, 관리 및 데이터 공간에서 데이터 제품의 의미 체계 모델을 사용하려면 데이터 제품이 포함된 공간에서 데이터를 사용할 수 있음 또는 볼 수 있음 권한이 필요합니다.
자세한 내용은 데이터 제품 역할 및 권한을(를) 참조하십시오.
액세스 가능한 데이터 세트
의미 체계 모델에 포함된 데이터 세트뿐만 아니라 기본 데이터에 대한 연결에 대한 액세스 권한이 있어야 합니다.
고유한 데이터 제품 이름
데이터 제품은 스페이스 내에서 고유한 이름을 가져야 합니다.애플리케이션에 동일한 이름의 데이터 제품이 이미 포함되어 있는 경우 의미 체계 모델 로드에 실패합니다.
데이터 제품을 통해 데이터 제품 및 의미 체계 모델 사용
데이터 제품에서 직접 분석 애플리케이션을 만들 수 있습니다.데이터 제품 및 해당 의미 체계 모델에서 사용할 항목을 세분화할 수 있습니다: 데이터 세트, 필드 및 마스터 항목.
-
데이터 마켓플레이스에서 선택하거나 카탈로그를 탐색하여 데이터 제품을 엽니다.
- 데이터 제품 이름 헤더에서 다음에서 사용 > 애플리케이션을 클릭합니다.

- 새 애플리케이션 만들기 창에서 의미 체계 모델과 로드될 데이터를 검토합니다.
- 계속을 클릭합니다.
새로 생성된 애플리케이션의 데이터 로드 편집기이 열리고, 데이터 카탈로그로 이동합니다.데이터 제품이 기본으로 선택되어 있지만, 애플리케이션에 로드하기 전에 탐색하고 선택 항목을 구체화하며 데이터를 검토할 수 있습니다.자세한 내용은 데이터 로드 편집기을(를) 통해 데이터 제품 및 의미 체계 모델 사용을(를) 참조하십시오.
-
준비가 되면 데이터 로드를 클릭합니다.
데이터가 로드된 후 시트 추가를 시작하고 애플리케이션 작업을 진행하거나, 필요한 경우 데이터 로드 편집기(으)로 이동하여 스크립트를 검사하고 수정할 수 있습니다.이제 의미 체계 모델의 테이블, 관계, 측정값 및 차원을 사용할 수 있습니다.
시트의 데이터 시각화에 대한 자세한 내용은 분석 생성 및 데이터 시각화을(를) 참조하세요.
데이터 로드 편집기을(를) 통해 데이터 제품 및 의미 체계 모델 사용
데이터 카탈로그는 스크립트를 수동으로 입력하는 대신 데이터 제품에서 데이터 및 의미 체계 모델 정보를 찾아보고 선택할 수 있는 인터페이스를 제공합니다.
데이터 제품 및 해당 의미 체계 모델을 로드하려면:
- 응용 프로그램을 엽니다.
- 상단 탐색 막대에서 데이터 로드 편집기를 클릭합니다.
- 데이터 추가 오른쪽 패널에서 데이터 카탈로그에서 추가를 클릭합니다.
- 데이터 카탈로그 모달이 열리고, 시맨틱 모델이 있는 데이터 제품을 포함하여 사용 가능한 데이터가 표시됩니다.

데이터 제품 탐색
데이터 카탈로그는 시맨틱 모델을 포함하는 데이터 제품을 표시합니다.이름, 설명 또는 태그를 기준으로 데이터 제품을 탐색하고 검색할 수 있습니다.
데이터 제품을 클릭하여 테이블, 측정값 및 차원을 포함하여 애플리케이션 스크립트에 로드될 항목의 요약을 확인하십시오.
의미 체계 모델의 데이터 세트에 액세스할 수 없는 경우 경고 표시기가 표시됩니다.의미 체계 모델에 있는 이와 관련된 측정값 및 차원은 계속 사용할 수 있지만, 액세스할 수 없는 데이터 세트 및 해당 필드는 제외됩니다.
의미 체계 모델 선택 및 구체화
사용할 데이터 제품을 선택한 후, 선택 항목을 구체화하고 애플리케이션에 포함할 의미 체계 모델의 구성 요소를 정확하게 선택할 수 있습니다.
- 선택한 데이터 제품 위에 마우스를 올리고 선택 세분화를 클릭합니다.

데이터 제품의 요소를 탐색할 수 있는 세 개의 새 탭이 제공됩니다:
- 테이블/필드
- 차원
- 측정값
- 체크박스를 사용하여 선택 항목을 세분화하고 포함할 데이터 세트, 필드, 측정값 및 차원을 선택합니다.
- 선택이 완료되면 스크립트 삽입을 클릭합니다.
고급 사용자는 다시 로드 시 추가된 항목 자동 포함을 토글하여 의미 체계 모델이 변경될 때 새 항목이 자동으로 포함되는지 여부를 제어할 수 있습니다.
활성화하면 의미 체계 모델에 추가된 새 필드, 측정값 및 차원이 다시 로드 시 데이터 모델 및 마스터 항목에 자동으로 추가됩니다.이는 모든 필드, 측정값 및 차원이 각각 선택된 경우에만 적용됩니다.
생성된 IncludeModel 스크립트는 로드 스크립트에 삽입되며 데이터 로드 편집기에서 보고 편집할 수 있습니다.데이터를 애플리케이션에 로드하려면 데이터 로드를 클릭합니다.
데이터가 로드된 후 시트를 추가하고 애플리케이션 작업을 시작할 수 있습니다. 자세한 내용은 분석 생성 및 데이터 시각화를 참조하십시오.
자동 포함 이해하기
자동 포함 기능은 의미 체계 모델이 변경될 때 애플리케이션이 응답하는 방식을 제어합니다.
컴포넌트 유형에 자동 포함이 활성화된 경우 생성된 스크립트는 와일드카드(*) 선택기를 사용합니다:
- Fields *: 지정된 테이블의 모든 필드를 포함합니다.
- WithMeasures: *: 모든 측정값을 마스터 항목으로 포함합니다.
- WithDimensions: *: 모든 차원을 마스터 항목으로 포함합니다.
자동 포함이 비활성화되면 스크립트는 선택한 항목을 명시적으로 나열합니다.예:
- WithMeasures [Total sales], [Total quantity]: 지정된 측정값만 포함합니다.
- WithDimensions [Region], [Product]: 지정된 차원만 포함합니다.
유지 관리를 줄이고 애플리케이션이 의미 체계 모델의 개선 사항을 활용할 수 있도록 고급 사용자에게는 자동 포함을 권장합니다.포함할 항목을 엄격하게 제어해야 하는 경우 자동 포함을 비활성화하세요.
생성된 IncludeModel 스크립트 이해하기
데이터는 의미 체계 모델을 참조하고 로드할 구성 요소를 지정하는 IncludeModel 스크립트 문을 생성합니다.
스크립트 예
IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;스크립트 매개변수:
- IncludeModel: 의미 체계 모델을 포함하는 데이터 제품의 이름입니다.
- FromSpace: 데이터 제품이 포함된 공간을 지정합니다.
- WithTables: 포함할 테이블을 지정합니다.
- Table: 포함할 테이블을 지정합니다.사용하려는 각 테이블에 대해 쉼표로 구분하여 Table 문을 포함할 수 있습니다.
- Fields: 지정된 테이블에서 포함할 필드를 지정합니다.모든 필드에 *을(를) 사용하거나 쉼표로 구분된 필드 목록을 사용하세요.
- Connection: environment:space:connection, space:connection 또는 connection 형식을 사용하여 테이블 위치를 지정합니다.
- WithMeasures: 마스터 측정값으로 포함할 측정값을 지정합니다.모든 측정값 또는 특정 측정값 이름 목록에 *을(를) 사용합니다.
- WithDimensions: 마스터 차원으로 포함할 차원을 지정합니다.모든 차원 또는 특정 차원 이름 목록에는 *을(를) 사용합니다.
IncludeModel 문을 수동으로 편집하여 포함할 항목을 조정하거나 와일드카드 및 명시적 선택 모드 간을 전환할 수 있습니다.
IncludeModel 문에 대한 자세한 내용은 IncludeModel을(를) 참조하십시오.
필드 및 테이블 명명
데이터 프로덕트가 애플리케이션에 로드될 때 이름 충돌을 방지하고 Qlik 분석 패턴에 따라 관계를 이름 기반 연관으로 변환하기 위해 필드 및 테이블 이름이 자동으로 조정될 수 있습니다.
- 관계가 없는 동일한 이름의 필드: 두 테이블에 이름이 동일한 필드가 포함되어 있지만 해당 필드 간에 관계가 없는 경우, 애플리케이션에서 의도하지 않은 자동 연결이 생성되는 것을 방지하기 위해 필드 이름이 해당 테이블 이름으로 자동 한정됩니다(예: TableName.FieldName).
- 관계가 있는 필드: 두 필드 간에 관계가 있지만 이름이 서로 다른 경우, 연관을 형성하기 위해 애플리케이션에 로드될 때 동일한 이름, 즉 관계의 이름으로 변경됩니다.
-
복합 키: 복합 키의 경우, 관련된 테이블에 새 키 필드가 추가됩니다.
- 동일한 이름의 테이블: 두 테이블의 이름이 동일한 경우, 예를 들어 TableName_1, TableName_2 등과 같이 숫자 접미사를 추가하여 자동으로 이름이 변경됩니다.
상속된 마스터 항목을 사용하여 작업
IncludeModel 문이 포함된 애플리케이션을 다시 로드하면 의미 체계 모델의 측정값 및 차원이 마스터 항목 패널에 자동으로 표시됩니다.
의미 체계 모델의 마스터 항목을 사용하려면:
- 의미 체계 모델에서 데이터를 로드하려면 애플리케이션을 다시 로드하세요.
- 편집 모드에서 시트를 엽니다.
- 왼쪽 패널에서 마스터 항목을 클릭합니다.
- 의미 체계 모델의 측정값과 차원이 데이터 제품 표시기와 함께 목록에 표시됩니다.

- 마스터 측정값 또는 차원을 시각화로 드래그하여 사용합니다.
시맨틱 모델에서 상속된 마스터 항목은 해당 소스 데이터 제품 이름 및 설명을 표시합니다.측정값 또는 차원 위에 마우스 포인터를 올리면 사용된 표현식을 확인할 수 있습니다.
마스터 항목 속성
시맨틱 모델에서 상속된 마스터 항목의 속성 대부분은 소비 애플리케이션에서 읽기 전용입니다.시각화와 관련된 속성과 같은 일부 다른 마스터 항목 속성은 애플리케이션 내에서 여전히 편집할 수 있습니다.
읽기 전용 동작은 사용자 인터페이스에만 적용됩니다—API를 통해 여러 마스터 항목 속성을 설정할 수 있습니다:
-
의미 체계 모델에서 구성할 수 있지만 소비 애플리케이션의 사용자 인터페이스에서는 읽기 전용인 속성입니다.여기에는 제목, 설명 및 태그가 포함됩니다.
-
의미 체계 모델에서 구성되지 않고 사용하는 애플리케이션의 사용자 인터페이스에 노출되지 않는 속성입니다.
의미 체계 모델에 정의된 속성의 변경 사항은 애플리케이션이 다시 로드될 때 덮어써집니다.
마스터 항목 삭제
게시되지 않은 응용 프로그램에서 상속된 마스터 항목을 삭제할 수 있지만, IncludeModel 스크립트에서 여전히 참조되는 경우 다음 다시 로드 시 다시 나타납니다.영구적으로 제거하려면 먼저 스크립트에서 제거하세요.상속된 마스터 항목을 복제할 수도 있습니다.복제는 일반적인 애플리케이션 마스터 항목이며 완전히 편집할 수 있습니다.
마스터 항목 및 앱 게시
애플리케이션이 게시되면 상속된 마스터 항목은 애플리케이션이 게시되었을 때 사용된 데이터 제품의 버전에 고정된 상태로 유지됩니다.게시된 애플리케이션을 다시 로드해도 데이터 제품의 마스터 항목이 생성, 업데이트 또는 삭제되지 않습니다.새롭거나 변경된 측정값 및 차원을 사용하려면 애플리케이션을 업데이트하고 다시 게시하십시오.
애플리케이션에서 의미 체계 모델 업데이트 처리하기
의미 체계 모델을 사용한 후에 해당 모델이 변경되면 변경 사항을 반영하도록 애플리케이션을 업데이트할 수 있습니다.
와일드카드 선택기와 함께 자동 포함 모드를 사용한 경우 새 측정값과 차원이 자동으로 포함됩니다.명시적 선택을 사용한 경우 원래 선택한 항목만 로드됩니다.
의미 체계 모델에서 새 항목을 추가하려면:
- 데이터 로드 편집기를 엽니다.
- 스크립트에서 IncludeModel 문을 찾으십시오.
- 새 항목을 추가하도록 구문을 편집하거나 자동 포함을 위해 선택기를
*(으)로 변경하십시오. - 응용 프로그램을 다시 로드합니다.
또는 기존 IncludeModel 문을 제거하고 데이터 카탈로그를 사용하여 업데이트된 선택 항목이 포함된 새 문을 생성할 수 있습니다.
다른 도구에서 데이터 제품 소비하기
스크립트에서는 데이터 프로덕트를 소비할 수 있지만 측정값과 차원은 무시됩니다.
애플리케이션 및 스크립트 이외의 자산(예: 데이터 플로우 및 테이블 레시피)에서 데이터 제품을 소비할 때, 데이터 제품은 선택할 수 있는 신뢰할 수 있는 데이터 세트 모음 역할을 합니다.이러한 도구는 데이터 세트를 소스로 사용하며 데이터 제품은 계보에 소스 노드로 표시되지 않습니다.