IncludeModel

上次更新：2026-11-03

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 陳述式載入一個資料表。
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 本機（DataFiles 連線）內、位於名為 Sales Analysis 的空間中的資料集，您會使用以下內容：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 – 載入特定資料表、度量與維度

此範例會從資料產品及其語意模型載入特定資料表及其關聯性。它使用萬用字元 (*) 來載入特定資料表的所有欄位。特定的度量和維度會定義為主要項目，而非自動將所有度量和維度定義為主要項目。

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 – 載入特定資料表，以及所有量值與維度 (資料集位於環境中)

此範例會從位於包含在環境內之資料空間中的資料產品載入特定資料表及其語意模型關聯性 (請參閱 同步與管理環境)。它還使用萬用字元 (*) 從特定資料表中載入所有欄位，且語意模型中的所有度量與維度都將在應用程式中定義為主項目。

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: * 萬用字元語法。您必須明確列出資料表。

資料產品中的語意模型

在應用程式中取用資料產品

資料目錄

此頁面是否對您有幫助？

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們！

在此留下意見回饋