IncludeModel

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

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 ステートメントごとに 1 つのテーブルをロードします。
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 — トップレベルのストレージコンテナとしてスペースを持つ接続、またはロードするアプリケーションと同じ環境での接続に使用されます。これは、共有、管理、またはデータスペースに配置されている接続である可能性があります。たとえば、Qlik Cloud 内にローカルに保存され、Sales Analysis という名前のスペースにあるデータセット (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 つのテーブルは、リレーションシップと共にロードされます。セマンティックモデル内のすべてのメジャーと軸は、アプリケーションにマスターアイテムとして表示されます。

例 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

2 つのテーブルは、リレーションシップと共にロードされます。セマンティックモデルからの特定のメジャーと軸はそれぞれ、アプリケーションにマスターアイテムとして表示されます。

例 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 ステートメントの構成要素は次のとおりです。