Implementace parametrů pro datové zdroje

Aby byly datové zdroje flexibilnější, můžete do dotazu implementovat běhové parametry programu, které datovému zdroji umožní používat proměnné.

Mohou to být substituční proměnné definované v databázi Essbase, běhové parametry programu definované kontextem mřížky, když uživatelé Smart View procházejí externí data, nebo uživatelsky definované funkce napsané v externím zdrojovém systému.

Kdykoli plánujete používat proměnné v datových zdrojích Essbase, je nejprve nutné

  1. Zahrnout syntaxi proměnných do dotazu na datový zdroj. Například dotaz na datový zdroj musí ve své syntaxi obsahovat ?, kde ? je zástupce pro nějakou proměnnou, která bude definována za běhu programu.

  2. Proveďte některou z následujících akcí:

    • Nastavení pevné hodnoty výchozí parametr v datovém zdroji pro Essbase, která se použije jako záloha v případě, že proměnná má za běhu programu neplatný kontext, NEBO

    • Nastavení hodnoty substituční proměnná, která má být použita datovým zdrojem

    • Předání externí, uživatelem definované funkce (nebo uložené procedury) jako parametru

Abyste mohli definovat datové zdroje a implementovat pro ně parametry, musíte být na úrovni správce aplikací nebo vyšší.

Povolení používání proměnných v datových zdrojích Essbase pomáhá zefektivnit operace tím, že vyžaduje méně datových zdrojů k údržbě. Implementace proměnných do datových zdrojů umožňuje určit kontext dotazu za běhu programu, který se použije vždy, když uživatel používá datový zdroj spojený s krychlí Essbase.

Předpokládejme například následující případy užití.

  • Správce databáze dohlíží na opakující se úlohu načítání dat, která každý měsíc načítá data do krychle. Správce databáze nyní může použít substituční proměnnou k načtení dat pro aktuální měsíc namísto udržování pravidla načítání pro každý měsíc.

  • Správce aplikací udržuje definice sestav procházení pro různé obchodní případy užití. Správce aplikací implementuje proměnné do základního datového zdroje, ze kterých uživatelé nástroje Smart View čerpají při operacích procházení. Díky tomu má správce aplikací k dispozici méně definic sestav procházení, které musí udržovat a ladit.

Nastavení výchozího parametru v datovém zdroji

Pokud chcete povolit použití proměnných v dotazech, které generuje Essbase při práci s daty uloženými mimo krychli, nastavte výchozí parametr v datovém zdroji.

Nastavení výchozího parametru,

  1. Získejte nebo vytvořte připojení k externímu zdroji dat (například vytvořte připojení k databázi Oracle).

    Můžete použít globální připojení, pokud již existuje na stránce Zdroje webového rozhraní Essbase, nebo můžete vytvořit připojení na úrovni aplikace.

  2. Vytvořte datový zdroj nad připojením, které budete používat pro přístup k databázi Oracle.

    Datový zdroj můžete definovat globálně, pokud má být dostupný všem aplikacím, nebo jej můžete definovat na úrovni aplikace.

    1. Chcete-li vytvořit globální datový zdroj, musíte být správce služeb. Klikněte na položku Zdroje, poté na kartu Datové zdroje pod svým uživatelským jménem a nakonec na volbu Vytvořit datový zdroj.

      Nebo chcete-li vytvořit datový zdroj na úrovni aplikace, musíte být správce aplikací nebo uživatel s rolí Power User a mít oprávnění ke správě aplikace pro příslušnou aplikaci. Na kartě Aplikace klikněte na název aplikace. Poté klikněte na položku Zdroje a kartu Datové zdroje pod svým uživatelským jménem a nakonec na volbu Vytvořit datový zdroj.

    2. V kroku Obecné v poli Připojení vyberte vytvořené připojení k databázi Oracle.

    3. V poli Název zadejte název datového zdroje.

    4. V poli Dotaz zadejte dotaz (v tomto příkladu se používá SQL). Aby se jednalo o parametrizovaný dotaz, musíte zahrnout podmínku filtru (klauzuli WHERE), která namapuje relační sloupec ve zdroji na zástupný symbol. Pozici proměnné uvedete v syntaxi dotazu pomocí zástupného symbolu ?. Zástupný symbol je určen pro parametr, který předáte v pozdějším kroku.

      select * from SB_DT where DIMENSION_YEAR=?

      Předpokládejme například, že vaše relační databáze má následující tabulku s názvem SB_DT. Tabulka má sloupec DIMENSION_YEAR s hodnotami měsíců:
      Obrázek tabulky relační databáze s vybraným sloupcem DIMENSION_YEAR. Všechny jeho hodnoty jsou měsíce: červenec, srpen, srpen, září, září, říjen atd.

      Chcete-li použít proměnnou pro výběr hodnot měsíce ze sloupce DIMENSION_YEAR, použijte v dotazu následující syntaxi filtru: where DIMENSION_YEAR=?
      Obrázek karty Obecné v průvodci vytvořením datového zdroje. Připojení: SAMPLE.oracledb_conn, Název: oracledb_ds, Popis: SAMPLE.oracledb_ds: Název: Datový zdroj pro Oracle DB, Dotaz: select * from SB_DT where dimension_year=?

    5. Klikněte na tlačítko Další.

    6. V kroku Sloupce použijte příslušný datový typ, který má systém Essbase přiřadit každému sloupci z vašich relačních zdrojových dat.

      Například číselné sloupce nastavte na typ Double a alfanumerické sloupce ponechte jako typ String.


      Obrázek karty Sloupce v průvodci vytvořením datového zdroje s výběry typu Double a String.

    7. Klikněte na tlačítko Další.

    8. V kroku Parametry je vytvořen Param1 - tento parametr existuje, protože jste v dotazu v kroku Obecné použili symbol ?.

      Ponechte pole Používat proměnné nezaškrtnuté, dvakrát klikněte na textové pole pod položkou Hodnota a zadejte výchozí hodnotu parametru běhu programu. Účelem této výchozí hodnoty je, aby ji systém Essbase použil jako nouzové řešení v případě, že parametr má za běhu programu neplatný kontext. Tento krok je důležitý, pokud máte v úmyslu používat parametry běhu programu jako součást definic sestavy.

      Param1 můžete také přejmenovat na název, který je pro váš případ užití smysluplný. Můžete jej například přejmenovat na param_G_month, abyste naznačili, že parametr používá globální proměnnou pro aktuální měsíc, nebo jej můžete přejmenovat na param_<appName>_month, abyste naznačili, že parametr používá proměnnou na úrovni aplikace pro aktuální měsíc. Přizpůsobení názvů parametrů může být užitečné při ladění parametrů pomocí souborů protokolu serveru Essbase.


      Obrázek karty Parametry v průvodci vytvořením datového zdroje. Pole Použít proměnné není zaškrtnuto a zadaná hodnota je Leden.

      Pokud chcete parametr přizpůsobit tak, aby odkazoval na substituční proměnnou, nemusíte zadávat výchozí hodnotu. Místo tohoto tématu si přečtěte článek Použití substitučních proměnných v datovém zdroji.

    9. Klikněte na tlačítko Další.

    10. V okně Náhled si všimněte, že na váš dotaz byl použit výchozí parametr. V důsledku toho je náhled vyplněn pouze záznamy externích zdrojů, ve kterých má sloupec DIMENSION_YEAR hodnotu Leden.


      Obrázek karty Náhled v průvodci vytvořením datového zdroje, kde jsou zobrazeny pouze záznamy, u nichž DIMENSION_YEAR = Leden.

      Ačkoli náhled zobrazoval pouze hodnoty s použitým výchozím parametrem, později, když implementujete parametry běhu programu pro definici sestavy, budete mít přístup k více externím datům, než která byla viditelná v náhledu.

    11. Kliknutím na Vytvořit vytvoříte datový zdroj na základě tohoto dotazu na externí zdrojová data. Datový zdroj je povolen pro implementaci parametrů běhu programu.

Použití substitučních proměnných v datovém zdroji

Následující pracovní postup ukazuje, jak vytvořit datový zdroj Essbase z dotazu na externí zdrojová data pomocí substituční proměnné definované v systému Essbase. Substituční proměnná zvyšuje flexibilitu při navrhování dotazu, který čerpá ze zdrojových dat.

V tomto příkladu použijete substituční proměnnou v systému Essbase k deklaraci aktuálního měsíce. Namísto měsíční aktualizace datových zdrojů, aby se do nich načítala data za aktuální měsíc, můžete datové zdroje nechat být a aktualizovat pouze vámi definovanou substituční proměnnou.

  1. Vytvořte globální nebo aplikační úroveň substituční proměnná.


    Obrázek substituční proměnné vytvořené na úrovni aplikace. Název: CurrMonth, Hodnota: Aug

  2. Získejte nebo vytvořte připojení k externímu zdroji dat (například vytvořte připojení k databázi Oracle).

    Můžete použít globální připojení, pokud již existuje na stránce Zdroje webového rozhraní Essbase, nebo můžete vytvořit připojení na úrovni aplikace.

  3. Vytvořte datový zdroj nad připojením, které budete používat pro přístup k databázi Oracle.

    Datový zdroj můžete definovat globálně, pokud má být dostupný všem aplikacím, nebo jej můžete definovat na úrovni aplikace.

    1. V kroku Obecné v poli Připojení vyberte vytvořené připojení k databázi Oracle.

    2. V poli Název zadejte název datového zdroje.

    3. V poli Dotaz zadejte dotaz (v tomto příkladu se používá SQL). Aby se jednalo o parametrizovaný dotaz, musíte zahrnout podmínku filtru (klauzuli WHERE), která namapuje relační sloupec ve zdroji na zástupný symbol. Pozici proměnné uvedete v syntaxi dotazu pomocí zástupného symbolu ?. Zástupný symbol je určen pro parametr, který předáte v pozdějším kroku.

      select * from SB_DT where DIMENSION_YEAR=?

      Předpokládejme například, že vaše relační databáze má následující tabulku s názvem SB_DT. Tabulka má sloupec DIMENSION_YEAR s hodnotami měsíců:
      Obrázek tabulky relační databáze s vybraným sloupcem DIMENSION_YEAR. Všechny jeho hodnoty jsou měsíce: červenec, srpen, srpen, září, září, říjen atd.

      Chcete-li použít proměnnou pro výběr hodnot měsíce ze sloupce DIMENSION_YEAR, použijte v dotazu následující syntaxi filtru: where DIMENSION_YEAR=?
      Obrázek karty Obecné v průvodci vytvořením datového zdroje. Připojení: SAMPLE.oracledb_conn, Název: oracledb_ds, Popis: SAMPLE.oracledb_ds: Název: Datový zdroj pro Oracle DB, Dotaz: select * from SB_DT where dimension_year=?

    4. Klikněte na tlačítko Další.

    5. V kroku Sloupce použijte příslušný datový typ, který má systém Essbase přiřadit každému sloupci z vašich relačních zdrojových dat.

      Například číselné sloupce nastavte na typ Double a alfanumerické sloupce ponechte jako typ String.


      Obrázek karty Sloupce v průvodci vytvořením datového zdroje s výběry typu Double a String.

    6. Klikněte na tlačítko Další.

    7. V kroku Parametry je vytvořen Param1 - tento parametr existuje, protože jste v dotazu v kroku Obecné použili ?. Chcete-li upravit Param1 tak, aby odkazoval na substituční proměnnou, klikněte na Použít proměnné a vyberte substituční proměnnou z rozevíracího seznamu Hodnota.

      Pokud vytváříte datový zdroj v rámci aplikace, je možné vybrat globální substituční proměnné i substituční proměnné na úrovni aplikace. Proměnné na úrovni aplikace mají předponu s názvem aplikace. Pokud vytváříte globální datový zdroj, jsou k dispozici pouze globální substituční proměnné.

      Param1 můžete přejmenovat na název, který je pro váš případ užití smysluplný. Můžete jej například přejmenovat na param_G_month, abyste naznačili, že parametr používá globální proměnnou pro aktuální měsíc, nebo jej můžete přejmenovat na param_<appName>_month, abyste naznačili, že parametr používá proměnnou na úrovni aplikace pro aktuální měsíc. Přizpůsobení názvů parametrů může být užitečné při ladění parametrů pomocí souborů protokolu serveru Essbase.


      Obrázek karty Parametry v průvodci vytvořením datového zdroje. Je zaškrtnuto políčko Použít proměnné a hodnota je Sample.CurrMonth.

    8. Klikněte na tlačítko Další.

    9. V okně Náhled si všimněte, že na váš dotaz je použita substituční proměnná. V důsledku toho je náhled vyplněn pouze záznamy externích zdrojů, ve kterých má sloupec DIMENSION_YEAR hodnotu Srpen.


      Obrázek karty Náhled v průvodci vytvořením datového zdroje, kde jsou zobrazeny pouze záznamy, u nichž DIMENSION_YEAR = Srpen.

    10. Kliknutím na Vytvořit vytvoříte datový zdroj na základě tohoto dotazu na externí zdrojová data.