# 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](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Permissi) 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](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Driver). Aby uzyskać informacje o ograniczeniach i kwestiach do uwzględnienia w związku z używaniem łącznika Oracle, zobacz temat [Ograniczenia i uwagi](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Limitati). ## Konfiguracja właściwości połączenia 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ą Brama danych ruchu danych 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 Brama danych ruchu danych jest nieobsługiwana na tym poziomie subskrypcji. * Należy też zainstalować odpowiedni sterownik na urządzeniu z Brama danych ruchu danych. Szczegółowe informacje zawiera temat [Konfiguracja sterowników](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Driver) 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](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/oracle-target.htm#Connecti). * 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 the Utwórz nowy icon i the Anuluj icon 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 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 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](https://docs.oracle.com/en/cloud/paas/atp-cloud/atpug/connect-preparing.html#GUID-EFAFA00E-54CC-47C7-8C71-E7868279EF3B) ## 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](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-metadata.htm) ustawień zadania należy podać nową nazwę schematu. * Podczas pracy w trybie [stosowania zoptymalizowanego pod kątem partii](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-replication.htm) 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](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/replicating-settings-metadata.htm). 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 | Typy danych Qlik Cloud | Typy danych Oracle | | --- | --- | | BOOLEAN | LICZBA (1) | | BYTES | RAW (długość) | | DATE | DATETIME | | TIME | ZNACZNIK CZASU (0) | | DATETIME | Jeśli skala <= 9, to TIMESTAMP (skala)

W przeciwnym razie VARCHAR2 (37) | | INT1 | LICZBA (3) | | INT2 | LICZBA (5) | | INT4 | LICZBA (10) | | INT8 | LICZBA (19) | | NUMERIC | LICZBA (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 | LICZBA (3) | | UINT2 | LICZBA (5) | | UINT4 | LICZBA (10) | | UINT8 | NUMER (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 |