Uygulamalarda veri ürünlerini kullanma

Analitik geliştiricileri, veri kataloğunu kullanarak veri ürünlerini semantik modelleriyle birlikte analitik uygulamalara yükleyebilir. Veri kataloğu gerekli komut dosyasını üretir ve ölçüler ile boyutlar için ana öğeler oluşturur.

Bir veri ürününü tükettiğinizde, veri kataloğu seçilen tabloları, ilişkileri, ölçümleri ve boyutları uygulamanıza yükleyen bir IncludeModel komut dosyası ifadesi oluşturur. Semantik modeldeki hesaplamalar ve boyutlar otomatik olarak ana öğeler olarak görünür ve görselleştirmelerde kullanıma hazırdır.

Önkoşullar

Bir veri ürününü ve semantik modelini kullanmak için şunlara ihtiyacınız vardır:

İzinler

Paylaşılan, yönetilen ve veri alanlarındaki veri ürünlerinin semantik modelini tüketmek için, veri ürününü içeren alanda Veri tüketebilir veya Görüntüleyebilir iznine sahip olmanız gerekir.

Tüm ayrıntılar için, bkz. Veri ürünleri rolleri ve izinleri.

Erişilebilir veri kümeleri

Semantik modelde yer alan veri kümelerinin yanı sıra temel alınan verilere yönelik bağlantılara da erişiminiz olmalıdır.

Benzersiz veri ürünü adı

Veri ürününün alan içinde benzersiz bir adı olmalıdır. Bir uygulama zaten aynı ada sahip bir veri ürünü içeriyorsa, semantik modelin yüklenmesi başarısız olur.

Veri ürünü aracılığıyla bir veri ürününü ve semantik modeli tüketme

Doğrudan bir veri ürününden bir analiz uygulaması oluşturabilirsiniz. Veri ürününden ve semantik modelinden nelerin kullanılacağını daraltabilirsiniz: veri kümeleri, alanlar ve ana öğeler.

1. Veri ürününü, veri pazaryerinden birini seçerek veya kataloğa göz atarak açın.

2. Veri ürünü adı başlığında Şurada kullan > Uygulama seçeneğine tıklayın.

   

3. Yeni bir uygulama oluştur penceresinde, semantik modeli ve yüklenecek verileri gözden geçirin.
4. Devam'a tıklayın.

   Yeni oluşturulan uygulamanın Veri yükleme düzenleyicisi açılır ve veri kataloğuna yönlendirilirsiniz. Veri ürünü varsayılan olarak seçilidir, ancak uygulamaya yüklemeden önce göz atabilir, seçiminizi daraltabilir ve verileri inceleyebilirsiniz. Daha fazla bilgi için bkz. Veri yükleme düzenleyicisi aracılığıyla bir veri ürünü ve semantik model tüketme.

5. Hazır olduğunuzda Verileri yükle'ye tıklayın.

Veriler yüklendikten sonra sayfa eklemeye başlayabilir ve uygulama üzerinde çalışabilir veya gerekirse komut dosyasını incelemek ve değiştirmek için Veri yükleme düzenleyicisi bölümüne gidebilirsiniz. Semantik modelin tabloları, ilişkileri, ölçüleri ve boyutları artık kullanıma hazırdır.

Sayfalardaki verileri görselleştirme hakkında daha fazla bilgi için bkz. Analiz oluşturma ve verileri görselleştirme.

Veri yükleme düzenleyicisi aracılığıyla bir veri ürünü ve semantik model tüketme

Veri kataloğu, manuel olarak komut dosyası girmek yerine veri ürünlerinden veri ve semantik model bilgilerine göz atmak ve bunları seçmek için bir arayüz sağlar.

Bir veri ürününü ve semantik modelini yüklemek için:

1. Uygulamayı açın.
2. Üst gezinti sütununda Veri yükleme düzenleyicisi'ne tıklayın.
3. Veri ekle sağ panelinde, Veri kataloğundan veri ekle'ye tıklayın.
4. Veri kataloğu modali açılır ve anlamsal modellere sahip veri ürünleri de dahil olmak üzere kullanılabilir verileri gösterir.

   

Veri ürünlerine göz atma

Veri kataloğu, semantik modeller içeren veri ürünlerini görüntüler. Veri ürünlerine ad, açıklama veya etiketlere göre göz atabilir ve arama yapabilirsiniz.

Tablolar, hesaplamalar ve boyutlar dahil olmak üzere uygulama komut dosyasına nelerin yükleneceğinin bir özetini görüntülemek için bir veri ürününe tıklayın.

Semantik modeldeki bir veri kümesine erişilemiyorsa bir uyarı göstergesiyle işaretlenir. Semantik modelde bulunan ve bununla ilişkili ölçüleri ve boyutları yine de kullanabilirsiniz; ancak erişilemeyen veri kümeleri ve alanları hariç tutulan ögelerdir.

Semantik model seçme ve hassaslaştırma

Hangi veri ürününü kullanacağınızı seçtikten sonra seçiminizi daraltabilir ve semantik modelin tam olarak hangi bileşenlerini uygulamanıza dahil edeceğinizi seçebilirsiniz.

1. Farenizi seçilen veri ürününün üzerine getirin ve Seçimi daralt öğesine tıklayın.

   

   Veri ürününün öğeleri arasında gezinebileceğiniz üç yeni sekme mevcuttur:

   • Tablolar/alanlar
   • Boyutlar
   • Hesaplamalar
2. Seçiminizi daraltmak ve hangi veri kümelerini, alanları, ölçüleri ve boyutları dahil edeceğinizi seçmek için onay kutularını kullanın.
İpucu notu

Gelişmiş kullanıcılar, semantik model değiştiğinde yeni öğelerin otomatik olarak dahil edilip edilmeyeceğini kontrol etmek için Yeniden yüklemede eklenen öğeleri otomatik olarak dahil et seçeneğini açıp kapatabilir.

Etkinleştirildiğinde, semantik modele eklenen yeni alanlar, hesaplamalar ve boyutlar; yeniden yükleme yapıldığında veri modeline ve ana öğelere otomatik olarak eklenir. Bu yalnızca tüm alanlar, ölçüler ve boyutlar sırasıyla işaretlendiğinde geçerlidir.

3. Seçiminiz hazır olduğunda, Komut dosyası ekle'ye tıklayın.

Oluşturulan IncludeModel komut dosyası, komut dosyasına eklenir ve Veri yükleme düzenleyicisi içinde görüntülenebilir ve düzenlenebilir. Verileri uygulamaya yüklemek için Verileri yükle'ye tıklayın.

Veriler yüklendikten sonra sayfa eklemeye başlayabilir ve uygulama üzerinde çalışabilirsiniz. Daha fazla bilgi için bkz. Analiz oluşturma ve verileri görselleştirme.

Otomatik dahil etmeyi anlama

Otomatik dahil etme özelliği, semantik model değiştiğinde uygulamanızın nasıl yanıt vereceğini kontrol eder.

Bir bileşen türü için otomatik dahil etme etkinleştirildiğinde, oluşturulan komut dosyası bir joker karakter (*) seçicisi kullanır:

• Fields *: Belirtilen tablodaki tüm alanları içerir.
• WithMeasures: *: Tüm hesaplamaları ana öğeler olarak içerir.
• WithDimensions: *: Tüm boyutları ana öğeler olarak içerir.

Otomatik dahil etme devre dışı bırakıldığında, komut dosyası seçilen öğeleri açıkça listeler. Örneğin:

• WithMeasures [Total sales], [Total quantity]: Yalnızca belirtilen ölçüleri içerir.
• WithDimensions [Region], [Product]: Yalnızca belirtilen boyutları içerir.

Otomatik dahil etme, bakımı azaltmak ve uygulamanızın semantik modeldeki iyileştirmelerden yararlanmasını sağlamak için ileri düzey kullanıcılara önerilir. Hangi öğelerin dahil edileceği üzerinde sıkı bir denetime ihtiyacınız varsa otomatik dahil etmeyi devre dışı bırakın.

Oluşturulan IncludeModel komut dosyasını anlama

Veriler, semantik modele başvuran ve hangi bileşenlerin yükleneceğini belirten bir IncludeModel komut dosyası ifadesi oluşturur.

Örnek komut dosyası

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Komut dosyası parametreleri:

• IncludeModel: Semantik modeli içeren veri ürününün adı.
• FromSpace: Veri ürününü içeren alanı belirtir.
• WithTables: Hangi tabloların dahil edileceğini belirtir.
• Table: Dahil edilecek bir tabloyu belirtir. Kullanmak istediğiniz her tablo için, virgülle ayrılmış Table ifadeleri ekleyebilirsiniz.
• Fields: Belirtilen tablodan hangi alanların dahil edileceğini belirtir. Tüm alanlar için * veya virgülle ayrılmış bir alan listesi kullanın.
• Connection: environment:space:connection, space:connection veya connection biçimini kullanarak tablo konumunu belirtir.
• WithMeasures: Hangi hesaplamaların ana hesaplama olarak dahil edileceğini belirtir. Tüm ölçümler veya belirli ölçüm adlarının bir listesi için * kullanın.
• WithDimensions: Hangi boyutların ana boyut olarak dahil edileceğini belirtir. Tüm boyutlar veya belirli boyut adlarının bir listesi için * kullanın.

Hangi öğelerin dahil edileceğini ayarlamak veya joker karakter ile açık seçim modları arasında geçiş yapmak için IncludeModel ifadesini manuel olarak düzenleyebilirsiniz.

IncludeModel ifadesi hakkında tüm ayrıntılar için bkz. IncludeModel.

Alan ve tablo adlandırma

Bir veri ürünü bir uygulamaya yüklendiğinde, adlandırma çakışmalarını önlemek ve ilişkileri Qlik analitik modellerini takip eden ada dayalı ilişkilendirmelere dönüştürmek için alan ve tablo adları otomatik olarak ayarlanabilir.

• İlişkisi olmayan aynı adlı alanlar: İki tablo aynı ada sahip bir alan içeriyor ancak alanlar arasında bir ilişki bulunmuyorsa, uygulamada istenmeyen bir otomatik ilişkilendirmeyi önlemek için alan adları otomatik olarak tablo adlarıyla nitelenir (örneğin, TableName.FieldName).
• İlişkisi olan alanlar: İki alan arasında bir ilişki varsa ancak adları farklıysa, bir ilişkilendirme oluşturmak amacıyla bir uygulamaya yüklendiklerinde aynı adla, yani ilişkinin adıyla yeniden adlandırılırlar.

• Bileşik anahtarlar: Bileşik anahtarlar için ilgili tablolara yeni bir anahtar alan eklenir.

• Aynı adlı tablolar: İki tablo aynı ada sahipse sayısal bir son ek eklenerek otomatik olarak yeniden adlandırılır; örneğin TableName_1, TableName_2 vb.

Devralınan ana öğelerle çalışma

IncludeModel ifadesi içeren bir uygulamayı yeniden yüklediğinizde, semantik modeldeki hesaplamalar ve boyutlar otomatik olarak ana öğeler panelinde görünür.

Bir semantik modelden ana öğeleri kullanmak için:

1. Semantik modelden veri yüklemek için uygulamayı yeniden yükleyin.
2. Sayfayı düzenleme modunda açın.
3. Sol panelde Ana öğeler'e tıklayın.
4. Semantik modeldeki ölçüler ve boyutlar, listede bir veri ürünü göstergesiyle görünür.

   

5. Bir ana hesaplamayı veya boyutu kullanmak için bir görselleştirmenin üzerine sürükleyin.

Semantik modellerden devralınan ana öğeler, kaynak veri ürünü adını ve açıklamasını görüntüler. Ölçü veya boyut tarafından kullanılan ifadeyi üzerine gelerek görüntüleyebilirsiniz.

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.

Ana öğeler ve uygulamaları yayımlama

Bir uygulama yayımlandığında, devralınan ana öğeleri, uygulama yayımlandığında kullanılan veri ürününün sürümüne sabit kalır. Yayımlanmış bir uygulamanın yeniden yüklenmesi, veri ürünündeki ana öğeleri oluşturmaz, güncellemez veya silmez. Yeni veya değiştirilmiş ölçüleri ve boyutları kullanmak için uygulamayı güncelleyin ve yeniden yayımlayın.

Bir uygulamada semantik model güncellemelerini ele alma

Semantik model siz kullandıktan sonra değişirse, değişiklikleri yansıtmak için uygulamanızı güncelleyebilirsiniz.

Joker karakter seçicileriyle otomatik dahil etme modunu kullandıysanız, yeni ölçüler ve boyutlar otomatik olarak dahil edilir. Açık seçim kullandıysanız yalnızca başlangıçta seçtiğiniz öğeler yüklenir.

Semantik modelden yeni öğeler eklemek için:

1. Veri yükleme düzenleyicisi uygulamasını açın.
2. Komut dosyanızdaki IncludeModel ifadesini bulun.
3. Yeni öğeler eklemek veya seçicileri otomatik dahil etme için * olarak değiştirmek üzere ifadeyi düzenleyin.
4. Uygulamayı yeniden yükle.

Alternatif olarak, mevcut IncludeModel ifadesini kaldırabilir ve güncellenmiş seçimlerle yenisini oluşturmak için veri kataloğunu kullanabilirsiniz.

Veri ürünlerini diğer araçlarda tüketme

Kod içinde veri ürünlerini tüketmek mümkündür ancak ölçüler ve boyutlar yok sayılır.

Uygulamalar ve betikler dışındaki varlıklarda (veri akışları ve tablo tarifleri gibi) veri ürünlerini tüketirken veri ürünü, aralarından seçim yapılabilecek bir dizi güvenilir veri kümesi olarak işlev görür. Bu araçlar veri kümelerini kaynak olarak kullanır ve veri ürünü kökende bir kaynak düğüm olarak gösterilmez.