Oversigt
Tilslutning til en database som Oracle kan være den mest frustrerende del af applikationsinstallation og -konfiguration. De mange tilgængelige muligheder med JDBC- og ODBC-drivere kan være skræmmende. Alene akronymerne er nok til at forårsage hovedpine.
IRI-softwarestakken bruger både JDBC- og ODBC-drivere til forskellige formål. IRI Workbench kræver JDBC-forbindelser for at få adgang til data og metadata i databaser. Brugen af IRI Workbench er helt valgfri. Database-metadata-integrationen plus forskellige guider og editorer gør det meget nemmere at oprette og vedligeholde jobscripts og konfigurationsfiler, der bruges af IRI-databehandlingsmaskinen SortCL.
IRI Workbench, med dets JDBC-forbindelser, er også nødvendigt for at køre IRI DarkShield®, til opdagelse og maskering af semistrukturerede og ustrukturerede datalagre og dokumenter. ODBC-drivere og forbindelser er påkrævet til runtime-udførelse af IRI Voracity® ETL-job og komponentværktøjer som CoSort®, RowGen®, FieldShield® og NextForm®, der også henter og målretter data i databaser.
Instruktionerne og eksemplerne i denne artikel er baseret på Oracle Easy Connect-metoden (EZCONNECT). Hvis dine Oracle-databaser af en eller anden grund ikke kan bruge EZCONNECT, skal du stole på dokumentation leveret af Oracle og andre ressourcer for at konfigurere dine forbindelser.
Samle oplysninger
Der er flere detaljer, som du skal vide om din database, før du konfigurerer en forbindelse. Disse oplysninger bør være tilgængelige fra en databaseadministrator. Hvis du selv administrerer databasen, kan disse oplysninger findes i listener.ora konfigurationsfil.
Indsaml detaljerne vist i tabel 1 for den database, der kræver en forbindelse. Disse oplysninger er nødvendige for både JDBC- og ODBC-forbindelser.
Tabel 1 – Detaljer nødvendige for at oprette en databaseforbindelse.
Mere om de nødvendige oplysninger:
- Værten kan være et værtsnavn eller en IP-adresse. Værtsnavne kan være ét ord, med et underforstået domæne, et fuldt kvalificeret navn inklusive domænet.
- Port er et enkelt heltal. Standarden er 1521, men kan ændres af databaseadministratoren.
- Hver databaseinstans har et SID. SID'et skal være unikt, hvis der er mere end én instans, der deler den samme vært og port. Nogle gange refereres instansen af et servicenavn i stedet for SID. Hvis databasen, som du opretter forbindelse til, har et tjenestenavn, skal du bruge det.
- Brugernavnet skal være det Oracle-brugernavn, der er knyttet til det eller de skemaer, du vil arbejde med. Det er bedst at vælge en bruger med et begrænset omfang af skemaprivilegier. Brug af en SYSTEM-brugerkonto kan resultere i, at et uoverskueligt antal skemaer og tabeller er synlige.
- Adgangskoden skal matche det angivne brugernavn.
Når de korrekte oplysninger er blevet indsamlet, er du klar til at oprette ODBC- og JDBC-forbindelserne.
ODBC
ODBC-manageren og drivere kommer i to-bit-arkitekturer, 32-bit og 64-bit. Bestyrerens og driverens bitarkitektur skal matche bit-arkitekturen af applikationen ved hjælp af forbindelsen. På Windows® er IRI runtime-motorer ofte 32-bit varianten, selv når de kører på et 64-bit operativsystem. På Linux og Unix er 64-bit applikationer gældende.
Før du vælger bit-arkitekturen for dine ODBC-drivere, er det vigtigt at kende bit-arkitekturen for IRI-runtime-produktet ved hjælp af SortCL, som CoSort eller FieldShield. Hvis du er usikker på din IRI-motors bit-arkitektur, kan du tjekke den ved hjælp af versionskommandoen. Form kommandolinjen, udfør:
sortcl /v
I IRI Workbench er Hjælp> Versionsoplysninger menupunktet vil vise de samme resultater. Bitarkitekturen kan findes i versionsstrengen, som vist i tabel 2.
Tabel 2 – Bestemmelse af CoSort bit-arkitektur.
Bestem den korrekte bitarkitektur. Du skal bruge den til at identificere den korrekte ODBC Manager, der skal bruges, og for at downloade og installere de korrekte ODBC-drivere. Brugen af ODBC-administratorer og -drivere på Linux, Unix og Mac er mere kompliceret og ligger uden for denne artikels omfang.
Eksemplerne her vil bruge ODBC Manager leveret af Microsoft med Windows. Hvis du bruger et andet operativsystem og har brug for hjælp, skal du kontakte din IRI-repræsentant.
ODBC-forbindelser identificeres med en unik identifikator kendt som et datakildenavn (DSN). Microsoft leverer ODBC Data Source Administrator program med Windows, til at definere og konfigurere DSN'er.
Det er vigtigt at vælge ODBC Administrator-programmet med den korrekte bitarkitektur for at matche den applikation, der har brug for databaseadgang, og driverne. Vælg programmet fra tabel 3. Det er forvirrende, at 32-bit programmet ligger i mappen SysWOW64, mens 64-bit programmet ligger i mappen System32.
Tabel 3 – ODBC Data Source Administrator-programmer.
Hvis du har en Oracle-databaseserver installeret på din arbejdsstation, har du sandsynligvis allerede en Oracle ODBC-driver installeret. Du kan kontrollere, om der er en Oracle ODBC-driver ved at køre programmet ODBC Data Source Administrator.
Se i Drivere fanen for en post, der ligner den, der er vist i figur 4, Navnet skal start med ordet Oracle . Du kan ikke brug driveren med navnet Microsoft ODBC for Oracle , vil denne ikke arbejde.
Figur 4 – Oracle-driver i ODBC Data Source Administrator-programmet.
Driverne er listet i alfabetisk rækkefølge. Hvis du ikke kan se en Oracle-driver til stede, skal du installere en Oracle-klient. Oracle har en anden version af klienten for hver databaseversion. Typisk kan du bruge en nyere klient med en ældre database, men ikke nødvendigvis omvendt.
Antag, at du vil installere 32-bit-klienten til Oracle 18c. På det tidspunkt, hvor dette dokument blev skrevet, var installationsprogrammet tilgængeligt til download fra Oracle. Gå til downloadsiden, og se efter teksten Oracle Database 18c Client (18.3) til Microsoft Windows x86 (32-bit) , som vist i figur 5.
Download den linkede fil NT_180000_client.zip . Du skal bruge en online Oracle-konto for at downloade klientinstallationsprogrammet; du kan registrere dig gratis, hvis du ikke har et login.
Figur 5 – Oracle-klientdownload, som inkluderer ODBC- og JDBC-drivere.
Pak den downloadede zip-fil ud i en midlertidig mappe for at installere klienten. Gå til den midlertidige mappe, og se i client32 mappe til setup.exe , vil du køre dette program for at installere klienten. Du skal bruge administratorrettigheder for at installere klienten.
Vælg en installationstype som vist i figur 6. For kun ODBC-driveren, JDBC-driveren og SQL*Plus-kommandolinjeværktøjet skal du vælge Instant Client type. Hvis du vil installere alle administrationsværktøjerne, skal du vælge Administrator type.
Følg instruktionerne i installationsguiden. Du kan sandsynligvis acceptere standardværdierne for eventuelle yderligere muligheder. Der er en hjælpeknap i bunden af installationsguiden. For mere hjælp til dette særlige installationsprogram har Oracle yderligere dokumentation tilgængelig online.
Figur 6 – Oracle Client installationstype.
Når du har installeret ODBC-driverne, kan du konfigurere en DSN til en Oracle-databaseforbindelse. Kør ODBC Data Source Administrator-programmet, der er angivet i tabel 3. Vælg fanen for at oprette enten et Bruger-DSN eller et System DSN . et bruger-DSN vil kun være synligt for den bruger, der har oprettet det.
Et system-DSN er synligt for alle brugere af den pågældende arbejdsstation. Det er mest typisk at oprette et bruger-DSN, så vælg den fane. Vælg Tilføj knappen for at oprette en ny forbindelse DSN. Vælg den korrekte Oracle-driver som vist i figur 7, og vælg derefter Udfør knap.
Figur 7 – Valg af Oracle ODBC-driver.
Du vil blive præsenteret for Oracle ODBC Driver Configuration dialog, som den vist i figur 9. Navngiv din forbindelse. Dette er DSN. Det er bedst at undgå mellemrum og tegnsætning i DSN, undtagen muligvis understregninger, bindestreger og punktum.
Gør navnet beskrivende for den database, du opretter forbindelse til. TNS-tjenestenavnet kan variere baseret på den Oracle-forbindelsesmetode, der bruges.
Eksemplet i figur 8 bruger EZCONNECT og eksempeldetaljerne, der blev samlet i tabel 8.
Tabel 8 – Detaljer for et eksempel på en databaseforbindelse.
Formatet for en EZCONNECT-forbindelsesstreng er:vært :port /Tjenestenavn
Bemærk, at der ikke er noget separat sted i dialogboksen til at gemme adgangskoden. Men Oracle giver dig mulighed for at gemme adgangskoden ved at føje den til brugernavnet og adskille den med en skråstreg, som vist i eksempeldetaljerne i figur 9.
Selvom adgangskoden er gemt i almindelig tekst, er DSN kun synlig for den bruger, der er logget på arbejdsstationen på det tidspunkt, og udgør i de fleste tilfælde ikke en væsentlig sikkerhedsrisiko. Hvis du har en it-afdeling med sikkerhedspolitikker, må du muligvis ikke gemme din adgangskode på denne måde. Adgangskoden kan indtastes, når der er oprettet forbindelse.
Det er også muligt at gemme adgangskoden i IRI Workbench, hvor den vil blive anvendt på job, der tilgår dataene via denne DSN. Men hvis det er tilladt, er det den mest bekvemme metode at gemme din adgangskode i DSN som vist nedenfor.
Figur 9 – Driverkonfigurationsdialog med eksempeldetaljer.
Når du har konfigureret disse detaljer, skal du vælge Test forbindelse knap. Forhåbentlig vil du se Forbindelsen lykkedes resultat, som vist i figur 10.
Hvis der er et problem med dine detaljer eller forbindelse, eller du har undladt at gemme adgangskoden, vil du blive præsenteret for Oracle ODBC Driver Connect-dialogen, som vist i figur 11. Dette vil give dig mulighed for at angive manglende detaljer eller ændre detaljerne allerede indtastet.
Hvis redigeringer gør det muligt for forbindelsen at lykkes, skal de anvendes i konfigurationsdialogen vist i figur 9, før du vælger OK . Der er fire faner med muligheder nederst i konfigurationsdialogen. Skift kun disse muligheder, hvis du er sikker på, at de er nødvendige.
Figur 10 – En vellykket forbindelsestest.
Figur 11 – En chance for at prøve andre detaljer eller indtaste en adgangskode.
Nu hvor du forhåbentlig har en fungerende ODBC DSN, kan du oprette en JDBC-forbindelse i IRI Workbench. Du skal oprette en JDBC-forbindelse i IRI Workbench med de samme nøjagtige detaljer, som blev brugt i ODBC DSN. ODBC DSN- og JDBC-forbindelsen vil blive knyttet sammen i præferencerne i IRI Workbench senere.
JDBC
At vælge JDBC-drivere er lidt nemmere end ODBC, da JDBC-drivere ikke har nogen bit-arkitektur. Afhængigt af hvordan du installerede Oracle ODBC-klienten, har du sandsynligvis allerede installeret JDBC-driverne. Se efter en mappe ved navn jdbc , under installationsmappen for Oracle-klienten. Inde i jdbc mappe skal være en mappe med navnet lib , med JDBC java archive (JAR) filer inde. Navnet på JAR-filen, der skal bruges, vil variere afhængigt af Oracle og Java-version, generelt vil du bruge driverfilen med et navn som odbc8 .jar, hvor nummeret vil relatere til den version af Java, der bruges, og kan være anderledes.
Hvis JAR-filerne ikke allerede er installeret af enten databaseserveren eller klientinstallationen, så kan du søge efter en passende download på Oracle-webstedet.
IRI Workbench
IRI Workbench er det integrerede udviklingsmiljø (IDE) bygget på Eclipse™ til at skabe, vedligeholde og udføre jobscripts til alle IRI-produkter. Udover at arbejde med jobs for IRI-produkter som CoSort, RowGen, FieldShield og NextForm, er det også hovedbrugergrænsefladen for Voracity-platformen, som inkluderer dem.
En JDBC-forbindelse i IRI Workbench bruges til mange formål, herunder:
- Undersøgelse af dataværdier for jobdesign, dataklassificering og dataopdagelse.
- Browsing tabel og skemastruktur.
- Automatisk og manuel metadataudtrækning, konvertering og udveksling.
- Udførelse af SQL-kommandoer og -forespørgsler og undersøgelse af resultater.
- Masseudtræk og indlæsning af dataværdier til og fra flade filer.
- Generering af diagrammer for entitetsforhold (ER).
Der er flere måder, hvorpå databaseforbindelser kan oprettes i IRI Workbench. Den mest almindelige måde er med visningen Data Source Explorer (DSE). DSE-visningen er en navigator, normalt forankret langs venstre kant af IRI Workbench-vinduet. Hvis det er blevet lukket, er der to nemme måder at åbne det igen:
- Vælg Vindue> Perspektiv> Nulstil perspektiv i hovedmenuen .
- Vælg Vindue> Vis visning> Datakilde Explorer i hovedmenuen .
En databaseforbindelse i IRI Workbench omtales som en Forbindelsesprofil , nogle gange forkortet til kun Profil . For at oprette en ny profil fra DSE-visningen skal du vælge Ny forbindelsesprofil knappen fra miniværktøjslinjen i visningen, som vist i figur 12.
Figur 12 – Ny forbindelsesprofil værktøjslinjeknap i DSE.
På den første side af Ny forbindelsesprofil guiden, skal du vælge Oracle fra listen over Forbindelsesprofiltyper . Giv profilen et navn, der ligner DSN. Gør det beskrivende, og undgå unødvendigt mellemrum eller tegnsætning. Figur 13 viser denne side med det samme navn, der bruges til ODBC DSN.
Figur 13 – Oracle Connection Profile Wizard-side.
Vælg Næste> knappen for at gå til næste side i guiden. Du skal oprette en ny driverdefinition ved hjælp af ikonknappen som vist i figur 14.
Figur 14 – Knappen Ny driverdefinition.
Ny driverdefinition guiden har tre faner. På den første fane, Navn/Type, vælg Oracle Thin Driver skabelonversion, der matcher din databaseversion. Figur 15 viser valget af skabelonen til Oracle 18c-databasen.
Figur 15 – Fanen Navn/Type på siden med guiden Ny driverdefinition.
Den anden fane, JAR List , er til at specificere JDBC-driverbiblioteksfilen. Vælg den eksisterende JAR-fil i JAR-filerne liste. Vælg derefter knappen Rediger JAR/Zip til højre for at søge efter placeringen af JAR-filen.
Find placeringen af Oracle JDBC-driverbiblioteket, beskrevet i JDBC-afsnittet i dette dokument. Figur 16 viser JAR-listen fanen efter at have fundet JDBC-driverfilen.
Figur 16 – JAR-listen efter placering af JDBC-driverfilen.
Den tredje og sidste fane er driveren Egenskaber fane, vist i figur 17. Den eneste ændring, som du muligvis skal foretage på denne fane, er at tilføje en efterfølgende skråstreg til egenskaben Connection URL, hvis den ikke allerede er til stede.
Figur 17 – Fanen driveregenskaber med den efterfølgende skråstreg på forbindelses-URL'en.
Vælg knappen OK for at fuldføre driverdefinitionen. Nu kan du udfylde egenskaberne for forbindelsesdetaljerne med de samme værdier, som blev brugt fra tabel 8 i afsnittet om oprettelse af ODBC DSN, og vælge Gem adgangskode afkrydsningsfelt.
Figur 18 viser siden Forbindelsesdetaljer, klar til at prøve Test forbindelsen knap. Hvis du ikke kan se en Succes meddelelsesboksen, skal du kontrollere detaljerne i feltet Fejlmeddelelse for yderligere oplysninger. Dette kan indikere et problem med databaseserveren, netværksforbindelsen eller forbindelsesdetaljerne.
Figur 18 – Siden med fuldførte forbindelsesdetaljer, klar til at teste databaseforbindelsen.
Hvis testen er vellykket, kan du vælge Udfør knappen og være forbundet til databasen. Selvom testen mislykkes, vil du muligvis stadig vælge Udfør knappen, vil dette bevare det arbejde, du har udført indtil nu, mens du undersøger fejlen. Du vil være i stand til at redigere forbindelsesprofilens egenskaber senere, løse eventuelle problemer og prøve igen.
Figur 19 viser DSE-visningen efter vellykket tilslutning. Oracle bruger et stort antal interne skemaer, og afhængigt af de privilegier, der er givet til din bruger, kan du se en hel del skemaer udover dem med de dataværdier, der interesserer dig.
Forbindelsesprofilen kan filtreres på skema- og endda tabelniveau. Dette vil gøre det nemmere at finde og arbejde med de dataværdier, der er interessante for dig.
Figur 19 – DSE-visning uden skemafiltrering.
Den enkleste type skemafiltrering vil skjule alle skemaerne undtagen det, der ejes af den konfigurerede bruger. Højreklik på mappen Schemas for at få vist kontekstmenuen. Vælg Egenskaber fra kontekstmenuen, som vist i figur 20.
Figur 20 – Valg af skemaegenskaber fra kontekstmenuen.
Dette vil vise Filteregenskaber dialog, vist i figur 21. Start med at fravælge Deaktiver filter afkrydsningsfelt nær bunden. Udfyld derefter navnet på BRUGER-skemaet i gruppen Udtryk øverst. Vælg knappen Anvend og luk, når du er færdig.
Dette vil muliggøre simpel filtrering, visning og behandling af kun de skemaer, der matcher udtrykket. Meget mere kompleks filtrering kan udføres. Se IRI Blog-artiklen Tabelfiltrering i IRI Workbench for at få flere oplysninger.
Figur 21 – Simpel skemafiltrering.
Opdater skemalisten fra den samme kontekstmenu, der blev brugt før. Det eneste skema, der nu er synligt, er det, der tilhører brugeren, som vist i figur 22.
Figur 22 – DSE-visning efter skemafiltrering.
IRI Data Connection Registry
Det eneste, der skal gøres, er at afstemme ODBC DSN og JDBC-forbindelsesprofilen. Når du opretter jobs i IRI Workbench ved hjælp af JDBC-forbindelsesprofilen, er det nødvendigt at vide, hvilken ODBC DSN der svarer til den samme database og bruger.
Åbn dataforbindelsesregistret i Indstillinger ved at vælge Vindue> Indstillinger fra hovedmenuen. Naviger til IRI> Data Connection Registry i træet på venstre side. Registreringssiden er vist i figur 23.
Figur 23 – Præferencesiden for dataforbindelsesregisteret.
Der skal være en række i tabellen for hver DSN, der er blevet konfigureret i ODBC Data Source Administrator. Hvis du ikke kan se det DSN, der matcher din dataforbindelsesprofil, kan du prøve at vælge Opdater knappen i højre side af siden.
Fremhæv rækken for DSN'et, der skal tilknyttes din dataforbindelsesprofil, og vælg derefter Rediger knappen i højre side af siden. Dette vil vise Data Connection Registry dialog, vist i figur 24.
Figur 24 – Dialogboksen Data Connection Registry.
Du kan eventuelt anvende det samme skemafilter, som blev brugt i dataforbindelsesprofilen. Hvis du ikke gjorde det gemme brugernavnet eller adgangskoden i DSN, kan du eventuelt gemme det i denne dialogboks. Den eneste påkrævede oplysningerne i denne dialog er Forbindelsesprofilen på bunden.
Vælg knappen OK, når du er færdig. Sørg for, at afkrydsningsfeltet i Aktiv kolonnen er valgt, som vist i figur 25, og vælg derefter Anvend og luk knap.
Figur 25 – Korrekt konfigureret DSN-indgang i dataforbindelsesregistret.
Tillykke, du er nu klar til at begynde at arbejde med dataene i din tilsluttede Oracle-database. Se denne indeksside med vejledningsartikler om at arbejde med Oracle (og andre) data fra IRI Workbench.
Ordliste
