Tworzenie połączeń i źródeł danych dla ogólnych sterowników JDBC

Poniższa procedura ma na celu umożliwienie instancji Essbase łączenie się z dowolnym źródłem danych JDBC za pomocą sterowników wysłanych do serwera Essbase.

Będąc administratorem wdrożenia Essbase, można skonfigurować instancję Essbase tak, aby używała preferowanych sterowników wysłanych do serwera Essbase. Oracle przetestowała zdolność połączeniową Essbase JDBC z użyciem sterowników Oracle. Chcąc używać sterowników JDBC od innych dostawców, należy przejrzeć ich dokumentację pod kątem wymagań w zakresie określania adresu URL i uwierzytelnień dla używanego źródła danych JDBC. W kwestii czynności w zakresie wydajności należy się posłużyć dokumentacją JDBC dostawcy.

Uwaga:

Należy się upewnić, że używany z Essbase sterownik JDBC respektuje metodę setFetchSize kontrolującą pamięć używaną podczas przetwarzania zbioru wyników. Aby zapewnić optymalną wydajność procesów ładowania danych i konstruowania wymiarów, Essbase pobiera na jedno wywołanie sieciowe 1000 rekordów.

Aby skonfigurować Essbase do używania ogólnych sterowników JDBC, należy:

Połączyć się z serwerem Essbase, używając protokołu SSH.
Utworzyć ręcznie katalog drivers w katalogu <Katalog podstawowy produktu Essbase> w instancji serwera.

Upewnić się, że nazwa drivers jest w całości napisana małymi literami, ponieważ w ścieżce jest uwzględniana wielkość liter.
Z serwisu dostawcy pobrać pliki JAR sterowników JDBC, które mają być używane.

Sterownikiem JDBC dla bazy danych Oracle, obsługiwanym przez Essbase, jest ojdbc8.jar.

Jeśli jest używana Autonomous Data Warehouse, trzeba pobrać całe archiwum (ojdbc8-full.tar.gz) zawierające sterownik Oracle JDBC Thin i powiązane z nim pliki JAR.
Wysłać pliki JAR sterowników JDBC do katalogu drivers w instancji Essbase.

Do katalogu drivers należy wysłać tylko jedną wersję poszczególnych sterowników bazy danych. Na przykład nie należy wysyłać jednocześnie plików sqljdbc41.jar i sqljdbc42.jar, gdyż wówczas Essbase użyje starszego (ponieważ pojawi się on jako pierwszy w zmiennej środowiskowej CLASSPATH).

Jeśli jest używana Autonomous Data Warehouse, należy rozpakować archiwum (ojdbc8-full.tar.gz) i przenieść całą zawartość bezpośrednio do katalogu drivers (nie do podkatalogu).
Utworzyć połączenia ze sterownikami JDBC.
1. W internetowym interfejsie Essbase kliknąć kolejno Źródła i Połączenia.
  
  Albo, aby zdefiniować połączenie i źródło danych na poziomie aplikacji, a nie globalnie, zacząć na stronie "Aplikacje", a nie na stronie "Źródła", kliknąć nazwę aplikacji, a następnie kliknąć Źródła.
2. Kliknąć Utwórz połączenie, po czym wybrać opcję JDBC.
  
  Essbase wyszukuje sterownik JDBC w katalogu drivers. Jeśli Essbase nie znajdzie żadnych plików jar, to podczas testowania połączenia zwróci komunikat o błędzie "Nie znaleziono klasy" (lub "Nie udało się załadować sterownika").
3. Na ekranie Tworzenie połączenia:
  1. Podać nazwę połączenia JDBC. Na przykład Oracle JDBC.
  2. W polu "URL" podać opis połączenia JDBC. Na przykład jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Opis połączenia JDBC należy uzyskać od dostawcy JDBC.
    
    Powyższy format składni ma zastosowanie tylko do bazy danych Oracle. W przypadku używania innych dostawców należy przejrzeć temat Więcej przykładów połączeń z użyciem ogólnych sterowników JDBC.
  3. W polach "Użytkownik" i "Hasło" podać uwierzytelnienia użytkownika, który jest autoryzowany do uzyskania dostępu do bazy danych.
  4. W polu "Sterownik" podać w pełni kwalifikowaną nazwę klasy sterownika JDBC. Na przykład oracle.jdbc.driver.OracleDriver.
  Dla sterowników Oracle należy określić URL, korzystając z następujących wskazówek dotyczących składni:
  - Jeśli baza danych Oracle jest zarejestrowana z nasłuchem, to w adresie URL zamiast identyfikatora SID można użyć nazwy usługi, stosując składnię skróconą jdbc:oracle:thin:@<host>:<port>/<nazwa_usługi>. Przykład:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - W poniższym przykładzie nazwa usługi jest używana z zastosowaniem składni pełnej.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - Aby użyć identyfikatora Oracle SID (System ID), który jednoznacznie identyfikuje bazę danych, zastosować składnię jdbc:oracle:thin:@<host>:<port>:<SID>. Na przykład:
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Jeśli jest używana Autonomous Data Warehouse, to w składni adresu URL trzeba zawrzeć zmienną środowiskową TNS_ADMIN, określającą ścieżkę do portfela. Portfel może znajdować się w dowolnym miejscu na komputerze serwera Essbase, ale trzeba podać pełną ścieżkę, używając składni, takiej jak jdbc:oracle:thin:@nazwa_usługi_bazy_danych?TNS_ADMIN=ścieżka_do_portfela.
    
    Przykład dla systemu Linux
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Przykład dla systemu Windows
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    Przykład wdrożenia w OCI
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  Powyższe przykłady działają tylko w bazie danych Oracle. W przypadku używania innych dostawców należy przejrzeć temat Więcej przykładów połączeń z użyciem ogólnych sterowników JDBC.
4. Nacisnąć przycisk Test, aby sprawdzić połączenie; jeśli działa poprawnie, nacisnąć przycisk Utwórz.
5. Sprawdzić, czy połączenie zostało utworzone i pojawia się na liście połączeń.
Utworzyć źródła danych z użyciem połączeń ogólnego sterownika JDBC.
1. Kliknąć na karcie Źródła danych, a następnie nacisnąć przycisk Utwórz źródło danych.
2. W polu rozwijanym Połączenie wybrać nazwę właśnie utworzonego połączenia, na przykład "Oracle JDBC". Połączenia na poziomie aplikacji zaczynają się prefiksem będącym nazwą aplikacji, w formacie nazwaAplikacji.nazwaPołączenia.
3. Podać nazwę źródła danych, na przykład "OracleDB_Datasource".
4. Opcjonalnie: Wprowadzić opis źródła danych; na przykład SAMPLE_BASIC_TABLE z bazy danych Oracle.
5. W polu "Zapytanie" wpisać odpowiednie zapytanie SQL, wybierające dane, które mają być dostępne w tym źródle danych.
6. Kliknąć Dalej. Jeśli instrukcja SQL była poprawna i można było jej użyć w zapytaniu tabeli, kolumny objęte zapytaniem zostaną wypełnione.
7. Zmienić typ wszystkich kolumn liczbowych na "Liczba zmiennoprzecinkowa (Double)", po czym nacisnąć przycisk Dalej.
8. Jeśli trzeba, zmienić dodatkowe parametry specyficzne dla źródła, po czym nacisnąć przycisk Dalej. Informacje dotyczące używania parametrów są dostępne pod hasłem Implementowanie parametrów dla źródeł danych.
9. Przejrzeć zawartość panelu podglądu. Powinny być wyświetlane wyniki zapytania pobierania kolumn z zewnętrznego źródła.
10. Jeśli podgląd wygląda poprawnie, nacisnąć przycisk Utwórz, aby zakończyć tworzenie źródła danych.