IncludeModel

Son güncelleme: 2026-11-03

IncludeModel ifadesi, tablolar, ilişkiler, ölçüler ve boyutlar dahil olmak üzere bir veri ürününü ve semantik modelini yükler. Semantik modeldeki hesaplamalar ve boyutlar uygulamada otomatik olarak ana öğeler olarak görünür.

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]

Argümanlar ve anahtar kelimeler
Argüman veya anahtar kelime	Açıklama
data_product_name	Yüklenecek veri ürününün adı.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Veri ürününün yükleneceği alanı belirten anahtar kelimeler. Gerektiğinde aşağıdakilerden birini kullanın. Bu anahtar sözcük seçeneklerinin tümü atlanırsa, IncludeModel deyimi veri ürününü kişisel alanınızda arar. FromSpace: data_product_space ile belirtilen alanda bulunan veri ürününü yükleyin. FromCurrentSpace: Geçerli alanda bulunan veri ürününü yükleyin. FromPersonalSpace: Kişisel alanınızda bulunan veri ürününü yükleyin.
data_product_space	Yükleme yapılacak belirli bir alanı açıkça belirtmek için FromSpace kullanıyorsanız, yüklemek istediğiniz veri ürününün alanını belirtir. FromPersonalSpace veya FromCurrentSpace kullanıyorsanız bu geçerli değildir. Komut dosyasında tırnak işaretlerinin kullanımı adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Veri ürününün environment_name ile belirtilen ortamda kullanılmasını belirten anahtar kelime. Veri ürünü bir ortamda bulunmuyorsa gerekli değildir.
environment_name	Varsa, yüklemek istediğiniz veri ürününü içeren ortamın adı. Komut dosyasında tırnak işaretlerinin kullanımı adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler: Production [Production Environment] "Production Environment"
WithTables	Sonraki Table deyimlerinde tanımlanan tabloların kullanılmasını belirten anahtar sözcük.
Table	Bir tablonun kullanımını belirten anahtar sözcük. Table ifadesi başına bir tablo yükler.
table_name	Veri modelinde kullanılacak tablonun adını belirtir. Komut dosyasında tırnak işaretlerinin kullanımı adresinde belgelenen tırnak içine alma kurallarına uyun. Örnekler: MyDataTable [My Data Table] "My Data Table"
Fields	Tablodaki belirtilen alanların (fieldlist) veri modeline entegre edilmesi amacıyla kullanılmasını belirten anahtar kelime.
fieldlist	Önceki Table ifadesinde başvurulan tablodaki alanların listesi. Tablodaki tüm alanları kullanmak için * kullanabilir veya belirli alanların virgülle ayrılmış bir listesini sağlayabilirsiniz. Örnekler: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	dataset_connection içinde belirtilen veri kümesinin kullanılacağını belirten anahtar sözcük.
dataset_connection	Başvurulan tabloyu içeren veri kümesini yükleyebilen bir Bağlantı. Bağlantının konumuna bağlı olarak aşağıdaki biçimlerden birini kullanın: environment:space:connection — Ortamlar (Qlik Cloud ve Qlik Talend Cloud arasında senkronize edilen veriler için kapsayıcılar) içinde bulunan dosyalar için kullanılır. Ortamlar, alanlarla (özellikle veri alanları ile) ilişkilendirilir. Ortamlar hakkında daha fazla bilgi için bkz. Ortamları senkronize etme ve yönetme. space:connection — En üst düzey depolama kapsayıcısı bir alan olan veya yükleme uygulamasıyla aynı ortamda bulunan bağlantılar için kullanılır. Bu, paylaşılan, yönetilen veya veri alanlarında bulunan bağlantılar olabilir. Örneğin, Sales Analysis adlı bir alanda bulunan ve Qlik Cloud (DataFiles Bağlantı) içinde yerel olarak depolanan bir veri kümesi için aşağıdakini kullanırsınız: Sales Analysis:DataFiles connection — Yalnızca bağlantı adı. Bu, kişisel alanınızda bulunan bağlantıları ifade eder. Bu durumda Bağlantı basitçe şu şekilde olur: DataFiles Örnekler: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Veri ürününden (measurelist) belirtilen ölçülerin ana ölçülere dönüştürülmesini belirten anahtar sözcük.
measurelist	Veri ürününün semantik modelinden ana hesaplamalara dönüştürülecek hesaplamaların listesi. Tüm ölçüleri dönüştürmek için * kullanabilir veya belirli ölçülerin virgülle ayrılmış bir listesini sağlayabilirsiniz. Örnek: [Sales], [Total Quantity], [Cost]
WithDimensions	Belirtilen boyutları veri ürününden (dimensionlist) ana boyutlara dönüştürme talimatı veren anahtar kelime.
dimensionlist	Veri ürününün semantik modelinden ana boyutlara dönüştürülecek boyutların listesi. Tüm boyutları dönüştürmek için * kullanabilir veya belirli boyutların virgülle ayrılmış bir listesini sağlayabilirsiniz. Örnek: [Product Name], [Region], [Customer]

açıklamalar

IncludeModel ifadesi, bir veri ürününü semantik modeliyle birlikte yüklemeyi seçtiğinizde genellikle veri kataloğu tarafından otomatik olarak oluşturulur. Ayrıca hangi alanların, ölçülerin ve boyutların dahil edileceğini özelleştirmek için ifadeyi manuel olarak yazabilir veya oluşturulan ifadeyi düzenleyebilirsiniz.

Semantik modelde tanımlanan ilişkiler, yüklenen tablolara otomatik olarak uygulanarak veri modelinizde ilişkilendirmeler oluşturur.

Hesaplamalar ve boyutlara yönelik işlemler, tablolar ve alanlar yüklendikten sonra veri yüklemesinin sonunda uygulanır. Yükleme o aşamadan önce başarısız olursa hiçbir ölçü veya boyut işlemi uygulanmaz.

IncludeModel ifadesini kullanmak için veri ürününü içeren alanda Veri tüketebilir veya Görüntüleyebilir iznine sahip olmanız gerekir.

Ana öğe özellikleri

Semantik modellerden devralınan ana öğelerin çoğu özniteliği, tüketen uygulamada salt okunurdur. Görselleştirmelerle ilgili olanlar gibi diğer bazı ana öğe öznitelikleri, uygulama içinde hâlâ düzenlenebilir.

Salt okunur davranış yalnızca kullanıcı arayüzü için geçerlidir—API aracılığıyla bir dizi ana öğe özelliğini ayarlayabilirsiniz:

Semantik modelde yapılandırılabilen ancak tüketen uygulamanın kullanıcı arabiriminde salt okunur olan özellikler. Buna başlık, açıklama ve etiketler dahildir.
Semantik modelde yapılandırılmamış ve tüketen uygulamanın kullanıcı arabiriminde gösterilmeyen özellikler.

Semantik model tarafından tanımlanan özelliklerde yapılan değişikliklerin üzerine, uygulama yeniden yüklendiğinde yazılacaktır.

Ana öğe silme

Yayımlanmamış bir uygulamada, devralınan bir ana öğeyi silebilirsiniz; ancak IncludeModel komut dosyasında hâlâ referans veriliyorsa bir sonraki yeniden yüklemede tekrar görünür. Kalıcı olarak kaldırmak için önce komut dosyasından kaldırın. Ayrıca devralınan bir ana öğeyi çoğaltabilirsiniz. Çoğalt, sıradan bir uygulama ana öğesidir ve tamamen düzenlenebilir.

Örnek 1 – Belirli tabloları, tüm ölçü ve boyutlarıyla birlikte yükleyin

Bu örnek; veri ürününden ve semantik modelinden belirli tabloları ve bunların ilişkilerini yükler. Ayrıca belirli tablolardan tüm alanları yüklemek için joker karakterler (*) kullanır ve semantik modeldeki tüm ölçümlerin ve boyutların uygulamada ana öğeler olarak tanımlanması gerekir.

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 *;

Bu IncludeModel ifadesinin bileşenleri şunlardır:

Veri ürünü adı: Sales Performance Data
Veri ürünü alanı: Sales Analysis Space
Tablolar: Transactions ve Products
Alanlar: tümü
Hesaplamalar ve boyutlar: tümü

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki tüm hesaplamalar ve boyutlar uygulamada ana öğeler olarak görünecektir.

Örnek 2 – Belirli tabloları, ölçümleri ve boyutları yükleme

Bu örnek; veri ürününden ve semantik modelinden belirli tabloları ve bunların ilişkilerini yükler. Belirli tablolardan tüm alanları yüklemek için joker karakterler (*) kullanır. Tüm hesaplamaları ve boyutları otomatik olarak ana öğe olarak tanımlamak yerine, belirli hesaplamalar ve boyutlar ana öğe olarak tanımlanır.

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];

Bu IncludeModel ifadesinin bileşenleri şunlardır:

Veri ürünü adı: Customer Analytics
Veri ürünü alanı: sales
Tablolar: Customers ve Orders
Alanlar: tümü
Ölçüler: Total Revenue ve Customer Count
Boyutlar: Customer Name

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki belirli hesaplamaların ve boyutların her biri uygulamada ana öğeler olarak görünür.

Örnek 3 – Belirli tabloları tüm ölçüler ve boyutlarla birlikte yükleme (veri kümesi ortamda bulunur)

Bu örnek, bir ortam içinde yer alan bir veri alanında bulunan bir veri ürününden belirli tabloları ve bunların semantik model ilişkilerini yükler (bkz. Ortamları senkronize etme ve yönetme). Ayrıca belirli tablolardan tüm alanları yüklemek için joker karakterler (*) kullanır ve semantik modeldeki tüm ölçümlerin ve boyutların uygulamada ana öğeler olarak tanımlanması gerekir.

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 *;

Bu IncludeModel ifadesinin bileşenleri şunlardır:

Veri ürünü adı: Sales Performance Data
Veri ürünü ortamı: Production
Veri ürünü alanı: Sales Analysis Space
Tablolar: Transactions ve Products
Alanlar: tümü
Hesaplamalar ve boyutlar: tümü

İki tablo ilişkileriyle birlikte yüklenir. Semantik modeldeki tüm hesaplamalar ve boyutlar uygulamada ana öğeler olarak görünecektir.

IncludeModel komut dosyası sınırlamaları

WithTables: * joker karakter söz dizimi desteklenmiyor. Tabloları açıkça listelemelisiniz.

Veri ürünlerindeki anlamsal modeller

Uygulamalarda veri ürünlerini kullanma

Veri kataloğu

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız lütfen bize bildirin!

Geri bildiriminizi buradan iletin