Oracle

Aby skonfigurować łącznik, wykonaj następujące czynności:

1. W obszarze Połączenia kliknij Utwórz połączenie.

2. Wybierz łącznik miejsca docelowego Oracle, a następnie podaj następujące ustawienia:

Miejsce docelowe danych

• Brama danych: Podczas pracy z bramą Data Movement gateway wybierz bramę danych, która będzie używana do testowania połączenia z miejscem docelowym Oracle. Powinna to być ta sama brama, która została użyta do uzyskania dostępu do źródła danych.

  Informacja

  • To pole jest niedostępne w subskrypcji Qlik Talend Cloud Starter, ponieważ brama Data Movement gateway jest nieobsługiwana na tym poziomie subskrypcji.

  • Należy też zainstalować odpowiedni sterownik na urządzeniu z Data Movement gateway. Szczegółowe informacje zawiera temat Konfiguracja sterowników poniżej.

• Ciąg połączenia: ciąg połączenia Oracle dla bazy danych Oracle, z którą chcesz pracować.

  Informacja

  • Podczas replikacji do Oracle Autonomous Data Warehouse należy najpierw wykonać procedurę opisaną w temacie Łączenie się z autonomiczną hurtownią danych Oracle .
  • W tych informacjach jest rozróżniana wielkość liter.

Właściwości konta

Nazwa użytkownika i Hasło: nazwa użytkownika i hasło użytkownika uprawnionego do dostępu do bazy danych Oracle Server.

Właściwości wewnętrzne

Właściwości wewnętrzne są przeznaczone dla specjalnych przypadków, w związku z czym nie są ukazywane w oknie dialogowym. Należy ich używać tylko na polecenie Qlik Pomocy technicznej.

Użyj przycisków i znajdujących się po prawej stronie pól, aby dodać lub usunąć właściwości zgodnie z potrzebą.

Nazwa

Nazwa wyświetlana dla połączenia.

Wymagania wstępne

Wymagane uprawnienia

Użytkownik określony w ciągu połączenia musi mieć przyznane następujące uprawnienia w bazie danych Oracle:

• CREATE ANY TABLE

• CREATE ANY INDEXES

• ALTER ANY TABLE

• DROP ANY TABLE

• INSERT ANY TABLE

• UPDATE ANY TABLE

• DELETE ANY TABLE

• SELECT ANY TABLE

• SELECT all_indexes

• SELECT all_ind_columns

• SELECT all_constraints

• SELECT all_cons_columns

• LOCK ANY TABLE

Konfiguracja sterowników

Sterownik driver można zainstalować za pomocą Narzędzia do instalacji sterowników (zalecane) lub ręcznie. Instalacji ręcznej należy próbować tylko w mało prawdopodobnym przypadku wystąpienia problemu z Narzędziem do instalacji sterowników.

Używanie Narzędzia do instalacji sterowników w celu instalacji sterownika

W tej sekcji opisano, jak zainstalować wymagany driver. Proces ten obejmuje uruchomienie skryptu, który automatycznie pobierze, zainstaluje i skonfiguruje wymagany driver. W razie potrzeby można także uruchamiać skrypty, aby zaktualizować i odinstalować driver.

Przygotowanie instalacji

• Na serwerze bramy Data Movement musi być zainstalowane środowisko Python 3.6 lub nowsze.

  Środowisko Python jest preinstalowane w większości dystrybucji systemu Linux. Aby sprawdzić, która wersja środowiska Pythona jest zainstalowana w Twoim systemie, uruchom następujące polecenie:

  python3 --version

Instalowanie aplikacji driver

Aby pobrać i zainstalować driver:

1. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

2. Wykonaj następujące polecenie:

   Składnia:

   ./install oracle

   Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie install oracle.

   W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.

3. Wykonaj jedną z poniższych czynności:

   • Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
   • Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
   • Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.

4. Wykonaj jedną z poniższych czynności:

   • Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.
   • Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.

   • Wpisz „v” i naciśnij klawisz [Enter], aby ponownie wyświetlić umowę licencyjną.

Zostanie zainstalowany driver.

driver — aktualizacja

Uruchom polecenie aktualizacji, jeśli chcesz odinstalować driver w poprzedniej wersji, zanim zainstalujesz dostarczony driver.

Aby pobrać i zaktualizować driver:

1. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

2. Wykonaj następujące polecenie:

   Składnia:

   ./update oracle

   Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie update oracle.

   W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.

3. Wykonaj jedną z poniższych czynności:

   • Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
   • Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
   • Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.

4. Wykonaj jedną z poniższych czynności:

   • Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.
   • Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.
   • Wpisz „v” i naciśnij klawisz [Enter], aby wyświetlić umowę licencyjną od początku.

Stary driver zostanie odinstalowany, a zainstalowany zostanie nowy driver.

driver — odinstalowywanie

Uruchom polecenie odinstalowania, jeśli chcesz odinstalować driver.

Aby odinstalować driver:

1. Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika.

2. Na urządzenie bramy Data Movement zmień katalog roboczy na:

   opt/qlik/gateway/movement/drivers/bin

3. Wykonaj następujące polecenie:

   Składnia:

   ./uninstall oracle

   Sterownik driverzostanie odinstalowany.

Instalowanie sterownika ręcznie

Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie.

Po zainstalowaniu Data Movement gateway pobierz sterownik oracle-instantclient-basiclite-<wersja>.x86_64.rpm. Łącze do bezpośredniego pobrania obsługiwanej wersji można znaleźć w sekcji binary-artifacts w pliku /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Po zakończeniu pobierania skopiuj plik RPM na komputer z Data Movement gateway.

Następnie na serwerze Data Movement gateway otwórz wiersz poleceń i wykonaj następujące czynności:

1. Zatrzymaj usługę Data Movement gateway:

   sudo systemctl stop repagent

2. Opcjonalnie potwierdź, że usługa została zatrzymana:

   sudo systemctl status repagent

Status powinien być następujący:

Active: inactive (dead) since <timestamp> ago

3. Zainstaluj sterownik (RPM).

4. Dodatkowo, jeśli nie ma go jeszcze w systemie, utwórz symboliczny link $Oracle_Home\lib w katalogu. Nadaj nazwę łącza libclntsh.so i wskaż na konkretną wersję tego pliku.

   Przykład:

   lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

5. Zmień katalog roboczy na <Data Movement gateway-Install-Dir>/bin i dodaj zmienną środowiskową LD_LIBRARY_PATH do katalogu Oracle Instant Client i do katalogu Data Movement gateway lib, kopiując lokalizację sterownika do pliku site_arep_login.sh:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

6. Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana:

   cat site_arep_login.sh

7. Uruchom usługę Data Movement gateway:

   sudo systemctl start repagent

8. Opcjonalnie potwierdź, że usługa została uruchomiona:

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

Łączenie się z autonomiczną hurtownią danych Oracle

Podczas replikacji do Oracle Autonomous Data Warehouse należy wykonać następującą procedurę.

Aby skonfigurować połączenie z Oracle Autonomous Data Warehouse (ADW), potrzebny jest plik ZIP Client Credentials (Wallet), który został pobrany podczas konfigurowania środowiska Oracle Autonomous Data Warehouse.

Aby włączyć bramę Qlik Talend Data Integration w celu połączenia z Oracle Autonomous Data Warehouse:

1. Wyodrębnij zawartość pliku ZIP Client Credentials do wybranego folderu.

   Może to być dowolny folder, ale na potrzeby tej procedury /home/adw_credentials będzie folderem systemu Linux zawierającym wyodrębnione pliki.

2. W folderze zawierającym wyodrębnione pliki edytuj plik sqlnet.ora, zastępując ?/network/admin ścieżką do folderu zawierającego wyodrębnione pliki:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="/home/adw_credentials")))

   SSL_SERVER_DN_MATCH=yes

3. Utwórz zmienną środowiskową TNS_ADMIN i ustaw ją na lokalizację pliku poświadczeń.

   Wykonaj następujące polecenia:

   export TNS_ADMIN=/home/adw_credentials

   export PATH=$TNS_ADMIN:$PATH

4. W polu Ciąg połączenia łącznika miejsca docelowego Oracle wprowadź jedną z nazw z pliku tnsnames.ora.

Aby uzyskać więcej informacji na temat konfigurowania połączenia z Oracle ADW, zobacz temat:

Connect Autonomous Transaction Processing Using a Client Application

Ograniczenia i uwagi

W przypadku używania Oracle jako miejsca docelowego replikacji obowiązują następujące ograniczenia:

• Nie można tworzyć nowych schematów w bazie danych Oracle. Aby można było przeprowadzić replikację do nowego schematu, nazwa nowego schematu musi już istnieć w docelowej bazie danych. Następnie na karcie Metadata ustawień zadania należy podać nową nazwę schematu.

• Podczas pracy w trybie stosowania zoptymalizowanego pod kątem partii puste kolumny LOB mogą być replikowane jako wartości NULL.

• Jeśli po zakończeniu pełnego ładowania włączona jest opcja Ogranicz rozmiar LOB do, a tabela zawiera dane NCLOB, rozmiar NCLOB w obiekcie docelowym zostanie obcięty do połowy rozmiaru określonego w polu Ogranicz rozmiar LOB do. CDC nadal będzie go obcinać zgodnie z limitem.

Typy danych

Informacje o natywnym typie danych są zachowywane i wyświetlane w widokach zestawu danych w kolumnie Natywny typ danych. Jeśli kolumna nie jest widoczna, otwórz selektor kolumn w widoku zestawu danych i wybierz kolumnę Natywny typ danych.