Wymagania wstępne
Zanim będzie można umieszczać lub replikować dane, należy spełnić następujące wymagania wstępne:
-
Zainstaluj wymagany driver na serwerze bramy Data Movement gateway
InformacjaJest to wymagane tylko wtedy, gdy pracujesz z bramą Data Movement gateway. Informacje o zaletach bramy Data Movement gateway i o okolicznościach, w których jest wymagana, zawiera temat Qlik Data Gateway - Data Movement.
-
Przyznaj wymagane uprawnienia w źródle danych
-
Skonfiguruj łącznik źródła danych
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:
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
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.
-
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.
-
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:
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
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.
-
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.
-
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:
-
Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika.
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
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:
-
Zatrzymaj usługę Data Movement gateway:
sudo systemctl stop repagent
-
Opcjonalnie potwierdź, że usługa została zatrzymana:
sudo systemctl status repagent
- Zainstaluj sterownik (RPM).
-
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
-
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
-
Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana:
cat site_arep_login.sh
-
Uruchom usługę Data Movement gateway:
sudo systemctl start repagent
-
Opcjonalnie potwierdź, że usługa została uruchomiona:
sudo systemctl status repagent
Status powinien być następujący:
Active: active (running) since <timestamp> ago
Status powinien być następujący:
Active: inactive (dead) since <timestamp> ago
Zapewnij dostęp do konta Oracle
Musisz zapewnić użytkownikowi dostęp do konta OracleData Movement gateway. Ten użytkownik musi mieć uprawnienia do odczytu/zapisu w bazie danych Oracle. Aby uzyskać informacje na temat ustawiania dostępu do konta Oracle, zobacz Wymagane uprawnienia.
Upewnij się, że tryb ARCHIWELOG jest włączony
Oracle może być uruchomiony w dwóch różnych trybach: trybie ARCHIVELOGi trybie NOARCHIVELOG. Aby użyć logów Oracle z Data Movement gateway, uruchom bazę danych w trybieARCHIVELOG. Jeśli dziennik nie jest ustawiony na trybARCHIVELOG, wykonaj następujące zapytanie:
ALTER database ARCHIVELOG
Uwaga: jeśli instancja bazy danych Oracle znajduje się w Amazon RDS, należy wykonać inne polecenie. Więcej informacji zawierają sekcje Włączanie automatycznego wykonywania kopii zapasowych i Konfiguracja archiwizacji
Skonfiguruj logowanie dodatkowe
Logowanie dodatkowe musi być włączone dla bazy danych Oracle, zarówno na poziomie bazy danych, jak i na poziomie tabeli.
W Przenoszenieprzypadku korzystania ze środowiska Oracle standby logowanie dodatkowe musi być skonfigurowane w podstawowej instancji Oracle (jak opisano poniżej), a nie w instancji standby.
Sprawdzanie i włączanie dodatkowego logowania na poziomie bazy danych
-
Wykonaj następujące zapytanie:
SELECT name, value, description FROM v$parameter WHERE name = 'compatible';
Zwrócony wynik powinien wynosić GE to n.n.n gdzie n.n.n jest wersją bazy danych Oracle (np. 10.0.0).
OstrzeżenieWartość parametru musi odpowiadać rzeczywistej wersji bazy danych.
-
Wykonaj następujące zapytanie:
SELECT supplemental_log_data_min FROM v$database;
Zwrócony wynik powinien wynosić YES lub IMPLICIT.
Włącz dodatkowe logowanie, wykonując poniższe zapytanie:
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
InformacjaJeśli instancja bazy danych Oracle znajduje się w Amazon RDS, należy wykonać inne polecenie. Więcej informacji zawiera temat Praca z Amazon RDS for Oracle.
Sprawdzanie i włączanie dodatkowego logowania na poziomie tabeli
-
Aby sprawdzić, czy logowanie dodatkowe jest włączone na poziomie tabeli, wykonaj poniższe zapytanie:
Składnia:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';
Przykład:
select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';
-
Aby udostępnić logowanie dodatkowe na poziomie tabeli, wykonaj poniższe zapytanie:
Składnia:
ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
Przykład:
ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
Zob. także: Wymagane uprawnienia