# 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/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/zh-TW/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/zh-TW/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/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | 指定在以 `environment_name` 指定的環境中使用資料產品的關鍵字。<br><br>若資料產品未位於環境中，則不需要。 |
| environment\_name | 包含您要載入的資料產品的環境名稱 (若適用)。<br><br>請遵循 [在指令碼中使用引號](https://help.qlik.com/zh-TW/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/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | 指定使用後續 `Table` 陳述式中所定義之資料表的關鍵字。 |
| [Table](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | 指定使用表格的關鍵字。每個 `Table` 陳述式載入一個資料表。 |
| table\_name | 指定要在資料模型中使用的表格名稱。<br><br>請遵循 [在指令碼中使用引號](https://help.qlik.com/zh-TW/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/zh-TW/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/zh-TW/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/zh-TW/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>DataFiles</span> 連線）內、位於名為 <span>Sales Analysis</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/zh-TW/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/zh-TW/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 – 載入特定資料表、度量與維度

[](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`

這兩個資料表及其關聯已載入。來自語意模型的每個特定度量和維度都會在應用程式中顯示為主要項目。

## 範例 3 – 載入特定資料表，以及所有量值與維度 (資料集位於環境中)

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

#### 載入指令碼

此範例會從位於包含在環境內之資料空間中的資料產品載入特定資料表及其語意模型關聯性 (請參閱 [同步與管理環境](https://help.qlik.com/zh-TW/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`

* 欄位：全部

* 量值和維度：全部

這兩個資料表及其關聯已載入。語意模型中的所有度量和維度都會在應用程式中顯示為主要項目。

## IncludeModel 指令碼限制

不支援 WithTables: \* 萬用字元語法。您必須明確列出資料表。

[資料產品中的語意模型](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[在應用程式中取用資料產品](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[資料目錄](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)