# 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/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/ja-JP/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/ja-JP/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/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | `environment_name` で指定された環境でデータ製品を使用することを指定するキーワード。<br><br>データ製品が環境に配置されていない場合は必要ありません。 |
| environment\_name | ロードするデータ製品が含まれる環境の名前 (該当する場合)。<br><br>[スクリプトでの引用符の使用](https://help.qlik.com/ja-JP/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/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | 後続の `Table` ステートメントで定義されたテーブルを使用することを指定するキーワード。 |
| [Table](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | テーブルの使用を指定するキーワード。`Table` ステートメントごとに 1 つのテーブルをロードします。 |
| table\_name | データ モデルで使用するテーブルの名前を指定します。<br><br>[スクリプトでの引用符の使用](https://help.qlik.com/ja-JP/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/ja-JP/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/ja-JP/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/ja-JP/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>Qlik Cloud</span> 内にローカルに保存され、<span>Sales Analysis</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/ja-JP/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/ja-JP/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 つのテーブルは、リレーションシップと共にロードされます。セマンティック モデル内のすべてのメジャーと軸は、アプリケーションにマスター アイテムとして表示されます。

## 例 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`

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

## 例 3 – 特定のテーブルと、すべてのメジャーおよび軸をロードする (データセットは環境にあります)

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

#### ロード スクリプト

この例では、環境内に含まれるデータ スペース内にあるデータ製品から、特定のテーブルとそれらのセマンティック モデルの関係をロードします (参照: [環境の同期と管理](https://help.qlik.com/ja-JP/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`

* フィールド: すべて

* メジャーおよび軸: すべて

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

## IncludeModel スクリプトの制限事項

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

[データ製品におけるセマンティック モデル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[アプリケーションでのデータ製品の利用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[データ カタログ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)