Veri Kaynakları İçin Parametreleri Uygulama

Veri Kaynaklarını daha esnek hale getirmek amacıyla Veri Kaynağının değişkenleri kullanmasına izin vermek için sorguda çalıştırma zamanı parametreleri uygulayabilirsiniz.

Bunlar, Essbase'te tanımlanan ikame değişkenleri, Smart View kullanıcıları harici verileri kapsamlı sorguladığında grid bağlamı tarafından tanımlanan çalıştırma zamanı parametreleri veya bir harici kaynak sistemde yazılmış kullanıcı tanımlı fonksiyonlar olabilir.

Essbase Veri Kaynaklarında değişkenleri kullanmayı planladığınızda, önce yapmanız gerekenler:

  1. Veri kaynağı sorgusuna değişken söz dizimini dahil edin. Örneğin, Veri Kaynağı sorgusu söz diziminde ? öğesini içermelidir. Burada ?, çalıştırma zamanında tanımlanacak bazı değişkenler için bir yer tutucudur.

  2. Aşağıdakilerden birini yapın:

    • Değişkenin çalıştırma zamanında geçersiz bir içeriğe sahip olması durumunda yedek olarak kullanmak üzere Essbase için Veri Kaynağında sabit bir parametre öndeğeri ayarlayın VEYA

    • Veri Kaynağı tarafından kullanılacak bir ikame değişkeni ayarlayın

    • Parametre olarak harici, kullanıcı tanımlı bir fonksiyon (veya depolanmış prosedür) iletin

Veri Kaynaklarını tanımlamak ve onlar için parametreleri uygulamak üzere bir uygulama yöneticisi veya daha yüksek bir rolde olmanız gerekir.

Essbase Veri Kaynaklarında değişkenlerin kullanımını etkinleştirmek, bakım için daha az Veri Kaynağı gerektirerek işlemleri modernize etmenize yardımcı olur. Değişkenleri Veri Kaynaklarına uygulamak, bir kullanıcı bir Essbase küpüyle ilişkili bir Veri Kaynağına her eriştiğinde uygulanacak bir çalıştırma zamanı sorgu bağlamı belirtmenize olanak tanır.

Örneğin, aşağıdaki kullanım senaryolarını varsayın.

  • Bir veritabanı yöneticisi, küpe aylık olarak veri yükleyen yinelenen bir veri yükleme işini denetler. Veritabanı yöneticisi artık her ay için bir yükleme kuralı uygulamak yerine, geçerli aya ilişkin verileri yüklemek için bir ikame değişkeni kullanabilir.

  • Bir uygulama yöneticisi, farklı ticari kullanım senaryoları için kapsamlı sorgu raporu tanımları sağlar. Uygulama yöneticisi, Smart View kullanıcılarının kapsamlı sorgu işlemlerinde çektiği temel Veri Kaynağında değişkenleri uygular. Sonuç olarak, uygulama yöneticisinin bakım ve hata ayıklama için daha az sayıda kapsamlı sorgu rapor tanımı vardır.

Veri Kaynağında Parametre Öndeğeri Ayarlama

Küp dışında depolanan verilerle çalışırken Essbase'in oluşturduğu sorgularda değişkenlerin kullanımını etkinleştirmek istiyorsanız, bir Veri Kaynağında bir parametre öndeğeri ayarlayın.

Parametre öndeğerini ayarlamak için

  1. Harici veri kaynağının bağlantısını edinin veya oluşturun (örneğin, Oracle Veritabanı bağlantısı oluşturun).

    Essbase web arayüzünün Kaynaklar sayfasında halihazırda varsa global bir bağlantı kullanabilirsiniz veya uygulama düzeyinde bir bağlantı oluşturabilirsiniz.

  2. Oracle Veritabanı'na erişmek için kullanacağınız bağlantı üzerinden bir Veri Kaynağı oluşturun.

    Tüm uygulamalar için kullanılabilir olması gerekiyorsa bir Veri Kaynağını global olarak tanımlayabilir veya uygulama düzeyinde tanımlayabilirsiniz.

    1. Global bir Veri Kaynağı oluşturmak için hizmet yöneticisi olmanız gerekir. Kaynaklar'a tıklayın, kullanıcı adınızın altındaki Veri Kaynakları sekmesine tıklayın ve Veri Kaynağı Oluştur'a tıklayın.

      Veya uygulama düzeyinde bir Veri Kaynağı oluşturmak için belirtilen uygulamaya yönelik uygulama yönetimi iznine sahip bir uygulama yöneticisi ya da yetkili kullanıcı olmanız gerekir. Uygulamalar sekmesinde bir uygulama adına tıklayın. Daha sonra Kaynaklar'a tıklayın, kullanıcı adınızın altındaki Veri Kaynakları sekmesine tıklayın ve Veri Kaynağı Oluştur'a tıklayın.

    2. Genel adımındaki Bağlantı kısmında, oluşturduğunuz Oracle Veritabanı bağlantısını seçin.

    3. Ad için Veri Kaynağına bir ad verin.

    4. Sorgu için bir sorgu sağlayın (bu örnek SQL kullanır). Bunu parametreli bir sorgu yapmak için kaynağınızdaki ilişkisel bir sütunu bir yer tutucuya eşleyen bir filtre koşulu (WHERE tümcesi) eklemeniz gerekir. Değişkenin konumunu, sorgu söz diziminde ? yer tutucusunu kullanarak belirtirsiniz. Yer tutucu, daha sonraki bir adımda ileteceğiniz bir parametre içindir.

      select * from SB_DT where DIMENSION_YEAR=?

      Örneğin, ilişkisel veritabanınızın SB_DT adlı aşağıdaki tabloya sahip olduğunu farz edin. Tablo, değer olarak ayları içeren DIMENSION_YEAR sütununa sahiptir:
      DIMENSION_YEAR sütununun seçili olduğu bir ilişkisel veritabanı tablosunun görüntüsü. Tüm değerleri aydır: Jul, Aug, Aug, Sep, Sep, Oct vb.

      DIMENSION_YEAR sütunundan ay değerlerinin seçimi için bir değişken kullanmak üzere sorguda aşağıdaki filtre söz dizimini uygulayın: where DIMENSION_YEAR=?
      Veri Kaynağı oluşturma sihirbazındaki Genel sekmesinin görüntüsü. Bağlantı: SAMPLE.oracledb_conn, Adı: oracledb_ds, Açıklama: Oracle Veritabanı İçin Veri Kaynağı, Sorgu: select * from SB_DT where dimension_year=?

    5. İleri'ye tıklayın.

    6. Sütunlar adımında, Essbase'in ilişkisel kaynak verilerinizden her bir sütunla ilişkilendirmesi gereken uygun veri türünü uygulayın.

      Örneğin, sayısal sütunları Çift türüne ayarlayın ve alfasayısal sütunları Dize türü olarak bırakın.


      Veri Kaynağı Oluştur sihirbazındaki Sütunlar sekmesinin Çift ve dize Tür seçimleri ile görüntüsü.

    7. İleri'ye tıklayın.

    8. Parametreler adımında Param1 oluşturulur. Bu parametre, Genel adımındaki sorguda ? kullandığınız için mevcuttur.

      Değişken Kullan seçeneğini işaretlemeden bırakın, Değer bölümündeki metin alanına çift tıklayın ve çalıştırma zamanı parametresi için bir öndeğer yazın. Bu öndeğerin amacı, Essbase'in, parametrenin çalıştırma zamanında geçersiz bir içeriğe sahip olması durumunda yedek olarak kullanmasıdır. Kapsamlı sorgu raporu tanımlarının bir parçası olarak çalıştırma zamanı parametrelerini kullanmayı düşünüyorsanız bu adım önemlidir.

      Ayrıca Param1 parametresinin adını, kullanım senaryonuz için anlamlı olan bir adla değiştirebilirsiniz. Örneğin, parametrenin geçerli ay için bir global değişken kullandığını belirtmek üzere param_G_month olarak veya parametrenin geçerli ay için uygulama düzeyinde bir değişken kullandığını belirtmek üzere param_<appName>_month olarak yeniden adlandırabilirsiniz. Essbase sunucu günlük dosyalarını kullanarak parametrelerde hata ayıklarken parametre adlarının özelleştirilmesi yararlı olabilir.


      Veri Kaynağı oluşturma sihirbazındaki Parametreler sekmesinin görüntüsü. Değişken Kullan işaretlenmemiştir ve Jan Değeri girilmiştir.

      Bir ikame değişkenine başvurmak için parametreyi özelleştirmek istiyorsanız bir öndeğer sağlamanız gerekmez. Bu konu yerine bkz. Veri Kaynağında İkame Değişkeni Kullanma.

    9. İleri'ye tıklayın.

    10. Önizleme bölümünde, parametre öndeğerinin sorgunuza uygulandığına dikkat edin. Sonuç olarak, önizleme sadece DIMENSION_YEAR sütununun değerinin Jan olduğu harici kaynak kayıtlarıyla doldurulur.


      Sadece DIMENSION_YEAR = Jan olduğu kayıtları gösteren Veri Kaynağı oluşturma sihirbazındaki Önizleme sekmesinin görüntüsü.

      Önizleme sadece parametre öndeğerinin uygulandığı değerleri görüntülese de, daha sonra kapsamlı sorgu raporu tanımı için çalıştırma zamanı parametrelerini uyguladığınızda, önizlemede görünenden daha fazla harici veriye erişiminiz olacaktır.

    11. Harici kaynak verilerinizin bu sorgusunu temel alan Veri Kaynağını oluşturmak için Oluştur'a tıklayın. Veri Kaynağı, çalıştırma zamanı parametrelerinin uygulanması için etkinleştirilir.

Veri Kaynağında İkame Değişkeni Kullanma

Aşağıdaki iş akışı, Essbase'de tanımlanan bir ikame değişkenini kullanarak harici kaynak veri sorgusundan bir Essbase Veri Kaynağının nasıl oluşturulacağını gösterir. İkame değişkeni, kaynak verilerinizden veri çeken sorguyu tasarlama yönteminize daha fazla esneklik katar.

Bu örnekte, geçerli ayı bildirmek için Essbase'de bir ikame değişkeni kullanacaksınız. Geçerli aya ait verileri çekmek için Veri Kaynaklarını aylık olarak güncellemek yerine, Veri Kaynaklarını olduğu gibi bırakabilir ve sadece tanımladığınız ikame değişkenini güncelleyebilirsiniz.

  1. Global veya uygulama düzeyinde bir ikame değişkeni oluşturun.


    Uygulama düzeyinde oluşturulan bir ikame değişkeninin görüntüsü. Ad: CurrMonth, Değer: Aug

  2. Harici veri kaynağının bağlantısını edinin veya oluşturun (örneğin, Oracle Veritabanı bağlantısı oluşturun).

    Essbase web arayüzünün Kaynaklar sayfasında halihazırda varsa global bir bağlantı kullanabilirsiniz veya uygulama düzeyinde bir bağlantı oluşturabilirsiniz.

  3. Oracle Veritabanı'na erişmek için kullanacağınız bağlantı üzerinden bir Veri Kaynağı oluşturun.

    Tüm uygulamalar için kullanılabilir olması gerekiyorsa bir Veri Kaynağını global olarak tanımlayabilir veya uygulama düzeyinde tanımlayabilirsiniz.

    1. Genel adımındaki Bağlantı kısmında, oluşturduğunuz Oracle Veritabanı bağlantısını seçin.

    2. Ad için Veri Kaynağına bir ad verin.

    3. Sorgu için bir sorgu sağlayın (bu örnek SQL kullanır). Bunu parametreli bir sorgu yapmak için kaynağınızdaki ilişkisel bir sütunu bir yer tutucuya eşleyen bir filtre koşulu (WHERE tümcesi) eklemeniz gerekir. Değişkenin konumunu, sorgu söz diziminde ? yer tutucusunu kullanarak belirtirsiniz. Yer tutucu, daha sonraki bir adımda ileteceğiniz bir parametre içindir.

      select * from SB_DT where DIMENSION_YEAR=?

      Örneğin, ilişkisel veritabanınızın SB_DT adlı aşağıdaki tabloya sahip olduğunu farz edin. Tablo, değer olarak ayları içeren DIMENSION_YEAR sütununa sahiptir:
      DIMENSION_YEAR sütununun seçili olduğu bir ilişkisel veritabanı tablosunun görüntüsü. Tüm değerleri aydır: Jul, Aug, Aug, Sep, Sep, Oct vb.

      DIMENSION_YEAR sütunundan ay değerlerinin seçimi için bir değişken kullanmak üzere sorguda aşağıdaki filtre söz dizimini uygulayın: where DIMENSION_YEAR=?
      Veri Kaynağı oluşturma sihirbazındaki Genel sekmesinin görüntüsü. Bağlantı: SAMPLE.oracledb_conn, Adı: oracledb_ds, Açıklama: Oracle Veritabanı İçin Veri Kaynağı, Sorgu: select * from SB_DT where dimension_year=?

    4. İleri'ye tıklayın.

    5. Sütunlar adımında, Essbase'in ilişkisel kaynak verilerinizden her bir sütunla ilişkilendirmesi gereken uygun veri türünü uygulayın.

      Örneğin, sayısal sütunları Çift türüne ayarlayın ve alfasayısal sütunları Dize türü olarak bırakın.


      Veri Kaynağı Oluştur sihirbazındaki Sütunlar sekmesinin Çift ve dize Tür seçimleri ile görüntüsü.

    6. İleri'ye tıklayın.

    7. Parametreler adımında Param1 oluşturulur. Bu parametre, Genel adımındaki sorguda ? kullandığınız için mevcuttur. Param1'i bir ikame değişkenine başvurmak üzere özelleştirmek için Değişken Kullan'a tıklayın ve Değer açılan listesinden bir ikame değişkeni seçin.

      Bir uygulama içinde bir Veri Kaynağı oluşturuyorsanız, hem genel hem de uygulama düzeyinde ikame değişkenleri seçilebilir. Uygulama düzeyindeki değişkenlerin önüne uygulama adı eklenir. Global bir Veri Kaynağı oluşturuyorsanız sadece global ikame değişkenleri seçilebilir.

      Param1'in adını, kullanım senaryonuz için anlamlı olan bir adla değiştirebilirsiniz. Örneğin, parametrenin geçerli ay için bir global değişken kullandığını belirtmek üzere param_G_month olarak veya parametrenin geçerli ay için uygulama düzeyinde bir değişken kullandığını belirtmek üzere param_<appName>_month olarak yeniden adlandırabilirsiniz. Essbase sunucu günlük dosyalarını kullanarak parametrelerde hata ayıklarken parametre adlarının özelleştirilmesi yararlı olabilir.


      Veri Kaynağı oluşturma sihirbazındaki Parametreler sekmesinin görüntüsü. Değişken Kullan işaretlenmiştir ve Değer şudur: Sample.CurrMonth.

    8. İleri'ye tıklayın.

    9. Önizleme bölümünde, ikame değişkeninin sorgunuza uygulandığına dikkat edin. Sonuç olarak, önizleme sadece DIMENSION_YEAR sütununun değerinin Aug olduğu harici kaynak kayıtlarıyla doldurulur.


      Sadece DIMENSION_YEAR = Aug olduğu kayıtları gösteren Veri Kaynağı oluşturma sihirbazındaki Önizleme sekmesinin görüntüsü.

    10. Harici kaynak verilerinizin bu sorgusunu temel alan bir Veri Kaynağı oluşturmak için Oluştur'a tıklayın.