Kom godt i gang med Oracle SQL Developer på Windows

Introduktion

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 data mining-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.

Hvis du arbejder på MacOSX, kan du finde instruktioner om installation og arbejde med SQL Developer på MacOSX her.

Det næste afsnit af denne tutorial dækker download og installation af SQL Developer. Hvis du allerede har SQL Developer downloadet og installeret, kan du ønske at springe videre til næste side for at lære, hvordan du opretter en ny databaseforbindelse.

Mod slutningen af ​​denne vejledning 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. Denne tutorial er linket her.

Download og installation af SQL Developer

SQL Developer kan downloades gratis fra Oracle Developers netværk. SQL Developer kræver et Java Development Kit for at kunne køre. For eksempel kræver SQL Developer version 4.1.3 og nyere JDK 1.8.

Besøg følgende link for at downloade SQL-udviklerfilerne:

http://www.oracle.com/technetwork/developer-tools/sql-developer/downloads/index.html

Vælg den version, der matcher dit operativsystem (og eller som inkluderer JDK, hvis det er nødvendigt). Resten af ​​denne øvelse blev gennemført med Windows-versionen.

SQL Developer-downloaden er en enkelt .zip-fil, f.eks.:sqldeveloper-4.1.3.20.78-no-jre.zip (eller en nyere version såsom sqldeveloper-17.4.0.355.2349-x64.zip)

Udpak SQL Developer-zip-filen til et passende drev. Resultatet skulle være en simpel sqldeveloper-mappe.

Dobbeltklik på den eksekverbare sqldeveloper.exe. Der vises muligvis en dialogboks, hvor du bliver bedt om at angive stien til Java Development Kit (JDK)-hjemmemappen.

Klik på knappen Gennemse, og naviger til JDK-hjemmemappe.

Klik på Vælg mappe, og stien til JDK vises i dialogboksen:

Klik på knappen OK, og SQL Developer starter

Når SQL Developer kører, vil du se følgende skærmbillede:

Konfiguration af en ny databaseforbindelse

Den første opgave er at oprette en ny forbindelse til din Oracle-database. For at oprette en ny forbindelse skal du vide:

• Navnet (eller IP-adressen) på den server, der kører Oracle. Hvis du har installeret Oracle på din lokale computer, er det sandsynligt, at du kan bruge "localhost" (eller 127.0.01).
• TCP/IP-portnummeret, hvor Oracle Listener-processen kører. Standarden for Oracle er at bruge port 1521. Medmindre du har konfigureret dette anderledes, skal du bruge 1521.
• Oracle System Identifier (SID) eller tjenestenavn, der identificerer den specifikke Oracle-instans på serveren.

Nogle almindelige kombinationer kan være:

• Oracle 11g eller 12c Enterprise Edition installeret på den samme (lokale) server eller pc:Vært:localhost, Port:1521, SID:orcl
• Oracle 11g Express Edition installeret på den samme (lokale) server eller pc:Vært:localhost, port:1521, SID:xe
• Oracle 11g eller 12c Enterprise Edition installeret på fjernserveren:Host:myhostname.domain.com, Port:1521, SID:orcl
• Oracle 12c Enterprise Edition installeret på fjernserveren ved hjælp af Multi-tenant database:Host:myhostname.domain.com, Port:1521, Service Name:pdb1
• Oracle Autonomous Data Warehouse eller Autonomous Transaction Processing-database, der kører Oracle Cloud:Skift Forbindelsestype til Cloud Wallet og vælg derefter din tegnebogs .zip-fil, der blev downloadet fra din clouddatabaseinstans. Følg disse instruktioner (side 6).

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.

For at komme i gang med at konfigurere den nye forbindelse skal du klikke på pil ned ved siden af ​​det grønne +-tegn og vælge Ny forbindelse...

Standardvinduet "Ny / Vælg databaseforbindelse" vises.

Giv et nyt navn til din forbindelse, og udfyld brugernavnet og adgangskoden til den Oracle-databasekonto, du ønsker at oprette forbindelse til.

Udfyld værtsnavnet med internetværtsnavnet eller IP-adressen på den server, hvor Oracle-databasen kører. Indstil porten til at matche, hvor Oracle Listener kører (1521 er den typiske standard).

Hvis værten har et Oracle System Identifier (SID), skal du indtaste det. Ellers, hvis Oracle-serveren bruger multi-tenant (via oracle 12c eller nyere), skal du vælge Service Name og angive servicenavnet for databaseinstansen.

Andre avancerede godkendelses-, kryptering- og sikkerhedsindstillinger kan så være specifikke, hvis det er nødvendigt.

Nedenfor er et eksempel på tilslutning til en Oracle 12c-instans på den lokale server ved hjælp af Oracle-systemkontoen. Adgangskoden til denne konto blev sat op under databaseinstallationen.

Test forbindelsen ved at klikke på testknappen. Bemærk Status i nederste venstre hjørne for at se, om der er nogen fejlmeddelelser. Billedet nedenfor viser "succes":

Typiske login-fejl og ting at kontrollere

Der er en række grunde til, at SQL Developer ikke kan oprette en vellykket forbindelse til Oracle Server. Nogle af de mere almindelige potentielle problemer og løsninger er anført nedenfor. Husk "Client/Server" Oracle-arkitekturen og det faktum, at der er et netværk mellem dem.

Der er et problem med at oprette forbindelse over netværket mellem SQL Developer-klienten og Oracle-databaseserveren. Enten er værtsnavnet (eller IP-adressen) eller portnummeret forkert. Eller et andet netværksproblem (DNS, Firewall osv.) forhindrer SQL Developer i at oprette forbindelse til Oracle-serveren. Det er også muligt, at Oracle Listener (netværkstjenesten, der accepterer indgående forbindelser) ikke kører eller lytter til en anden netværksport. Prøv at bruge traceroute (tracert på Windows) for at se, om serveren overhovedet kan nås. Bekræft, at Oracle-databasen er oppe og kører sammen med Oracle Listener-tjenesten, og at ingen firewalls blokerer forbindelser til port 1521.

SQL Developer opretter forbindelse til Oracle server Listener-processen, men det angivne SID stemmer ikke overens med det, der er konfigureret på databaseserveren.

SQL Developer opretter forbindelse til Oracle-serveren, men det angivne servicenavn stemmer ikke overens med det, der er konfigureret på databaseserveren.

SQL Developer opretter forbindelse til Oracle-serveren og til instansen (så værtsnavn, port og SID eller servicenavn er korrekte). Brugernavnet og/eller adgangskoden stemmer dog ikke overens.

SQL Developer opretter forbindelse til Oracle-serveren og til instansen (så værtsnavn, port og SID eller servicenavn er korrekte). Men Oracle-kontoen er blevet låst (f.eks. er for mange mislykkede loginforsøg eller adgangskode udløbet).

SQL Developer opretter forbindelse til Oracle-serveren og til instansen (så værtsnavn, port og SID eller servicenavn er korrekte). Men lytteren kan til gengæld ikke oprette forbindelse til Oracle-databasen. Dette kan ske, hvis databasen ikke kører eller åbnes, eller hvis serveren, der kører Oracle, løber tør for RAM. Det kan også ske, hvis der er et problem med brugertilladelser mellem lytterprocessen og databaseprocesserne.

Gemmer SQL-udviklerforbindelsen

Hvis testen er vellykket, skal du klikke på knappen Gem for at gemme denne forbindelse.

Opretter forbindelse til Oracle-databasen

Endelig, nu hvor forbindelsen er blevet testet og gemt, skal du klikke på knappen Connect for at oprette forbindelse til databaseserveren.

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 du har angivet en destinationsmappe, der faktisk eksisterer (ikke bare 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.

Import af data med SQL Developer

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:

• SQL Data Definition Language og SQL INSERT-sætningsfil, der bruges til at genskabe tabellen med data i Oracle.
• Oracle SQL Loader-fil og scripts, der kan bruges til at importere dataene til Oracle.
• Kommaseparerede værdier (.csv) fil
• Microsoft Excel-fil (.xls og .xlsx)
• eXtensible Markup Language (XML)-fil
• Almindelig tekstfil med fast mellemrum eller ved hjælp af en anden afgrænser

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):

Kom godt i gang med dataimporten

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 i Data Import Wizard 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.

Visning af de data, der skal importeres, og bekræftelse af indstillinger

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:

• Skift kun Line Terminator til et Line Feed, hvis CSV-filen blev oprettet på et Linux- eller Mac-operativsystem.
• Skift kodningen til en specifik tegntabel, der matcher din verdensregion (eller den verdensregion, som CSV-filen blev genereret under).
• Skift antallet af forhåndsvisningsrækker, og rul gennem dataene for at sikre, at alt er blevet parset korrekt.

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.

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

Gem importparametrene (nyere versioner af SQL Developer)

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.

Kørsel af importen

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.

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.