Introduktion
Formålet med denne vejledning er at give de nødvendige trin for at installere Oracle SQL Developer på MacOSX-operativsystemet. Lignende instruktioner til installation af Oracle SQL Developer på Windows kan findes på dette link. Denne tutorial blev oprettet ved hjælp af MacOSX Mojave (version 10.14).
Oracle SQL Developer er et kraftfuldt udviklingsværktøj med mange funktioner til at interagere med Oracle-databaser. Ud over at skrive og indsende SQL-sætninger ved hjælp af SQL-regnearket har SQL Developer kraftfulde værktøjer til at administrere databaser, designe og reverse engineering af databaser ved hjælp af datamodeller og køre datamining-job. Den seneste version (version 19.4 pr. 20. december 2019) indeholder nogle grundlæggende databaseadministrationsværktøjer, understøttelse af REST-forespørgsler og parsing af JSON-dokumenter.
Oracle SQL Developer kræver, at en passende version af Java er installeret. Dette er måske den mest forvirrende del af at få SQL Developer til at arbejde på MacOSX. Trin til installation af et passende Java Development Kit (JDK) er beskrevet på næste side.
Efter installation af JDK, dækker næste afsnit af denne tutorial download og installation af SQL Developer. Hvis du allerede har downloadet og installeret SQL Developer, vil du måske springe videre til denne side for at lære, hvordan du opretter en ny databaseforbindelse.
Mod slutningen af dette selvstudie er der et par sider, der dækker, hvordan man skriver, kører og gemmer SQL-sætninger, hvordan man eksporterer data ved hjælp af SQL Developer, og hvordan man importerer data til Oracle ved hjælp af SQL Developer. Du kan også være interesseret i at bruge SQL Developer til at reverse engineering af et Oracle-skema. Det selvstudie er linket her.
Installation og konfiguration af Java på MacOSX
Oracle SQL Developer kræver, at et Java Runtime Environment (JRE) eller Java Development Kit (JDK) er installeret på MacOSX-operativsystemet. Afhængigt af hvilken version af MacOSX du kører, kan du desværre have en Java-version, der enten er for ny, for gammel eller slet ikke installeret. Så vidt jeg ved, skitserer det følgende, hvad du kan forvente givet din MacOSX-version.
Mac OS X version 10.6 og tidligere leveres med Apples Java Runtime Environment. Det kan være en ældre JRE såsom JRE 6 eller JRE 7. Disse vil ikke fungere med den nuværende version af Oracle SQL Developer (version 18 eller 19), og derfor skal en nyere version af Java såsom version 8 eller 11 være installeret.
Mac OS X version 10.7 og nyere leveres slet ikke med en JRE eller JDK installeret.
For at installere Java skal du besøge Oracle Java-downloadsiden
https://www.oracle.com/technetwork/java/javase/downloads/index.html
Bemærk, at den seneste version af Java vil blive vist øverst. Fra september 2019 vil Java version 12 ikke fungere med Oracle SQL Developer version 19.
Rul ned til afsnittet for Java SE 8.
Klik på knappen Download for JDK (Java Development Kit)
Klik på alternativknappen for at acceptere licensbetingelserne, og find derefter det rigtige filnavn til MacOSX. Klik på filnavnet for at starte downloadprocessen. I dette eksempel blev JDK version 8 opdatering 221 valgt, så filnavnet er:jdk-8u221-macosx-x64.dmg.
Hvis dette er dit første besøg på et Oracle-websted, bliver du bedt om at logge ind. Hvis du ikke har et Oracle-websted-login, skal du klikke på Opret konto knappen og følg disse instruktioner for at oprette din konto. Hvis du allerede har et Oracle-websted-login, skal du indtaste disse legitimationsoplysninger og klikke på Log ind knap. På det tidspunkt skulle overførslen begynde. Når overførslen er færdig, skal du klikke på ikonet Downloads og derefter klikke på JDK-filnavnet:jdk-8u221-macosx-x64.dmg
Efter at have klikket på .dmg-filen i mappen Downloads, vil filen blive åbnet.
Når den downloadede fil er åbnet, vises .pkg-installationsfilen i sin egen mappe som vist nedenfor. Dobbeltklik på denne .pkg-installationsfil for at starte JDK Installer.
Hvis der vises en fejl vedrørende "JDK Update xxx kan ikke åbnes, fordi Apple ikke kan tjekke den for skadelig software", skal du ændre dine indstillinger i henhold til denne artikel fra Apple.
Den første skærm i JDK Installer er en informationsskærm. Klik på knappen Fortsæt.
Det næste skærmbillede giver en indikation af mængden af diskplads, der vil blive brugt. Sørg for, at du mindst har så meget ledig diskplads, og klik derefter på knappen Fortsæt.
Du bliver derefter bedt om dit lokale MacOS X-kontonavn og din adgangskode. Dette vil give installationsprogrammet tilladelse til at fortsætte med at installere JDK på din Mac. Angiv loginoplysningerne, og klik på Start installation knap.
JDK-installationsprogrammet vil skrive nye filer til din harddisk.
Når det er afsluttet, vises skærmbilledet Resume. Klik på Luk knap.
For at teste JDK-installationen skal du åbne et Terminal-vindue.
Indtast kommandoen:/usr/libexec/java_home for at se, hvor JDK er installeret. I dette eksempel er kun én JDK installeret.
For at se Java-versionen skal du skrive kommandoen:java -version
Bemærk:Hvis du nu har mere end én Java-version installeret, skal du bruge programmet /usr/libexec/java_home for at ændre standarden, så MacOSX vil bruge Java version 1.8 i stedet for en anden version.
På dette tidspunkt er et godt Java Development Kit (JDK) blevet installeret, og nu kan vi fortsætte med at downloade og køre Oracle SQL Developer. Disse instruktioner fortsætter på næste side.
Download og installation af SQL Developer
SQL Developer kan downloades gratis fra Oracle-webstedet.
Åbn Safari-webbrowseren (eller en anden webbrowser), og naviger til:https://www.oracle.com/tools/downloads/sqldev-downloads.html
Rul ned til afsnittet med Mac OSX. Noter kravene til JDK. Hvis du ikke allerede har den relevante JDK installeret, skal du gå tilbage og færdiggøre disse trin først, før du fortsætter. Klik på Download link.
Marker afkrydsningsfeltet for at acceptere Oracle-licensaftalen, og klik derefter på den grå Download-knap.
På dette tidspunkt vises Oracle-webstedets loginskærm. Hvis du ikke har en Oracle-webstedskonto, skal du klikke på Opret konto knappen og følg disse trin. Når du har Oracle-webstedets brugernavn og adgangskode, skal du indtaste disse legitimationsoplysninger og klikke på Log ind knap.
Downloaden begynder på dette tidspunkt.
Når overførslen er fuldført, skal du klikke på ikonet Downloads for at se de downloadede filer pop op.
Klik på SQL Developer-filnavnet, og filen skulle åbne. Første gang SQL Developer kører, vises der muligvis en sikkerhedsadvarsel som vist nedenfor. Klik på Åbn knappen for at fortsætte.
Første gang SQL Developer kører, kan det vise en prompt om at tillade programmet at "kontrollere systemhændelser". Klik på OK knappen for at fortsætte.
Indlæsningsskærmen for SQL Developer vises som vist nedenfor.
Når SQL Developer er færdig med at indlæse applikationen, skal applikationen vises som vist nedenfor.
Nu SQL-udvikleren er downloadet og kører, kan vi fortsætte med at oprette en forbindelse til en Oracle-databaseserver. Disse trin er beskrevet på næste side.
Oprettelse af en forbindelse til en Oracle-database
SQL Developer har mulighed for at oprette forbindelse til Oracle relationsdatabaser, Oracle NoSQL-databaser og til andre databaser og datakilder, der har tilgængelige JDBC-drivere installeret. For at oprette forbindelse til en Oracle relationsdatabase skal du klikke på det grønne plustegn i øverste venstre hjørne under Forbindelser afsnit. Vælg Ny databaseforbindelse... fra pop op-menuen.
Bemærk, at hvis dit mål-DBMS er en autonom database i Oracle Cloud, skal du følge lidt andre instruktioner, der gør brug af Oracle Cloud Wallet. Følg disse instruktioner (side 6) om opsætning af en forbindelse til en autonom database.
Giv den nye forbindelse et navn, og udfyld derefter de nødvendige forbindelsesindstillinger, inklusive brugernavn og adgangskode, værtsnavnet (eller IP-adressen) på databaseserveren, portnummeret, hvor Oracle-lytteren kører, og tjenestenavnet (eller SID) af instansen. Disse oplysninger skal gives til dig af databaseadministratoren.
Hvis du kører din egen lokale Oracle-instans, kan du bruge localhost som værtsnavn for serveren. Yderligere tilslutningseksempler er givet senere i denne øvelse.
Når disse forbindelsesoplysninger er blevet indtastet, skal du klikke på Test knappen for at teste forbindelsen. Hvis der er nogen fejl, skal du redigere forbindelsesindstillingerne og klikke på Test knappen igen, indtil status i nederste venstre hjørne ændres til Succes som vist nedenfor.
Klik på Gem knappen for at gemme forbindelsesindstillingerne, og klik derefter på Forbind knappen for at etablere en live forbindelse til databasen.
Når databaseforbindelsen er etableret, vises forbindelsen i venstre side, hvor den kan udvides (ved at klikke på + tegn) for at se de forskellige tabeller, visninger og andet indhold af databasen. Et nyt SQL editor vindue vil dukke op i højre side, hvor SQL sætninger kan indtastes og sendes til databasen for at køre. Resultaterne vises i panelet under SQL-editor-vinduet.
De fire hovedområder på skærmen inkluderer nu:
Forbindelsesvindue, vinduet Rapportnavigator, SQL-regneark og scriptoutputvindue. Du kan muligvis ikke se vinduet Script-output, før du kører en SQL-sætning i SQL-regnearket. Hvis SQL-regnearket af en eller anden grund ikke kan besøges, skal du trække Værktøjer ned menuen og vælg SQL-regnearket menupunkt.
Alle SQL-sætninger kan indtastes direkte i SQL-regnearket eller indsættes fra et andet dokument, webside, e-mail osv.
SQL-regnearket får et standard filnavn såsom orcl_localhost.sql
Denne fil kan gemmes i enhver lokal mappe på pc'en. At gemme denne fil er en fantastisk måde at holde styr på historikken for SQL-sætninger, mens du skriver og genskriver dem.
For at åbne en eksisterende SQL-scriptfil skal du trække ned i menuen Filer og vælge Åbn. Naviger til mappen med SQL-scriptfilen, fremhæv den og klik på knappen Åbn.
Eksport af Oracle-data med SQL Developer
SQL Developer har en funktion, der gør det meget nemt at eksportere data fra en Oracle-tabel eller -visning. Der er mange forskellige måder at eksportere data fra Oracle på afhængigt af måldatabasens eller dataværktøjernes muligheder. Nogle almindelige eksempler på eksport af data omfatter:
- SQL Data Definition Language og SQL INSERT-sætningsfil, der bruges til at genskabe tabellen med data i en anden database.
- Oracle SQL Loader-fil og scripts, der kan bruges til at importere data til en anden Oracle-database eller et andet skema.
- Comma-Separated Values (.csv) fil, der kan importeres af mange forskellige softwareværktøjer, databaser osv.
- Microsoft Excel-fil
- eXtensible Markup Language (XML) fil, der kan importeres til forskellige softwareværktøjer
- HTML-fil (HyperText Markup Language), der kan vises på en webside
- Almindelig tekstfil med fast mellemrum eller ved hjælp af et andet skilletegn, der kan importeres af mange forskellige softwareværktøjer og databaser.
Dette eksempel antager, at du har mindst én tabel eller visning med data i dit skema (forbindelse), som kan eksporteres. Hvis du ikke har noget i dit skema, skal du oprette en grundlæggende tabel og tilføje nogle data ved hjælp af SQL-sætningerne nedenfor:
-- Create a simple Employee table CREATE TABLE employee ( employee_id INTEGER NOT NULL, first_name VARCHAR2(35), last_name VARCHAR2(65), salary NUMBER(12,2), department_number INTEGER ); -- Add three new records to the employee table INSERT INTO employee VALUES (101, 'Joe', 'Smith', 47000.00, 1); INSERT INTO employee VALUES (102, 'Alice', 'Jones, 49000.00, 2); INSERT INTO employee VALUES (103, 'Greg', 'Brown', 42500.00, 1, 2);
For at komme i gang skal du åbne navigationstræet i området Forbindelser til venstre på skærmen SQL-udvikler. Under navnet på forbindelsen vil tabeller, visninger, udgavevisninger, indekser osv. blive opført. Åbn tabellerne og Visninger kategorier også.
I dette eksempel vil MEDARBEJDER-tabellen blive eksporteret.
Højreklik på MEDARBEJDER-tabellen og vælg menupunktet Eksporter... som vist nedenfor.
Dette åbner en kort eksportguide.
Standardindstillingerne for eksport af en Oracle-tabel
Der er mange forskellige måder at eksportere data fra Oracle på afhængigt af måldatabasens eller dataværktøjernes muligheder. I dette eksempel vil MEDARBEJDER-tabellen blive eksporteret til et Microsoft Excel-regneark.
Når du eksporterer til en CSV-fil eller et regneark, er det ikke nødvendigt at inkludere Data Definition Language (DDL), der specificerer strukturen af tabellen eller visningen. Så for dette eksempel skal du fjerne afkrydsningsfeltet ud for Eksporter DDL .
I Eksporter data skal du ændre Format: til excel 2003+ ( xlsx )
Denne formatindstilling vil bruge Excels nyere filformat, der kan rumme op til en million rækker. For bagudkompatibilitet med ældre versioner af Excel kan du i stedet vælge Excel ’95 – 2003 (xls) som formatet.
Giv det nye regneark et navn i tekstfeltet ved siden af Dataarbejdsarknavn: prompt.
Hvis du gerne vil inkludere teksten i den SQL-sætning, der bruges til at trække dataene ud af Oracle, skal du markere afkrydsningsfeltet ud for Forespørgselsarknavn og derefter give et nyt navn til Excel-regnearket, hvor SQL-syntaksen vises (for dette eksempel, vi valgte ikke at inkludere SQL-koden).
Det sidste afsnit specificerer, hvordan dataene skal gemmes i en fil eller et sæt filer. For dette eksempel vil dataene blive eksporteret til en enkelt fil. Filnavnet angives derefter i tekstboksen ved siden af Fil: hurtig. Brug knappen Gennemse... for at finde en mappe (mappe), der har nok ledig diskplads. Tilføj derefter filnavnet til stien.
Når alle disse er sat op (som vist nedenfor), skal du klikke på knappen Næste>.
Det næste skærmbillede giver to muligheder for at filtrere kolonnerne og/eller rækkerne på de data, der skal eksporteres.
Som standard vil alle kolonner og alle rækker blive eksporteret. For at vælge specifikke kolonner skal du klikke på mellemrummet ud for tabellen under Kolonner overskrift. Klik derefter på blyantikonet for at redigere. Et nyt vindue vil poppe op med flueben ud for de kolonner, der skal med i dataeksporten. I dette eksempel vil alle kolonnerne blive eksporteret.
Klik på OK for at lukke vinduet Datakolonner.
For at filtrere de rækker, der skal eksporteres, kan der tilføjes en WHERE-sætning. Klik i mellemrummet under Object Where-overskriften, og klik derefter på blyantikonet for at få vist Where-editoren frem.
Tilføj eventuelle betingelser (såsom afdelingsnummer =1) nødvendige. I dette eksempel blev der ikke tilføjet nogen Where-betingelser, da vi ønsker, at alle data skal eksporteres. Klik på knappen OK for at lukke vinduet Data Where op, når du er færdig.
Klik på knappen Næste> for at komme til skærmen Eksportoversigt. På denne skærm er en oversigt over alle eksportmuligheder angivet.
Hvis nogen af indstillingerne ikke er indstillet korrekt, skal du bruge knappen
Hvis alle eksportmulighederne ser gode ud, skal du klikke på knappen Udfør for at begynde eksportjobbet.
Hvis du modtager nogen fejl, skal du sørge for at have angivet en destinationsmappe, der faktisk eksisterer (ikke blot blindt kopiere, hvad jeg har i denne vejledning). Sørg også for, at destinationsfilen ikke allerede er åben af f.eks. Excel.
Brug Windows Stifinder til at navigere til mappen for at se den nye eksporterede fil. For eksempel:
Åbn Excel-filen for at se indholdet:
Før du eksporterer dataene igen, skal du sørge for at lukke Excel-filen.
SQL Developer har en funktion, der gør det meget nemt at importere data fra en lang række datakilder til Oracle. Der er mange forskellige måder at importere data til Oracle på afhængigt af kilden til dataene. Nogle almindelige dataformater, som SQL Developer kan importere, omfatter:
Dette eksempel antager, at du har en forbindelse til en Oracle-database lavet gennem SQL Developer.
Filen, der skal importeres, vil være filen customers_export.csv, der er linket her. Dataene ser ud som følgende (319 rækker med 21 kolonner):
For at komme i gang skal du åbne navigationstræet i området Forbindelser til venstre på skærmen SQL-udvikler. Højreklik på Tabeller og vælg menupunktet Importer data... fra pop op-menuen.
På dette tidspunkt vil ældre versioner af SQL Developer (før 4.1.3) vise en filvalgsdialogboks, hvor du kan vælge den fil, der skal importeres. Nyere versioner af SQL Developer (4.1.3 og nyere) vil præsentere det første trin af dataimportguiden som vist nedenfor.
For den nyere SQL-udvikler skal du klikke på Browser-knappen for at åbne dialogboksen Filvalg for at vælge din fil.
Naviger til den mappe, hvor din fil er placeret, og vælg den. Bemærk, at filtypen er blevet indstillet til at filtrere efter Excel-filer, CSV-filer og et par andre varianter af tekstfiler.
Klik på knappen Åbn for at starte guiden Dataimport.
Det første trin i guiden Dataimport giver et eksempel på de data, der skal importeres. I dette eksempel har CSV-filen en række overskrifter, som importguiden vil bruge til at oprette variabelnavne. Der er yderligere muligheder i dette trin i guiden for at springe et antal rækker over i starten (0 i dette eksempel), vælg formatering (csv i dette eksempel), tegnkodning, citationssymboler, der bruges til at omslutte tekst eller strenge og linje afslutning/terminator. I de fleste tilfælde kan disse indstillinger stå som standard.
Nogle ændringer, der kan hjælpe i visse situationer, omfatter:
Hvis alle indstillinger ser gode ud, og de forhåndsviste data ser gode ud, skal du klikke på knappen Næste> for at gå til næste trin.
Import af data med SQL Developer
Kom godt i gang med dataimporten
Visning af de data, der skal importeres, og bekræftelse af indstillinger
Valg af importmetode
Det næste trin i guiden er at angive importmetoden. Der findes en række forskellige importmetoder:
- Indsæt – Indsæt dataene direkte i en ny eller eksisterende tabel.
- Indsæt script – Opret en SQL Script-fil, der indeholder alle de nødvendige DDL- og INSERT-sætninger for at indlæse dataene i en database. Dette script kan køres med det samme eller flyttes til en anden databaseforbindelse og køres der.
- Ekstern tabel – Opretter en ekstern tabelstruktur i Oracle, hvor tabellen vises i dataordbogen, men dataene vedligeholdes i en ekstern fil.
- SQL Loader Utility – Skriv SQL Loader-scriptet og kommandoerne for at importere dataene til Oracle.
For dette eksempel er Indsæt metoden vil blive brugt, så dataene vil blive indsat direkte i en ny tabel.
Angiv et navn på tabellen. Hvis der er en grund til at begrænse de rækker, der skal importeres, skal du kontrollere Importér rækkegrænse boksen og angiv antallet af rækker. For eksempel, hvis din datafil har millioner af rækker, men du bare er interesseret i at vide, hvordan en del af dataene ser ud, kan du begrænse antallet af importerede rækker. I dette eksempel vil alle rækker blive importeret.
Klik på knappen Næste> for at gå til næste trin.
Vælg de kolonner, der skal importeres
Trin 3 i guiden er at vælge de kolonner, der skal importeres. Fremhæv eventuelle kolonner på Tilgængelige kolonner vinduet og klik på højrepilen for at bringe dem over til Valgte kolonner vindue. I dette eksempel vil alle kolonnerne blive importeret.
Klik på knappen Næste> for at gå til næste trin.
Tildeling af datatyper til hver kolonne
Trin 4 i guiden giver os mulighed for at definere datatyperne og størrelserne for de kolonner, der skal oprettes i den nye datatabel. Dette er et meget kritisk skridt! Hvis den forkerte datatype er valgt, eller hvis en datatype ikke har plads nok til at opbevare de indgående data, mislykkes importen.
De nyere versioner af SQL Developer vil vise et dataeksempel for hver kolonne, når den er valgt:
Nogle almindelige problemer, der opstår, omfatter:
- Der er ikke tilstrækkelig plads i en VARACHAR-kolonne til at rumme den største streng-/tekstværdi.
- Brug af en NUMBER datatype i en kolonne, når nogle teksttegn er til stede i dataene.
- Brug af et forkert dato- eller tidsformat ved import af datoer og klokkeslæt.
Besøg hver af Kildedatakolonnerne ved at klikke på dem én ad gangen. Foretag justeringer af datatyperne, mens du går. For dette eksempel foretages følgende justeringer:
- CUSTOMER_ID ændres til INTEGER Data Type, og fjern afkrydsningsfeltet for Nullable
- CUST_FIRST_NAME bruger VARCHAR2 med en størrelse på 30
- CUST_LAST_NAME bruger VARCHAR2 med størrelsen 60
- STREET_ADDRESS brug VARCHAR2 med størrelsen 65
- POST_CODE brug VARCHAR2 med størrelsen 20
- CITY bruger VARCHAR2 med størrelse 35
- STATE_PROVINCE brug VARCHAR2 med størrelse 6
- COUNTRY_ID bruger VARCHAR2 med størrelsen 4
- COUNTRY_NAME bruger VARCHAR2 med størrelsen 60
- REGION_ID bruger VARCHAR2 med størrelsen 2
- NLS_LANGUAGE brug VARCHAR2 med størrelse 6
- NLS_TERRITORY brug VARCHAR2 med størrelse 30
- CREDIT_LIMIT brug NUMBER med størrelse/præcision på 10 og skala 0
- CUST_EMAIL bruger VARCHAR2 med størrelsen 60
- PRIMARY_PHONE_NUMBER brug VARCHAR2 med størrelsen 30
- PHONE_NUMBER_2 brug VARCHAR2 med størrelse 30
- ACCOUNT_MGR_ID bruger VARCHAR2 med størrelsen 6
- LOCATION_GTYPE brug INTEGER
- LOCATION_SRID brug INTEGER
- LOCATION_X brug NUMBER med størrelse/præcision på 14 og skala 6
- LOCATION_Y brug NUMBER med størrelse/præcision på 14 og skala 6
Klik på knappen Næste> for at gå til næste trin.
Bekræft importparametrene (ældre SQL-udvikler)
For ældre (før 4.1.3) versioner af SQL Developer giver det sidste trin i dataimportguiden en chance for at verificere, at dataparametrene og indstillingerne tillader, at datafilen kan parses. Dette skærmbillede vises nedenfor:
Klik på knappen Bekræft for at bekræfte, at alle indstillinger fungerer korrekt. Resultaterne af verifikationsprocessen er vist nedenfor:
Hvis der er problemer, skal du bruge
Nyere versioner af SQL Developer (4.1.3 og nyere) har en lidt anderledes slutskærm. På dette tidspunkt er indstillingerne allerede blevet kontrolleret, og derfor vises en oversigtsskærm. Knappen Gem tilstand i øverste højre hjørne giver mulighed for at gemme alle importindstillinger i en fil. Denne indstillingsfil kan indlæses næste gang guiden Dataimport kører.
I dette eksempel, hvis du bruger den nyere version af SQL Developer, skal du klikke på knappen Gem tilstand og gemme indstillingerne i en fil med navnet:oracle_sqldev_import_customers.
I begge tilfælde (gammel eller nyere version af SQL Developer) skal du klikke på knappen Udfør for at starte dataimporten. Når importen er fuldført, vises en dialogboks. Eventuelle fejl, der opstår under importen, vil blive vist.
Vend tilbage til SQL Developer og se strukturen af den importerede tabel.
Gennemgå derefter dataene (klik på fanen Data) for at sikre dig, at dataværdierne blev importeret korrekt.
Gem importparametrene (nyere versioner af SQL Developer)
Kørsel af importen
For nyere versioner af SQL Developer kan de gemte importindstillinger importeres i det første trin i guiden Importer data for at køre igen eller for at ændre importindstillinger, før dataimporten køres igen.