アプリケーションでのデータ製品の利用

最終更新日時: 2026-11-11

アナリティクス開発者は、データカタログを使用して、セマンティックモデルを伴うデータ製品をアナリティクスアプリケーションにロードできます。データカタログは、必要なスクリプトを生成し、メジャーと軸のマスターアイテムを作成します。

以下のいずれかのサブスクリプションが必要です:

Qlik Talend Cloud Enterprise
Qlik Talend Cloud Premium
Qlik Cloud Analytics Premium
Qlik Cloud Analytics Enterprise
Qlik Sense Enterprise SaaS

データ製品を利用すると、データカタログは、選択したテーブル、リレーションシップ、メジャー、軸をアプリケーションにロードする IncludeModel スクリプトステートメントを生成します。セマンティックモデルからのメジャーと軸は、自動的にマスターアイテムとして表示され、ビジュアライゼーションですぐに使用できます。

前提条件

データ製品とそのセマンティックモデルを利用するには、以下が必要です。

権限

共有、管理、データスペースにあるデータ製品のセマンティックモデルを消費するには、データ製品を含むスペースでデータ消費可能または閲覧可能権限が必要です。

詳細については、「データ製品のロールと権限」を参照してください。

アクセス可能なデータセット

セマンティックモデルに含まれるデータセット、および基になるデータへの接続へのアクセス権が必要です。

固有のデータ製品名

データ製品はスペース内で一意の名前を持つ必要があります。アプリケーションがすでに同じ名前のデータ製品を含んでいる場合、セマンティックモデルのロードは失敗します。

データ製品を介して、データ製品およびセマンティックモデルを利用する

データ製品から直接、アナリティクスアプリケーションを作成できます。データ製品およびそのセマンティックモデルから、データセット、フィールド、マスターアイテムといった要素を選び、利用する対象を絞り込むことができます。

データマーケットプレイスから選択するか、カタログを参照して、データ製品を開きます。
データ製品名のヘッダーで、 [使用場所] > [アプリケーション] をクリックします。
新しいアプリケーションの作成ウィンドウで、セマンティックモデルとロードされるデータを確認します。
[Continue] (続行)をクリックします。
新しく作成されたアプリケーションのデータロードエディタが開かれ、データカタログに移動します。データ製品はデフォルトで選択されていますが、アプリケーションにロードする前に、参照したり、選択を絞り込んだり、データをレビューしたりできます。詳細については、「データ製品およびセマンティックモデルを介した利用データロードエディタ」を参照してください。
準備ができたら、 [データのロード] をクリックします。

データがロードされたら、シートの追加やアプリケーションでの作業を開始できます。または、データロードエディタに移動して、必要に応じてスクリプトを検査および変更できます。セマンティックモデルのテーブル、リレーションシップ、メジャー、軸が利用可能になりました。

シートでのデータの視覚化の詳細については、「分析の作成とデータの視覚化」を参照してください。

データ製品およびセマンティックモデルを介した利用データロードエディタ

データカタログは、スクリプトを手動で入力する代わりに、データ製品からデータとセマンティックモデルの情報を参照および選択するためのインターフェースを提供します。

データ製品とそのセマンティックモデルをロードするには:

アプリケーションを開きます。
上部のナビゲーションバーで [データロードエディター] をクリックします。
[データの追加] の右パネルで、[データカタログから追加] をクリックします。
データカタログモーダルが開き、セマンティックモデルを持つデータ製品を含む利用可能なデータが表示されます。

データ製品の閲覧

データカタログは、セマンティックモデルを含むデータ製品を表示します。名前、説明、またはタグでデータ製品を閲覧および検索できます。

データ製品をクリックすると、アプリケーションスクリプトにロードされる内容 (テーブル、メジャー、軸など) の概要が表示されます。

セマンティックモデル内のデータセットにアクセスできない場合、警告インジケーターでマークされます。セマンティックモデル内にある、それに関連するメジャーと軸は引き続き利用できますが、アクセスできないデータセットとそのフィールドは除外されます。

セマンティックモデルの選定と洗練

使用するデータ製品を選択した後、その選択内容をさらに絞り込み、セマンティックモデルのどの構成要素をアプリケーションに含めるかを正確に指定できます。

選択したデータ製品にマウスを重ねて、 [選択を絞り込む] をクリックします。
データ製品の要素をナビゲートできる 3 つの新しいタブを利用できます。
- テーブル/フィールド
- 軸
- メジャー
チェックボックスを使用して、選択を絞り込み、含めるデータセット、フィールド、メジャー、軸を選択します。

上級ユーザーは、 [リロード時に追加されたアイテムを自動的に含める] を切り替えることで、セマンティックモデルが変更されたときに新しいアイテムが自動的に含まれるかどうかを制御できます。

有効にすると、セマンティックモデルに追加された新しいフィールド、メジャー、軸は、リロード時にデータモデルとマスターアイテムに自動的に追加されます。これは、すべてのフィールド、メジャー、軸がそれぞれチェックされている場合にのみ適用されます。

選択の準備ができたら、 [スクリプトを挿入] をクリックします。

生成された IncludeModel スクリプトはロードスクリプトに挿入され、データロードエディタで表示および編集できます。アプリケーションにデータをロードするには、 [データのロード] をクリックします。

データがロードされた後、シートを追加してアプリケーションの作業を開始できます。詳細については、「分析の作成とデータの視覚化」を参照してください。

データロードエディターでの IncludeModel スクリプト

自動インクルードについて

自動インクルード機能は、セマンティックモデルが変更されたときにアプリケーションがどのように応答するかを制御します。

コンポーネントタイプに対して自動インクルードが有効になっている場合、生成されたスクリプトはワイルドカード (*) セレクターを使用します。

Fields *: 指定されたテーブルのすべてのフィールドが含まれます。
WithMeasures: *: すべてのメジャーをマスターアイテムとして含めます。
WithDimensions: *: すべての軸をマスターアイテムとして含めます。

WithTables: * ワイルドカード構文はサポートされていません。テーブルを明示的にリストする必要があります。

自動インクルードが無効になっている場合、スクリプトは選択されたアイテムを明示的にリストします。例:

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 アナリティクスパターンに従って関係を名前ベースの関連付けに変換するために、フィールド名とテーブル名が自動的に調整される場合があります。

リレーションシップのない同名フィールド: 2 つのテーブルに同名のフィールドが含まれていても、そのフィールド間にリレーションシップがない場合、アプリケーションでの意図しない自動関連付けを防ぐため、フィールド名はテーブル名で自動的に修飾されます (例: TableName.FieldName)。
関連を持つフィールド: 2 つのフィールド間に関連性があるものの名称が異なる場合、それらがアプリケーションに読み込まれて関連付けが形成される際、両者は同じ名称 (すなわち、その関連性の名称) へと変更されます。
複合キー: 複合キーの場合、新しいキー項目が関連するテーブルに追加されます。
同名テーブル: 2 つのテーブルが同じ名前を持つ場合、数値の接尾辞を付加することで自動的に名前が変更されます。たとえば TableName_1、TableName_2 などとなります。

継承されたマスターアイテムでの作業

IncludeModel ステートメントを含むアプリケーションをリロードすると、セマンティックモデルからのメジャーと軸がマスターアイテムパネルに自動的に表示されます。

セマンティックモデルからマスターアイテムを使用するには:

セマンティックモデルからデータをロードするには、アプリケーションをリロードしてください。
編集モードでシートを開きます。
左側のパネルで、 [マスターアイテム] をクリックします。
セマンティックモデルからのメジャーと軸は、データ製品インジケーターとともにリストに表示されます。
マスターメジャーまたは軸をビジュアライゼーションにドラッグして使用します。

セマンティックモデルから継承されたマスターアイテムには、そのソースデータ製品名と説明が表示されます。メジャーまたは軸にカーソルを合わせることで、使用されている式を表示できます。

マスターアイテムのプロパティ

セマンティックモデルから継承されたマスターアイテムのほとんどの属性は、コンシューミングアプリケーションでは読み取り専用です。その他のマスターアイテム属性 (ビジュアライゼーションに関連するものなど) は、アプリケーション内で引き続き編集できます。

読み取り専用の動作はユーザーインターフェイスにのみ適用されます—いくつかのマスターアイテムのプロパティを API を介して設定できます。

セマンティックモデルで構成可能だが、コンシューミングアプリケーションのユーザーインターフェイスでは読み取り専用のプロパティ。これにはタイトル、説明、タグが含まれます。
セマンティックモデルで構成されておらず、コンシューマーアプリケーションのユーザーインターフェイスで公開されていないプロパティ。

セマンティックモデルによって定義されたプロパティへの変更は、アプリケーションが再読み込みされると上書きされます。

マスターアイテムの削除

未公開のアプリケーションでは、継承されたマスターアイテムを削除できますが、IncludeModel スクリプトでまだ参照されている場合、次回のリロード時に再表示されます。完全に削除するには、最初にスクリプトから削除してください。継承されたマスターアイテムを複製することもできます。複製は通常のアプリケーションマスターアイテムであり、完全に編集可能です。

マスターアイテムと公開アプリケーション

アプリケーションが公開されると、その継承されたマスターアイテムは、アプリケーションが公開されたときに使用されたデータ製品のバージョンに固定されたままになります。公開済みアプリケーションをリロードしても、データ製品からマスターアイテムが作成、更新、または削除されることはありません。新しい、または変更されたメジャーと軸を使用するには、アプリケーションを更新して、再度公開します。

アプリケーションにおけるセマンティックモデルの更新への対処

セマンティックモデルを消費した後に変更があった場合、その変更を反映するようにアプリケーションを更新できます。

ワイルドカードセレクターで自動インクルードモードを使用した場合、新しいメジャーと軸は自動的に含まれます。明示的な選択を使用した場合は、最初に選択したアイテムのみがロードされます。

セマンティックモデルから新しいアイテムを追加するには:

データロードエディタを開きます。
スクリプト内で IncludeModel ステートメントを見つけます。
新しいアイテムを追加するか、セレクターを * に変更して、自動インクルードするようにステートメントを編集します。
アプリケーションをリロードします。

別の方法として、既存の IncludeModel ステートメントを削除し、データカタログを使用して、更新された選択肢で新しいものを生成できます。

他のツールでデータ製品を利用する

スクリプトでは、データ製品を消費することは可能ですが、メジャーと軸は無視されます。

アプリケーションやスクリプト以外のアセット (データフローやテーブルレシピなど) でデータ製品を利用する場合、そのデータ製品は、選択可能な信頼できるデータセットの集合として機能します。これらのツールはデータセットをソースとして使用し、データ製品は系列ではソースノードとして表示されません。

IncludeModel

データ製品の使用

データ製品におけるセマンティックモデルの管理

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください

アプリケーションでのデータ製品の利用

前提条件

権限

アクセス可能なデータセット

固有のデータ製品名

データ製品を介して、データ製品およびセマンティック モデルを利用する

データ製品およびセマンティック モデルを介した利用データ ロード エディタ