Oracle
W tej sekcji wyjaśniono, jak skonfigurować łączność z miejscem docelowym Oracle przy użyciu łącznika miejsca docelowego Oracle. 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 Data Movement gateway, 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
Aby skonfigurować łącznik, wykonaj następujące czynności:
-
W obszarze Połączenia kliknij Utwórz połączenie.
-
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:
-
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
Łą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:
-
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.
-
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
-
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
-
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.
Typy danych Qlik Cloud | Typy danych Oracle |
---|---|
BOOLEAN |
NUMBER (1) |
BYTES |
RAW (długość) |
DATE |
DATETIME |
TIME |
TIMESTAMP (0) |
DATETIME |
Jeśli skala <= 9, to TIMESTAMP (skala) W przeciwnym razie VARCHAR2 (37) |
INT1 |
NUMBER (3) |
INT2 |
NUMBER (5) |
INT4 |
NUMBER (10) |
INT8 |
NUMBER (19) |
NUMERIC |
NUMBER (p,s) |
REAL4 |
BINARY_FLOAT |
REAL8 |
BINARY_DOUBLE |
STRING |
Ze wskazaniem date: DATE Ze wskazaniem time: TIMESTAMP Ze wskazaniem timestamp: TIMESTAMP Ze wskazaniem timestamp_with_timezone: TIMESTAMP WITH TIMEZONE Ze wskazaniem timestamp_with_local_timezone: TIMESTAMP WITH LOCAL TIMEZONE Ze wskazaniem interval_year_to_month: INTERVAL YEAR TO MONTH Ze wskazaniem interval_day_to_second: INTERVAL DAY TO SECOND Jeśli Length > 4000: CLOB We wszystkich pozostałych przypadkach: VARCHAR2 (długość) |
UINT1 |
NUMBER (3) |
UINT2 |
NUMBER (5) |
UINT4 |
NUMBER (10) |
UINT8 |
NUMBER (19) |
WSTRING |
NVARCHAR2 (długość) Należy pamiętać, że jeśli długość jest większa niż 2000, typem danych kolumny będzie NCLOB. |
BLOB |
BLOB Informacja
|
CLOB |
CLOB Informacja
|
NCLOB |
NCLOB Informacja
|
Docelowy typ danych XMLTYPE ma zastosowanie tylko w zadaniach replikacji z Oracle do Oracle. Zobacz uwagę poniżej. |
XMLTYPE |