Oracle

W tej sekcji wyjaśniono, jak skonfigurować łączność z miejscem docelowym Oracle przy użyciu łącznika Oracle Target. Oracle może być miejscem docelowym tylko w zadaniu replikacji. Zanim będzie można się połączyć z miejscem docelowym Oracle, należy skonfigurować Wymagane uprawnienia w bazie danych. Jeśli łączysz się z Oracle przez Brama danych ruchu danych, musisz również zainstalować sterownik zgodnie z opisem w Konfiguracja sterowników.

Aby uzyskać informacje o ograniczeniach i kwestiach do uwzględnienia w związku z używaniem łącznika Oracle, zobacz temat Ograniczenia i uwagi.

Konfiguracja właściwości połączenia

W tej sekcji opisano dostępne właściwości połączenia. Wszystkie właściwości są wymagane, chyba że zaznaczono inaczej.

Miejsce docelowe danych

• Brama danych: Wybierz bramę Brama danych ruchu 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

  • Wymaga bramy Brama danych ruchu danych w wersji 2023.5.10 lub nowszej.

  • Należy też zainstalować odpowiedni sterownik na urządzeniu z Brama danych ruchu danych. 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

User Name i Password: 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 Ruch danych 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 Ruch danych 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 Ruch danych. 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 Ruch danych 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 Ruch danych. 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 Ruch danych 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 Brama danych ruchu danych 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 Brama danych ruchu danych.

Następnie na serwerze Brama danych ruchu danych otwórz wiersz poleceń i wykonaj następujące czynności:

1. Zatrzymaj usługę Brama danych ruchu danych:

   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 <Brama danych ruchu danych-Install-Dir>/bin i dodaj zmienną środowiskową LD_LIBRARY_PATH do katalogu Oracle Instant Client i do katalogu Brama danych ruchu danych 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ę Brama danych ruchu danych:

   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ę Brama danych ruchu danych 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.