Przegląd
Łączenie się z bazą danych, taką jak Oracle, może być najbardziej frustrującą częścią instalacji i konfiguracji aplikacji. Wiele opcji dostępnych ze sterownikami JDBC i ODBC może być zniechęcających. Same akronimy wystarczą, aby wywołać ból głowy.
Stos oprogramowania IRI wykorzystuje zarówno sterowniki JDBC, jak i ODBC do różnych celów. IRI Workbench wymaga połączeń JDBC w celu uzyskania dostępu do danych i metadanych w bazach danych. Korzystanie z IRI Workbench jest całkowicie opcjonalne. Jednak integracja metadanych bazy danych oraz różne kreatory i edytory znacznie ułatwiają tworzenie i obsługę skryptów zadań i plików konfiguracyjnych używanych przez silnik przetwarzania danych IRI, SortCL.
IRI Workbench, wraz z połączeniami JDBC, jest również niezbędny do działania IRI DarkShield®, do wykrywania i maskowania magazynów danych i dokumentów o częściowo ustrukturyzowanej i nieustrukturyzowanej. Sterowniki i połączenia ODBC są wymagane do wykonywania zadań IRI Voracity® ETL w czasie wykonywania, a także narzędzi składowych, takich jak CoSort®, RowGen®, FieldShield® i NextForm®, które również pozyskują i kierują dane w bazach danych.
Instrukcje i przykłady w tym artykule są oparte na metodzie Oracle Easy Connect (EZCONNECT). Jeśli z jakiegokolwiek powodu Twoje bazy danych Oracle nie mogą korzystać z EZCONNECT, będziesz musiał polegać na dokumentacji dostarczonej przez Oracle i innych zasobach, aby skonfigurować połączenia.
Zbierz informacje
Jest kilka szczegółów dotyczących bazy danych, które musisz znać przed konfiguracją jakiegokolwiek połączenia. Informacje te powinny być dostępne u administratora bazy danych. Jeśli samodzielnie administrujesz bazą danych, informacje te można znaleźć w listener.ora plik konfiguracyjny.
Zbierz dane przedstawione w tabeli 1 dla bazy danych, która wymaga połączenia. Informacje te są potrzebne zarówno w przypadku połączeń JDBC, jak i ODBC.
Tabela 1 – Szczegóły potrzebne do utworzenia połączenia z bazą danych.
Więcej informacji o potrzebnych informacjach:
- Host może być nazwą hosta lub adresem IP. Nazwy hostów mogą składać się z jednego słowa, z domniemaną domeną, w pełni kwalifikowaną nazwą zawierającą domenę.
- Port to pojedyncza liczba całkowita. Wartość domyślna to 1521, ale administrator bazy danych może ją zmienić.
- Każda instancja bazy danych ma identyfikator SID. Identyfikator SID musi być unikalny, jeśli istnieje więcej niż jedna instancja współdzieląca ten sam host i port. Czasami do wystąpienia odwołuje się nazwa usługi zamiast identyfikatora SID. Jeśli baza danych, z którą się łączysz, ma nazwę usługi, powinieneś jej użyć.
- Nazwa użytkownika powinna być nazwą użytkownika Oracle powiązaną ze schematem lub schematami, z którymi będziesz pracować. Najlepiej wybrać użytkownika z ograniczonym zakresem uprawnień do schematu. Korzystanie z konta użytkownika SYSTEM może spowodować, że niemożliwa do zarządzania liczba schematów i tabel będzie widoczna.
- Hasło musi pasować do określonej nazwy użytkownika.
Po zebraniu prawidłowych informacji możesz rozpocząć tworzenie połączeń ODBC i JDBC.
ODBC
Menedżer ODBC i sterowniki są dostępne w dwóch architekturach, 32-bitowej i 64-bitowej. Architektura bitowa menedżera i kierowcy musi dopasować architekturę bitową aplikacji korzystającej z połączenia. W systemie Windows® silniki wykonawcze IRI są często 32-bitowe, nawet jeśli działają w 64-bitowym systemie operacyjnym. W systemach Linux i Unix przeważają aplikacje 64-bitowe.
Przed wybraniem architektury bitowej sterowników ODBC ważne jest, aby znać architekturę bitową produktu wykonawczego IRI przy użyciu SortCL, takiego jak CoSort lub FieldShield. Jeśli nie masz pewności co do architektury bitowej swojego silnika IRI, możesz to sprawdzić za pomocą polecenia wersji. Z wiersza poleceń wykonaj:
sortcl /v
W IRI Workbench Pomoc> Informacje o wersji pozycja menu wyświetli te same wyniki. Architekturę bitową można znaleźć w ciągu wersji, jak pokazano w Tabeli 2.
Tabela 2 – Określanie architektury bitowej CoSort.
Określ poprawną architekturę bitową. Będzie on potrzebny do zidentyfikowania właściwego Menedżera ODBC do użycia oraz do pobrania i zainstalowania odpowiednich sterowników ODBC. Korzystanie z menedżerów ODBC i sterowników w systemach Linux, Unix i Mac jest bardziej skomplikowane i wykracza poza zakres tego artykułu.
W przedstawionych tu przykładach zostanie użyty Menedżer ODBC dostarczony przez firmę Microsoft z systemem Windows. Jeśli używasz innego systemu operacyjnego i potrzebujesz pomocy, skontaktuj się z przedstawicielem IRI.
Połączenia ODBC są identyfikowane za pomocą unikalnego identyfikatora znanego jako nazwa źródła danych (DSN). Firma Microsoft dostarcza Administratora źródeł danych ODBC program z systemem Windows do definiowania i konfigurowania nazw DSN.
Ważne jest, aby wybrać program administratora ODBC z odpowiednią architekturą bitową, pasującą do aplikacji wymagającej dostępu do bazy danych i sterowników. Wybierz program z Tabeli 3. Mylące jest to, że program 32-bitowy znajduje się w folderze SysWOW64, podczas gdy program 64-bitowy znajduje się w folderze System32.
Tabela 3 – Programy administratora źródeł danych ODBC.
Jeśli masz zainstalowany serwer bazy danych Oracle na swojej stacji roboczej, prawdopodobnie masz już zainstalowany sterownik ODBC Oracle. Obecność sterownika Oracle ODBC można sprawdzić, uruchamiając program ODBC Data Source Administrator.
Zajrzyj do Sterowników tab dla wpisu podobnego do pokazanego na Rysunku 4, Nazwa musi zacznij od słowa Oracle . Nie możesz użyj sterownika o nazwie Microsoft ODBC for Oracle , ten nie praca.
Rysunek 4 – Sterownik Oracle w programie ODBC Data Source Administrator.
Sterowniki są wymienione w kolejności alfabetycznej. Jeśli nie widzisz sterownika Oracle, musisz zainstalować klienta Oracle. Oracle ma inną wersję klienta dla każdej wersji bazy danych. Zazwyczaj można użyć nowszego klienta ze starszą bazą danych, ale niekoniecznie odwrotnie.
Załóżmy, że chcesz zainstalować 32-bitowego klienta dla Oracle 18c. W momencie pisania tego dokumentu instalator był dostępny do pobrania z firmy Oracle. Przejdź do strony pobierania i poszukaj tekstu Oracle Database 18c Client (18.3) dla Microsoft Windows x86 (32-bit) , jak pokazano na rysunku 5.
Pobierz połączony plik NT_180000_client.zip . Do pobrania instalatora klienta potrzebne jest internetowe konto Oracle; możesz zarejestrować się za darmo, jeśli nie masz loginu.
Rysunek 5 – Pobieranie klienta Oracle, który zawiera sterowniki ODBC i JDBC.
Rozpakuj pobrany plik zip do folderu tymczasowego, aby zainstalować klienta. Przejdź do folderu tymczasowego i zajrzyj do client32 folder dla setup.exe , uruchomisz ten program, aby zainstalować klienta. Do zainstalowania klienta potrzebne są uprawnienia administratora.
Wybierz typ instalacji, jak pokazano na rysunku 6. Dla samego sterownika ODBC, sterownika JDBC i narzędzia wiersza poleceń SQL*Plus wybierz Klient błyskawiczny rodzaj. Jeśli chcesz zainstalować wszystkie narzędzia do zarządzania, wybierz Administratora rodzaj.
Postępuj zgodnie z instrukcjami kreatora instalatora. Prawdopodobnie możesz zaakceptować wartości domyślne dla wszelkich dodatkowych opcji. Na dole kreatora instalatora znajduje się przycisk pomocy. Aby uzyskać dalszą pomoc dotyczącą tego konkretnego instalatora, Oracle udostępnia dodatkową dokumentację dostępną online.
Rysunek 6 – Typ instalacji klienta Oracle.
Po zainstalowaniu sterowników ODBC można skonfigurować DSN dla połączenia z bazą danych Oracle. Uruchom program Administrator źródeł danych ODBC określony w tabeli 3. Wybierz kartę, aby utworzyć DSN użytkownika lub Systemowe DSN . DSN użytkownika będzie widoczne tylko dla użytkownika, który go utworzył.
Systemowe DSN jest widoczne dla wszystkich użytkowników tej stacji roboczej. Najbardziej typowe jest tworzenie DSN użytkownika, więc wybierz tę kartę. Wybierz Dodaj przycisk, aby utworzyć nowe połączenie DSN. Wybierz właściwy sterownik Oracle, jak pokazano na rysunku 7, a następnie wybierz Zakończ przycisk.
Rysunek 7 – Wybór sterownika Oracle ODBC.
Zostanie wyświetlona Konfiguracja sterownika Oracle ODBC okno dialogowe, takie jak pokazane na rysunku 9. Nazwij swoje połączenie. To jest DSN. Najlepiej jest unikać spacji i znaków interpunkcyjnych w DSN, z wyjątkiem ewentualnych podkreśleń, myślników i kropek.
Podaj nazwę opisującą bazę danych, z którą się łączysz. Nazwa usługi TNS może się różnić w zależności od używanej metody połączenia Oracle.
Przykład na rysunku 8 wykorzystuje EZCONNECT, a przykładowe szczegóły zebrane w tabeli 8.
Tabela 8 – Szczegóły przykładowego połączenia z bazą danych.
Format ciągu połączenia EZCONNECT to:host :port /Nazwa usługi
Zauważ, że w oknie dialogowym nie ma osobnego miejsca na zapisanie hasła. Ale Oracle umożliwia zapisanie hasła przez dodanie go do nazwy użytkownika, oddzielając je ukośnikiem, jak pokazano w przykładowych szczegółach na rysunku 9.
Chociaż hasło jest przechowywane w postaci zwykłego tekstu, DSN jest widoczne tylko dla użytkownika, który jest w danym momencie zalogowany na stacji roboczej iw większości przypadków nie stanowi znaczącego zagrożenia bezpieczeństwa. Jeśli masz dział IT z zasadami bezpieczeństwa, możesz nie mieć możliwości przechowywania hasła w ten sposób. Hasło można wpisać za każdym razem, gdy nawiązywane jest połączenie.
Możliwe jest również przechowywanie hasła w IRI Workbench, gdzie będzie stosowane do zadań, które uzyskują dostęp do danych za pośrednictwem tego DSN. Jeśli jednak jest to dozwolone, zapisanie hasła w DSN, jak pokazano poniżej, jest najwygodniejszą metodą.
Rysunek 9 – Okno dialogowe konfiguracji sterownika z przykładowymi szczegółami.
Po skonfigurowaniu tych szczegółów wybierz Testuj połączenie przycisk. Mamy nadzieję, że zobaczysz komunikat Połączenie powiodło się wynik, jak pokazano na rysunku 10.
Jeśli wystąpi problem z danymi lub połączeniem albo pominięto zapisanie hasła, zostanie wyświetlone okno dialogowe Oracle ODBC Driver Connect, jak pokazano na rysunku 11. Daje to możliwość uzupełnienia brakujących danych lub zmiany szczegóły już wprowadzone.
Jeśli edycje umożliwią pomyślne połączenie, będą musiały zostać zastosowane w oknie dialogowym konfiguracji pokazanym na Rysunku 9 przed wybraniem OK . Na dole okna konfiguracji znajdują się cztery zakładki opcji. Zmień te opcje tylko wtedy, gdy masz pewność, że są potrzebne.
Rysunek 10 – Pomyślny test połączenia.
Ilustracja 11 – Szansa na wypróbowanie innych szczegółów lub wprowadzenie hasła.
Teraz, gdy miejmy nadzieję, że masz działające DSN ODBC, możesz skonfigurować połączenie JDBC w IRI Workbench. Musisz utworzyć połączenie JDBC w IRI Workbench z tymi samymi szczegółami, które zostały użyte w ODBC DSN. Połączenie ODBC DSN i JDBC zostanie później połączone w preferencjach w IRI Workbench.
JDBC
Wybór sterowników JDBC jest nieco łatwiejszy niż ODBC, ponieważ sterowniki JDBC nie mają żadnej architektury bitowej. W zależności od tego, jak zainstalowałeś klienta Oracle ODBC, prawdopodobnie masz już zainstalowane sterowniki JDBC. Poszukaj folderu o nazwie jdbc , w folderze instalacyjnym klienta Oracle. Wewnątrz jdbc folder powinien być folderem o nazwie lib , z plikami archiwum Java JDBC (JAR). Nazwa pliku JAR do użycia będzie się różnić w zależności od wersji Oracle i Java, ogólnie będziesz używać pliku sterownika o nazwie takiej jak odbc8 .jar, gdzie liczba będzie odnosić się do używanej wersji Javy i może być inna.
Jeśli pliki JAR nie są jeszcze zainstalowane przez serwer bazy danych lub instalację klienta, możesz wyszukać odpowiedni plik do pobrania na stronie Oracle.
Stół warsztatowy IRI
IRI Workbench to zintegrowane środowisko programistyczne (IDE) zbudowane na platformie Eclipse™ do tworzenia, utrzymywania i wykonywania skryptów zadań dla wszystkich produktów IRI. Oprócz pracy z zadaniami dla produktów IRI, takich jak CoSort, RowGen, FieldShield i NextForm, jest to również główny interfejs użytkownika dla platformy Vorcity, która je obejmuje.
Połączenie JDBC w IRI Workbench jest używane do wielu celów, w tym:
- Badanie wartości danych pod kątem projektowania zadań, klasyfikacji danych i wykrywania danych.
- Przeglądanie tabeli i struktury schematu.
- Automatyczne i ręczne wyodrębnianie, konwersja i wymiana metadanych.
- Wykonywanie poleceń i zapytań SQL oraz sprawdzanie wyników.
- Zbiorcze wyodrębnianie i ładowanie wartości danych do iz plików płaskich.
- Generowanie diagramów relacji encji (ER).
Istnieje kilka sposobów tworzenia połączeń z bazą danych w IRI Workbench. Najpopularniejszym sposobem jest użycie widoku Eksplorator źródeł danych (DSE). Widok DSE to nawigator, zwykle zadokowany wzdłuż lewej krawędzi okna IRI Workbench. Jeśli został zamknięty, istnieją dwa proste sposoby, aby go ponownie otworzyć:
- Z menu głównego wybierz Okno> Perspektywa> Resetuj perspektywę .
- Z menu głównego wybierz Okno> Pokaż widok> Eksplorator źródeł danych .
Połączenie z bazą danych w IRI Workbench jest określane jako Profil połączenia , czasami skracane do Profilu . Aby utworzyć nowy profil z widoku DSE, wybierz Nowy profil połączenia z minipaska narzędzi w widoku, jak pokazano na rysunku 12.
Rysunek 12 – przycisk paska narzędzi Nowy profil połączenia w DSE.
Na pierwszej stronie Nowego profilu połączenia kreatora, wybierz Oracle z listy Typy profili połączeń . Nadaj profilowi nazwę podobną do DSN. Postaraj się, aby była opisowa i unikaj zbędnych spacji lub znaków interpunkcyjnych. Rysunek 13 pokazuje tę stronę o tej samej nazwie, która jest używana dla ODBC DSN.
Rysunek 13 – strona kreatora Oracle Connection Profile.
Wybierz Dalej> przycisk, aby przejść do następnej strony kreatora. Musisz utworzyć nową definicję sterownika za pomocą przycisku ikony, jak pokazano na rysunku 14.
Rysunek 14 – przycisk Definicja nowego sterownika.
Definicja nowego sterownika kreator ma trzy zakładki. Na pierwszej karcie Nazwa/Typ wybierz cienki sterownik Oracle wersja szablonu zgodna z wersją bazy danych. Rysunek 15 pokazuje wybór szablonu dla bazy danych Oracle 18c.
Rysunek 15 – Karta Nazwa/Typ na stronie kreatora Definicja nowego sterownika.
Druga zakładka, Lista JAR , służy do określenia pliku biblioteki sterownika JDBC. Wybierz istniejący plik JAR w plikach JAR lista. Następnie wybierz przycisk Edytuj JAR/Zip po prawej stronie, aby wyszukać lokalizację pliku JAR.
Znajdź lokalizację biblioteki sterownika Oracle JDBC, omówionej w sekcji JDBC tego dokumentu. Rysunek 16 pokazuje listę JAR po zlokalizowaniu pliku sterownika JDBC.
Rysunek 16 – Lista JAR po lokalizacji pliku sterownika JDBC.
Trzecia i ostatnia zakładka to Właściwości sterownika pokazana na Rysunku 17. Jedyną zmianą, jaką możesz potrzebować na tej karcie, jest dodanie końcowego ukośnika do właściwości URL połączenia, jeśli nie jest on jeszcze obecny.
Rysunek 17 – Karta właściwości sterownika z końcowym ukośnikiem w adresie URL połączenia.
Wybierz przycisk OK, aby zakończyć definicję sterownika. Teraz możesz wypełnić właściwości szczegółów połączenia tymi samymi wartościami, które zostały użyte z Tabeli 8 w sekcji tworzenia ODBC DSN i wybrać Zapisz hasło pole wyboru.
Rysunek 18 pokazuje stronę Szczegóły połączenia, wszystko gotowe do wypróbowania Testu połączenia przycisk. Jeśli nie widzisz Sukcesu pole komunikatu, sprawdź szczegóły w polu Komunikat o błędzie, aby uzyskać dodatkowe informacje. Może to wskazywać na problem z serwerem bazy danych, połączeniem sieciowym lub szczegółami połączenia.
Rysunek 18 – Ukończona strona szczegółów połączenia, gotowa do przetestowania połączenia z bazą danych.
Jeśli test się powiedzie, możesz wybrać Zakończ i połączyć się z bazą danych. Nawet jeśli test się nie powiedzie, nadal możesz wybrać opcję Zakończ przycisk, spowoduje to zachowanie dotychczas wykonanej pracy podczas badania błędu. Będziesz mógł później edytować właściwości profilu połączenia, naprawić wszelkie problemy i spróbować ponownie.
Rysunek 19 przedstawia widok DSE po pomyślnym połączeniu. Oracle używa dużej liczby schematów wewnętrznych i w zależności od uprawnień przyznanych użytkownikowi, możesz zobaczyć sporo schematów oprócz tych z wartościami danych, które Cię interesują.
Profil połączenia można filtrować na poziomie schematu, a nawet tabeli. Ułatwi to zlokalizowanie interesujących Cię wartości danych i pracę z nimi.
Rysunek 19 – Widok DSE bez filtrowania schematu.
Najprostszy typ filtrowania schematów ukryje wszystkie schematy z wyjątkiem jednego, którego właścicielem jest skonfigurowany użytkownik. Kliknij prawym przyciskiem myszy folder Schematy, aby wyświetlić menu kontekstowe. Wybierz Właściwości z menu kontekstowego, jak pokazano na rysunku 20.
Rysunek 20 – Wybieranie właściwości schematu z menu kontekstowego.
Spowoduje to wyświetlenie Właściwości filtra pokazane na rysunku 21. Zacznij od odznaczenia opcji Wyłącz filtr pole wyboru u dołu. Następnie wpisz nazwę schematu USER w grupie Expression u góry. Po zakończeniu wybierz przycisk Zastosuj i zamknij.
Umożliwi to proste filtrowanie, wyświetlanie i przetwarzanie tylko tych schematów, które pasują do wyrażenia. Można przeprowadzić znacznie bardziej złożone filtrowanie. Więcej informacji znajdziesz w artykule IRI Blog Filtrowanie tabel w IRI Workbench.
Rysunek 21 – Proste filtrowanie schematów.
Odśwież listę schematów z tego samego menu kontekstowego, które było używane wcześniej. Jedynym widocznym teraz schematem jest ten należący do użytkownika, jak pokazano na rysunku 22.
Rysunek 22 – Widok DSE po filtrowaniu schematu.
Rejestr połączeń danych IRI
Pozostaje tylko pogodzić DSN ODBC i profil połączenia JDBC. Podczas tworzenia zadań w IRI Workbench przy użyciu profilu połączenia JDBC należy wiedzieć, które DSN ODBC odpowiada tej samej bazie danych i użytkownikowi.
Otwórz Rejestr połączenia danych w Preferencjach, wybierając Okno> Preferencje z menu głównego. Przejdź do IRI> Rejestr połączeń danych na drzewie po lewej stronie. Strona rejestru jest pokazana na rysunku 23.
Rysunek 23 – Strona preferencji Rejestr połączeń danych.
W tabeli powinien znajdować się wiersz dla każdego DSN, który został skonfigurowany w Administratorze źródeł danych ODBC. Jeśli nie widzisz nazwy DSN odpowiadającej Twojemu profilowi połączenia danych, spróbuj wybrać opcję Odśwież po prawej stronie strony.
Zaznacz wiersz DSN, który powinien być zmapowany na Twój profil połączenia danych, a następnie wybierz Edytuj po prawej stronie strony. Spowoduje to wyświetlenie Rejestru połączeń danych pokazane na rysunku 24.
Rysunek 24 – Okno dialogowe Rejestr połączenia danych.
Opcjonalnie można zastosować ten sam filtr schematu, który był używany w profilu połączenia danych. Jeśli nie zapisz nazwę użytkownika lub hasło w DSN, możesz opcjonalnie zapisać je w tym oknie dialogowym. Jedyny wymagany informacje w tym oknie to Profil połączenia na dnie.
Po zakończeniu wybierz przycisk OK. Upewnij się, że pole wyboru w Aktywne kolumna jest zaznaczona, jak pokazano na Rysunku 25, a następnie wybierz Zastosuj i zamknij przycisk.
Rysunek 25 – Prawidłowo skonfigurowany wpis DSN w rejestrze połączeń danych.
Gratulacje, jesteś teraz gotowy do rozpoczęcia pracy z danymi w połączonej bazie danych Oracle. Zobacz tę stronę indeksu artykułów na blogu instruktażowych dotyczących pracy z danymi Oracle (i innymi) z IRI Workbench.
Słownik
