Vytvoření připojení a datových zdrojů pro obecné ovladače JDBC

Tento pracovní postup umožňuje systému Essbase připojit se k libovolnému zdroji dat JDBC pomocí ovladačů, které nahrajete na server Essbase.

Pokud jste správcem nasazení systému Essbase, můžete konfigurovat systém Essbase tak, aby používal preferované ovladače, které nahrajete na server Essbase. Společnost Oracle testovala připojení JDBCEssbase pomocí ovladačů Oracle. Chcete-li používat ovladače JDBC od jiných dodavatelů, podívejte se do dokumentace k ovladači, kde najdete požadavky na zadání adresy URL a ověřovací údaje datového zdroje JDBC. Veškeré kroky související s výkonem naleznete v dokumentaci dodavatele JDBC.

Poznámka:

Ujistěte se, že ovladač JDBC, který používáte s Essbase, respektuje metodu setFetchSize pro řízení paměti používané při zpracování sady výsledků. Essbase načítá 1 000 záznamů na síťové volání, aby se dosáhlo optimálního výkonu procesů načítání dat a vytváření dimenzí.

Konfigurace systému Essbase na používání obecných ovladačů JDBC,

Připojte se k serveru Essbase pomocí SSH.
Ručně vytvořte adresář ovladače v <Domovská stránka produktu Essbase> na instanci serveru.

Ujistěte se, že adresář ovladače obsahuje pouze malá písmena, protože v cestě se rozlišují malá a velká písmena.
Z webu dodavatele stáhněte soubory JAR ovladače JDBC, které chcete použít.

Ovladač JDBC databáze Oracle podporovaný systémem Essbase je ojdbc8.jar.

Pokud používáte službu Autonomous Data Warehouse, je třeba stáhnout celý archiv (ojdbc8-full.tar.gz) obsahující ovladač Oracle JDBC Thin a doprovodné soubory JAR.
Nahrajte soubory JAR ovladače JDBC do adresáře ovladače v instanci Essbase.

Do adresáře ovladače nahrajte pouze jednu verzi každého databázového ovladače. Například nenahrávejte oba soubory sqljdbc41.jar a sqljdbc42.jar, jinak Essbase použije ten starší (protože je v CLASSPATH uveden jako první).

Pokud používáte službu Autonomous Data Warehouse, rozbalte archiv (ojdbc8-full.tar.gz) a přesuňte celý obsah přímo do adresáře ovladače (nikoli do podsložky).
Vytvořte připojení k ovladačům JDBC.
1. Ve webovém rozhraní Essbase klikněte na položku Zdroje a poté na volbu Připojení.
  
  Nebo, chcete-li definovat připojení a datový zdroj na úrovni aplikace, tedy nikoli globálně, otevřete místo stránky Zdroje stránku Aplikace, klikněte na název aplikace a poté na volbu Zdroje.
2. Klikněte na Vytvořit připojení a vyberte položku JDBC.
  
  Ovladač JDBC najde systém Essbase ve složce ovladače. Pokud nejsou nalezeny žádné soubory jar, vrátí Essbase při testování připojení chybu Třída nebyla nalezena (nebo chybu nenačtení ovladače).
3. Na obrazovce Vytvořit připojení,
  1. Zadejte název připojení JDBC. Například Oracle JDBC.
  2. Do pole URL zadejte připojovací řetězec JDBC. Například jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Připojovací řetězec JDBC získáte od poskytovatele JDBC.
    
    Výše uvedený formát syntaxe platí pouze pro databázi Oracle. Pokud pracujete s jinými poskytovateli, podívejte se na Další příklady připojení pro obecné ovladače JDBC.
  3. Do polí Uživatel a Heslo zadejte ověřovací údaje uživatele, který má oprávnění k přístupu do databáze.
  4. Do pole Ovladač zadejte plně kvalifikovaný název třídy ovladače JDBC. Například: oracle.jdbc.driver.OracleDriver.
  V případě ovladačů Oracle zadejte adresu URL pomocí následujících pokynů pro syntaxi:
  - Pokud je databáze Oracle Database zaregistrována se službou listener, můžete v adrese URL místo identifikátoru SID použít název služby pomocí krátké syntaxe jdbc:oracle:thin:@<host>:<port>/<název_služby>. Příklad:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - V následujícím příkladu se používá název služby s dlouhou syntaxí.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Chcete-li použít ID systému Oracle (SID), které jednoznačně identifikuje databázi, použijte syntaxi jdbc:oracle:thin:@<hostitelský_počítač>:<port>:<SID>. Například:
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Pokud používáte službu Autonomous Data Warehouse, musíte v syntaxi adresy URL uvést proměnnou prostředí TNS_ADMIN, která určuje cestu k walletu. Wallet se může nacházet kdekoli na počítači se serverem Essbase, ale musíte zadat celou cestu s využitím syntaxe ve tvaru jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.
    
    Příklad pro systém Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Příklad pro systém Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Příklad nasazení OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Výše uvedené příklady fungují pouze pro databázi Oracle. Pokud pracujete s jinými poskytovateli, podívejte se na Další příklady připojení pro obecné ovladače JDBC.
4. Kliknutím na Test ověřte platnost připojení, a pokud se podařilo, klikněte na Vytvořit.
5. Zkontrolujte, zda bylo připojení úspěšně vytvořeno a zobrazuje se v seznamu připojení.
Vytvořte datové zdroje prostřednictvím připojení obecného ovladače JDBC.
1. Klikněte na Datové zdroje a pak na Vytvořit datový zdroj.
2. V poli rozevíracího seznamu Připojení vyberte název připojení, které jste právě vytvořili, například Oracle JDBC. Připojení na úrovni aplikace mají předponu s názvem aplikace ve formátu název_aplikace.název_připojení.
3. Zadejte název datového zdroje, například OracleDB_Datasource.
4. Volitelně zadejte popis datového zdroje, například SAMPLE_BASIC_TABLE v databázi Oracle.
5. Do pole Dotaz zadejte příslušný dotaz SQL pro výběr dat, která chcete v daném datovém zdroji zpřístupnit.
6. Klikněte na tlačítko Další. Pokud byl příkaz SQL s dotazem na tabulku správný, dotazované sloupce budou vyplněny.
7. Číselné sloupce změňte na Dvojité a klikněte na Další.
8. Podle potřeby změňte další parametry pro konkrétní zdroj a klikněte na Další. Informace o použití parametrů naleznete v části Implementace parametrů pro datové zdroje.
9. Prohlédněte si panel s náhledem. Měli byste vidět výsledky dotazu, který načetl sloupce dat z externího zdroje.
10. Pokud se náhled jeví jako správný, klikněte na Vytvořit a dokončete vytváření datového zdroje.