Paraméterek implementálása adatforrásokhoz

Az adatforrások rugalmasabbá tétele érdekében a lekérdezésben futásidejű paramétereket implementálhat, amelyek lehetővé teszik az adatforrás számára a változók használatát.

Ezek lehetnek az Essbase-ben definiált helyettesítő változók, a rács kontextus által definiált futásidejű paraméterek, amikor a Smart View felhasználók külső adatokra részleteznek, vagy külső forrásrendszerben írt, felhasználó által definiált függvények.

Ha változókat kíván használni az Essbase adatforrásokban, akkor először

Szerepeltetni kell a változó szintaxist az adatforrás-lekérdezésben. Például az Adatforrás lekérdezésnek tartalmaznia kell a ? szintaxist, ahol a ? egy helyőrző a futásidőben definiálandó változó számára.
Végezze el a következő műveletek egyikét:
- Állítson be egy fix, alapértelmezett paraméter értéket az adatforrásban az Essbase számára, amelyet helyettesítésként használ, ha a változónak a futáskor érvénytelen a kontextusa, VAGY
- Az adatforrás által használt helyettesítő változó beállítása.
- Külső, felhasználó által definiált függvény (vagy tárolt eljárás) átadása paraméterként

Az Adatforrások definiálásához és paramétereik implementálásához legalább alkalmazáskezelőnek kell lennie.

A változók használatának engedélyezése az Essbase adatforrásokban segít egyszerűsíteni a műveleteket, mivel kevesebb adatforrást kell karbantartani. A változók adatforrásokhoz való implementálása lehetővé teszi egy olyan futásidejű lekérdezési környezet megadását, amely akkor kerül alkalmazásra, amikor egy felhasználó hozzáfér egy Essbase kockához kapcsolódó adatforráshoz.

Tegyük fel például a következő használati eseteket.

Egy adatbázis-kezelő felügyeli az ismétlődő adatbetöltési feladatot, amely havi rendszerességgel tölti be az adatokat a kockába. Az adatbázis-kezelő mostantól egy helyettesítő változót használhat az aktuális hónap adatainak betöltésére, ahelyett, hogy minden hónapra külön betöltési szabályt tartana fenn.
Az alkalmazáskezelő fenntartja a különböző üzleti felhasználási esetekre vonatkozó részletező kimutatásdefiníciókat. Az alkalmazáskezelő az alapul szolgáló adatforrásban olyan változókat valósít meg, amelyeket a Smart View felhasználók a részletezési műveletek során használnak. Ennek eredményeképpen az alkalmazáskezelőnek kevesebb részletező kimutatásdefiníciót kell karbantartania és hibaelhárítania.

Alapértelmezett paraméter beállítása egy adatforrásban

Állítson be egy alapértelmezett paramétert egy adatforrásban, ha lehetővé kívánja tenni a változók használatát az Essbase által generált lekérdezésekben, amikor a kockán kívül tárolt adatokkal dolgozik.

Az alapértelmezett paraméter beállításához:

Szerezzen be vagy hozzon létre kapcsolatot a külső adatforráshoz (például hozzon létre kapcsolatot az Oracle adatbázissal).

Használhat egy globális kapcsolatot, ha az már létezik a Essbase webes felületének Források lapján, vagy létrehozhat egy alkalmazásszintű kapcsolatot.
Adatforrás létrehozása az Oracle adatbázis eléréséhez használt kapcsolaton keresztül.

Az adatforrást globálisan is definiálhatja, ha minden alkalmazás számára elérhetőnek kell lennie, vagy definiálhatja alkalmazásszinten is.
1. Globális adatforrás létrehozásához a következő szerepkörre van szükség: szolgáltatási rendszergazda. Kattintson a Források, Adatforrások lapra a felhasználóneve alatt, majd kattintson az Adatforrás létrehozása elemre.
  
  Alkalmazásszintű adatforrás létrehozásához alkalmazáskezelő vagy kiemelt felhasználó szerepkör szükséges az adott alkalmazásra vonatkozó alkalmazáskezelői jogosultsággal. Az Alkalmazások lapon kattintson rá egy alkalmazás nevére. Utána kattintson a Források, Adatforrások lapra a felhasználóneve alatt, majd kattintson az Adatforrás létrehozása elemre.
2. Az Általános lépésben, a Kapcsolat esetében válassza ki a létrehozott Oracle adatbázis kapcsolatot.
3. A Név alatt adjon nevet az adatforrás számára.
4. A Lekérdezés alatt adjon meg egy lekérdezést (ez a példa SQL-t használ). Ahhoz, hogy ez egy paraméterezett lekérdezés legyen, tartalmaznia kell egy szűrőfeltételt (WHERE utasításrészt), amely a forrás relációs oszlopát egy helyőrzőhöz rendeli. A változó pozícióját a lekérdezés szintaxisában a ? helyőrzővel jelzi. A helyőrző egy olyan paramétert jelöl, amelyet egy későbbi lépésben fog átadni.
```
select * from SB_DT where DIMENSION_YEAR=?
```
  Tegyük fel például, hogy a relációs adatbázis a következő, SB_DT nevű táblával rendelkezik. A táblázatban a DIMENSION_YEAR oszlopban hónapok szerepelnek értékként:
  
  A DIMENSION_YEAR oszlop havi értékeinek kiválasztásához egy változót használjon a lekérdezésben a következő szűrő szintaxis alkalmazásával: ahol DIMENSION_YEAR=?
5. Kattintson a Tovább gombra.
6. Az Oszlopok lépésben alkalmazza a megfelelő adattípust, amelyet az Essbase a relációs forrásadatok minden egyes oszlopához társít.
  
  Például állítsa a numerikus oszlopokat Dupla típusúra, az alfanumerikus oszlopokat pedig hagyja Karakterlánc típusúnak.
7. Kattintson a Tovább gombra.
8. A Paraméterek lépésben létrejön a Param1 – ez a paraméter azért létezik, mert az Általános lépésben a lekérdezésben egy ? karaktert használt.
  
  Hagyja a Változók használata jelölőnégyzetet bejelölve, kattintson duplán az Érték alatti szövegmezőre, és írja be a futásidejű paraméter alapértelmezett értékét. Ennek az alapértelmezett értéknek az a célja, hogy az Essbase tartalékként használhassa, ha a paraméter futásidőben érvénytelen környezettel rendelkezik. Ez a lépés akkor fontos, ha futásidejű paramétereket kíván használni a részletező kimutatásdefiníciók részeként.
  
  A Param1-et átnevezheti egy olyan névre is, amely a felhasználási eset szempontjából értelmes. Átnevezheti például param_G_hónap névre, hogy jelezze, hogy a paraméter az aktuális hónap globális változóját használja, vagy átnevezheti param_<appName>_hónapnévre, hogy jelezze, hogy a paraméter az aktuális hónap alkalmazásszintű változóját használja. A paraméternevek testreszabása hasznos lehet a paraméterek hibakeresése során az Essbase kiszolgáló-naplófájlok használatával.
  
  Ha a paramétert úgy kívánja testre szabni, hogy egy helyettesítő változóra hivatkozzon, akkor nem kell alapértelmezett értéket megadnia. Ezen témakör helyett lásd a következőt: Helyettesítő változók használata egy adatforrásban.
9. Kattintson a Tovább gombra.
10. Az Előnézet dimenzióban vegye észre, hogy az alapértelmezett alkalmazza a lekérdezésre. Ennek eredményeképpen az előnézet csak olyan külső forrásrekordokkal töltődik fel, amelyekben a DIMENSION_YEAR oszlop értéke Jan.
  
  Bár az előnézet csak az alapértelmezett paraméterrel alkalmazott értékeket jelenítette meg, később, amikor futásidejű paramétereket használ a jelentés meghatározásához, több külső adathoz is hozzáférhet, mint ami az előnézetben látható volt.
11. Kattintson a Létrehozás elemre a külső forrásadatok ezen lekérdezésén alapuló adatforrás létrehozásához. Az adatforrás engedélyezve van a futásidejű paraméterek végrehajtásához.

Helyettesítő változók használata egy adatforrásban

A következő munkafolyamat azt szemlélteti, hogyan hozható létre egy Essbase adatforrás külső forrásadatok lekérdezéséből, egy Essbase-ben definiált helyettesítő változó használatával. A helyettesítő változó nagyobb rugalmasságot biztosít a forrásadatokból származó lekérdezés megtervezésében.

Ez a példa egy Essbase helyettesítő változót használ az aktuális hónap deklarálására. Ahelyett, hogy havonta frissítené az Adatforrásokat az aktuális hónap adatainak behívása érdekében, az Adatforrásokat békén hagyhatja, és elegendő csak a meghatározott helyettesítő változót frissíteni.

Hozzon létre egy globális vagy alkalmazási szintű helyettesítő változót.
Szerezzen be vagy hozzon létre kapcsolatot a külső adatforráshoz (például hozzon létre kapcsolatot az Oracle adatbázissal).

Használhat egy globális kapcsolatot, ha az már létezik a Essbase webes felületének Források lapján, vagy létrehozhat egy alkalmazásszintű kapcsolatot.
Adatforrás létrehozása az Oracle adatbázis eléréséhez használt kapcsolaton keresztül.

Az adatforrást globálisan is definiálhatja, ha minden alkalmazás számára elérhetőnek kell lennie, vagy definiálhatja alkalmazásszinten is.
1. Az Általános lépésben, a Kapcsolat esetében válassza ki a létrehozott Oracle adatbázis kapcsolatot.
2. A Név alatt adjon nevet az adatforrás számára.
3. A Lekérdezés alatt adjon meg egy lekérdezést (ez a példa SQL-t használ). Ahhoz, hogy ez egy paraméterezett lekérdezés legyen, tartalmaznia kell egy szűrőfeltételt (WHERE utasításrészt), amely a forrás relációs oszlopát egy helyőrzőhöz rendeli. A változó pozícióját a lekérdezés szintaxisában a ? helyőrzővel jelzi. A helyőrző egy olyan paramétert jelöl, amelyet egy későbbi lépésben fog átadni.
```
select * from SB_DT where DIMENSION_YEAR=?
```
  Tegyük fel például, hogy a relációs adatbázis a következő, SB_DT nevű táblával rendelkezik. A táblázatban a DIMENSION_YEAR oszlopban hónapok szerepelnek értékként:
  
  A DIMENSION_YEAR oszlop havi értékeinek kiválasztásához használjon egy változót a lekérdezésben a következő szűrő szintaxis alkalmazásával: where DIMENSION_YEAR=?
4. Kattintson a Tovább gombra.
5. Az Oszlopok lépésben alkalmazza a megfelelő adattípust, amelyet az Essbase a relációs forrásadatok minden egyes oszlopához társít.
  
  Például állítsa a numerikus oszlopokat Dupla típusúra, az alfanumerikus oszlopokat pedig hagyja Karakterlánc típusúnak.
6. Kattintson a Tovább gombra.
7. A Paraméterek lépésben létrejön a Param1 – ez a paraméter azért létezik, mert az Általános lépésben a lekérdezésben egy ? karaktert használt. A Param1 testreszabásához, hogy egy helyettesítő változóra hivatkozzon, kattintson a Változók használata gombra, és válasszon ki egy helyettesítő változót az Érték legördülő listából.
  
  Ha egy alkalmazáson belül hoz létre adatforrást, mind a globális, mind az alkalmazásszintű helyettesítő változók választhatók. Az alkalmazásszintű változók elé az alkalmazás neve kerül. Ha globális adatforrást hoz létre, csak a globális helyettesítő változók választhatók ki.
  
  A Param1 nevet átnevezheti, hogy a nevük jelentéssel bírjon a használási eset szempontjából . Átnevezheti például param_G_hónap névre, hogy jelezze, hogy a paraméter az aktuális hónap globális változóját használja, vagy átnevezheti param_<appName>_hónapnévre, hogy jelezze, hogy a paraméter az aktuális hónap alkalmazásszintű változóját használja. A paraméternevek testreszabása hasznos lehet a paraméterek hibakeresése során az Essbase kiszolgáló-naplófájlok használatával.
8. Kattintson a Tovább gombra.
9. Az Előnézet dimenzióban vegye észre, hogy a helyettesítő változót alkalmazza a lekérdezésre. Ennek eredményeképpen az előnézet csak olyan külső forrásrekordokkal töltődik fel, amelyekben a DIMENSION_YEAR oszlop értéke Aug.
10. Kattintson a Létrehozás elemre a külső forrásadatok ezen lekérdezésén alapuló adatforrás létrehozásához.