Introduktion
Syftet med denna handledning är att tillhandahålla de steg som krävs för att installera Oracle SQL Developer på MacOSX-operativsystemet. Liknande instruktioner för installation av Oracle SQL Developer på Windows finns på den här länken. Denna handledning skapades med MacOSX Mojave (version 10.14).
Oracle SQL Developer är ett kraftfullt utvecklingsverktyg med många funktioner för att interagera med Oracle-databaser. Förutom att skriva och skicka SQL-satser med hjälp av SQL-arbetsbladet har SQL Developer kraftfulla verktyg för att hantera databaser, designa och omvända databaser med hjälp av datamodeller och köra datautvinningsjobb. Den senaste versionen (version 19.4 från och med den 20 december 2019) innehåller några grundläggande databasadministrationsverktyg, stöd för REST-frågor och tolka JSON-dokument också.
Oracle SQL Developer kräver att en lämplig version av Java installeras. Detta är kanske den mest förvirrande delen av att få SQL Developer att arbeta på MacOSX. Steg för att installera ett lämpligt Java Development Kit (JDK) beskrivs på nästa sida.
När du har installerat JDK, kommer nästa avsnitt i denna handledning att ta upp nedladdning och installation av SQL Developer. Om du redan har laddat ner och installerat SQL Developer, kanske du vill hoppa vidare till den här sidan för att lära dig hur du skapar en ny databasanslutning.
Mot slutet av den här självstudien finns det några sidor som beskriver hur man skriver, kör och sparar SQL-satser, hur man exporterar data med SQL Developer och hur man importerar data till Oracle med SQL Developer. Du kanske också är intresserad av att använda SQL Developer för att bakåtkonstruera ett Oracle-schema. Den självstudien är länkad här.
Installera och konfigurera Java på MacOSX
Oracle SQL Developer kräver en Java Runtime Environment (JRE) eller Java Development Kit (JDK) för att vara installerad på MacOSX operativsystem. Tyvärr, beroende på vilken version av MacOSX du kör, kan du ha en Java-version som antingen är för ny, för gammal eller inte installerad alls. Så vitt jag vet beskriver följande vad du kan förvänta dig med din MacOSX-version.
Mac OS X version 10.6 och tidigare kommer med Apples Java Runtime Environment. Det kan vara en äldre JRE som JRE 6 eller JRE 7. Dessa kommer inte att fungera med den nuvarande versionen av Oracle SQL Developer (version 18 eller 19) och därför måste en nyare version av Java som version 8 eller 11 installeras.
Mac OS X version 10.7 och senare levereras inte med en JRE eller JDK installerad alls.
För att installera Java, besök Oracle Java-nedladdningssidan
https://www.oracle.com/technetwork/java/javase/downloads/index.html
Observera att den senaste versionen av Java kommer att visas överst. Från och med september 2019 kommer Java version 12 inte att fungera med Oracle SQL Developer version 19.
Scrolla ner till avsnittet för Java SE 8.
Klicka på knappen Ladda ner för JDK (Java Development Kit)
Klicka på alternativknappen för att acceptera licensvillkoren och leta sedan upp rätt filnamn för MacOSX. Klicka på filnamnet för att påbörja nedladdningsprocessen. I det här exemplet valdes JDK version 8 uppdatering 221 så filnamnet är:jdk-8u221-macosx-x64.dmg.
Om detta är ditt första besök på en Oracle-webbplats kommer du att uppmanas att logga in. Om du inte har en Oracle-webbplatsinloggning klickar du på Skapa konto och följ instruktionerna för att skapa ditt konto. Om du redan har en Oracle-webbplatsinloggning anger du dessa uppgifter och klickar på Logga in knapp. Vid den tidpunkten bör nedladdningen börja. När nedladdningen är klar, klicka på ikonen Nedladdningar och klicka sedan på JDK-filnamnet:jdk-8u221-macosx-x64.dmg
Efter att ha klickat på .dmg-filen i mappen Nedladdningar, öppnas filen.
När den nedladdade filen har öppnats kommer .pkg-installationsfilen att visas i sin egen mapp enligt nedan. Dubbelklicka på den här .pkg-installationsfilen för att starta JDK Installer.
Om ett fel visas angående "JDK Update xxx kan inte öppnas eftersom Apple inte kan kontrollera det för skadlig programvara", måste du ändra dina inställningar enligt den här artikeln från Apple.
Den första skärmen i JDK Installer är en informationsskärm. Klicka på knappen Fortsätt.
Nästa skärm ger en indikation på hur mycket diskutrymme som kommer att användas. Se till att du har åtminstone så mycket ledigt diskutrymme och klicka sedan på knappen Fortsätt.
Du kommer sedan att bli ombedd att ange ditt lokala MacOS X-kontonamn och lösenord. Detta kommer att tillåta installationsprogrammet att fortsätta att installera JDK på din Mac. Ange inloggningsuppgifterna och klicka på Starta installationen knappen.
JDK-installationsprogrammet kommer att skriva nya filer till din hårddisk.
När du är klar visas skärmen Sammanfattning. Klicka på Stäng knappen.
För att testa JDK-installationen, öppna ett terminalfönster.
Skriv kommandot:/usr/libexec/java_home för att se var JDK är installerat. I detta exempel är endast en JDK installerad.
För att se Java-versionen, skriv kommandot:java -version
Obs:Om du nu har mer än en Java-version installerad, måste du använda /usr/libexec/java_home-programmet för att ändra standarden så att MacOSX kommer att använda Java version 1.8 istället för en annan version.
Vid det här laget har ett bra Java Development Kit (JDK) installerats och nu kan vi fortsätta att ladda ner och köra Oracle SQL Developer. Dessa instruktioner fortsätter på nästa sida.
Hämta och installera SQL Developer
SQL Developer kan laddas ner gratis från Oracles webbplats.
Öppna webbläsaren Safari (eller annan webbläsare) och navigera till:https://www.oracle.com/tools/downloads/sqldev-downloads.html
Scrolla ner till avsnittet med Mac OSX. Anteckna kraven för JDK. Om du inte redan har rätt JDK installerat, gå tillbaka och slutför dessa steg innan du fortsätter. Klicka på Ladda ner länk.
Markera rutan för att acceptera Oracles licensavtal och klicka sedan på den grå knappen Ladda ner.
Vid denna tidpunkt visas inloggningsskärmen för Oracles webbplats. Om du inte har ett Oracle-webbplatskonto klickar du på Skapa konto knappen och följ dessa steg. När du har Oracle-webbplatsens användarnamn och lösenord skriver du in dessa uppgifter och klickar på Logga in knappen.
Nedladdningen börjar vid denna tidpunkt.
När nedladdningen är klar klickar du på ikonen för nedladdningar för att se de nedladdade filerna som visas.
Klicka på SQL Developer-filnamnet så ska filen öppnas. Första gången SQL Developer körs kan en säkerhetsvarning visas som visas nedan. Klicka på Öppna för att fortsätta.
Första gången SQL Developer körs kan det visa en uppmaning att tillåta programmet att "kontrollera systemhändelser". Klicka på OK för att fortsätta.
Uppladdningsskärmen för SQL Developer visas som visas nedan.
När SQL Developer har slutfört laddningen bör applikationen visas som visas nedan.
Nu SQL-utvecklaren är nedladdad och igång, kan vi fortsätta att skapa en anslutning till en Oracle-databasserver. Dessa steg beskrivs på nästa sida.
Skapa en anslutning till en Oracle-databas
SQL Developer har möjlighet att ansluta till Oracles relationsdatabaser, Oracle NoSQL-databaser och till andra databaser och datakällor som har tillgängliga JDBC-drivrutiner installerade. För att ansluta till en Oracle relationsdatabas, klicka på det gröna plustecknet i det övre vänstra hörnet under Anslutningar sektion. Välj Ny databasanslutning... från popup-menyn.
Observera att om ditt mål-DBMS är en autonom databas i Oracle Cloud, måste du följa lite andra instruktioner som använder Oracle Cloud Wallet. Följ dessa instruktioner (Sida 6) för att skapa en anslutning till en autonom databas.
Ge den nya anslutningen ett namn och fyll sedan i de nödvändiga anslutningsinställningarna inklusive användarnamn och lösenord, värdnamnet (eller IP-adressen) för databasservern, portnumret där Oracle-avlyssnaren körs och tjänstens namn (eller SID) av instansen. Denna information bör tillhandahållas av databasadministratören.
Om du kör din egen lokala Oracle-instans kan du använda localhost som värdnamn för servern. Ytterligare anslutningsexempel ges senare i denna handledning.
När denna anslutningsinformation har skrivits in klickar du på Test knappen för att testa anslutningen. Om det finns några fel, redigera anslutningsinställningarna och klicka på Testa knappen igen tills Status i det nedre vänstra hörnet ändras till Framgång som visas nedan.
Klicka på Spara för att spara anslutningsinställningarna och klicka sedan på Anslut knappen för att upprätta en liveanslutning till databasen.
När databasanslutningen har upprättats kommer anslutningen att visas på vänster sida där den kan utökas (genom att klicka på + sign) för att visa de olika tabellerna, vyerna och annat innehåll i databasen. Ett nytt SQL-redigeringsfönster kommer att visas på höger sida där SQL-satser kan skrivas in och skickas till databasen för att köras. Resultaten visas i panelen under SQL-redigeringsfönstret.
De fyra huvudområdena på skärmen inkluderar nu:
Anslutningsfönster, Reports Navigator-fönster, SQL-kalkylblad och skriptutmatningsfönster. Du kanske inte ser Script Output-fönstret förrän du kör en SQL-sats i SQL-arbetsbladet. Om SQL-arbetsbladet av någon anledning inte går att besöka, dra ned Verktyg menyn och välj SQL-arbetsbladet menyalternativ.
Alla SQL-satser kan skrivas in direkt i SQL-arbetsbladet eller klistras in från ett annat dokument, webbsida, e-post etc.
SQL-arbetsbladet får ett standardfilnamn som orcl_localhost.sql
Den här filen kan sparas i vilken lokal mapp som helst på datorn. Att spara den här filen är ett utmärkt sätt att hålla reda på historiken för SQL-satser när du skriver och skriver om dem.
För att öppna en befintlig SQL-skriptfil, dra ned Arkiv-menyn och välj Öppna. Navigera till mappen med SQL-skriptfilen, markera den och klicka på knappen Öppna.
Exportera Oracle-data med SQL Developer
SQL Developer har en funktion som gör det mycket enkelt att exportera data från en Oracle-tabell eller vy. Det finns många olika sätt att exportera data från Oracle beroende på kapaciteten hos måldatabasen eller dataverktygen. Några vanliga exempel på export av data är:
- SQL Data Definition Language och SQL INSERT-satsfil som används för att återskapa tabellen med data i en annan databas.
- Oracle SQL Loader-fil och skript som kan användas för att importera data till en annan Oracle-databas eller -schema.
- Comma-Separated Values (.csv)-fil som kan importeras av många olika programvaruverktyg, databaser etc.
- Microsoft Excel-fil
- eXtensible Markup Language (XML)-fil som kan importeras till olika programvaruverktyg
- HyperText Markup Language (HTML)-fil som kan visas på en webbsida
- Vanlig textfil med fast avstånd eller med någon annan avgränsare som kan importeras av många olika programvaruverktyg och databaser.
Det här exemplet förutsätter att du har minst en tabell eller vy med data i ditt schema (anslutning) som kan exporteras. Om du inte har något i ditt schema, skapa en grundläggande tabell och lägg till några data med hjälp av SQL-satserna nedan:
-- 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);
För att komma igång öppnar du navigeringsträdet i området Anslutningar till vänster på SQL Developer-skärmen. Under namnet på anslutningen kommer tabellerna, vyerna, versionsvyerna, indexen etc. att listas. Öppna tabellerna och Visningar kategorier också.
I det här exemplet kommer tabellen MEDARBETARE att exporteras.
Högerklicka på tabellen MEDARBETARE och välj menyalternativet Exportera... som visas nedan.
Detta kommer att ta upp en kort exportguide.
Standardinställningarna för att exportera en Oracle-tabell
Det finns många olika sätt att exportera data från Oracle beroende på kapaciteten hos måldatabasen eller dataverktygen. I det här exemplet kommer tabellen ANSTÄLLDA att exporteras till ett Microsoft Excel-kalkylblad.
När du exporterar till en CSV-fil eller ett kalkylblad är det inte nödvändigt att inkludera Data Definition Language (DDL) som anger strukturen för tabellen eller vyn. Så för det här exemplet, ta bort kryssrutan bredvid Exportera DDL .
I Exportera data ändra Format: till excel 2003+ ( xlsx )
Den här formatinställningen kommer att använda Excels nyare filformat som kan rymma upp till en miljon rader. För bakåtkompatibilitet med äldre versioner av Excel kan du istället välja Excel ’95 – 2003 (xls) som formatet.
Ge det nya kalkylbladet ett namn i textrutan bredvid Data kalkylbladsnamn: uppmaning.
Om du vill inkludera texten i SQL-satsen som används för att hämta data från Oracle, markera rutan bredvid Query Worksheet Name och ge sedan ett nytt namn för Excel-arbetsbladet där SQL-syntaxen kommer att visas (för det här exemplet, vi valde att inte inkludera SQL-koden).
Det sista avsnittet specificerar hur data ska lagras i en fil eller en uppsättning filer. I det här exemplet kommer data att exporteras till en enda fil. Filnamnet anges sedan i textrutan bredvid Fil: prompt. Använd knappen Bläddra... för att hitta en mapp (katalog) som har tillräckligt med ledigt diskutrymme. Lägg sedan till filnamnet i sökvägen.
När alla dessa är konfigurerade (som visas nedan), klicka på knappen Nästa>.
Nästa skärm ger två möjligheter att filtrera kolumnerna och/eller raderna på data som ska exporteras.
Som standard kommer alla kolumner och alla rader att exporteras. För att välja specifika kolumner klickar du på utrymmet bredvid tabellen under Kolumner rubrik. Klicka sedan på pennikonen för att redigera. Ett nytt fönster kommer att dyka upp med bockar bredvid de kolumner som ska inkluderas i dataexporten. I det här exemplet kommer alla kolumner att exporteras.
Klicka på OK för att stänga fönstret Datakolumner.
För att filtrera raderna som ska exporteras kan en WHERE-sats läggas till. Klicka i utrymmet under rubriken Objekt Var och klicka sedan på blyertsikonen för att ta fram Var-redigeraren.
Lägg till alla villkor (som avdelningsnummer =1) som behövs. För det här exemplet har inga Where-villkor lagts till eftersom vi vill att all data ska exporteras. Klicka på OK-knappen för att stänga fönstret Data Where när du är klar.
Klicka på knappen Nästa> för att komma till skärmen Exportsammanfattning. På den här skärmen anges en sammanfattning av alla exportalternativ.
Om något av alternativen inte är korrekt inställt, använd
Om alla exportalternativ ser bra ut klickar du på knappen Slutför för att påbörja exportjobbet.
Om du får några fel, se till att du har angett en målmapp som faktiskt finns (kopiera inte bara blint vad jag har i den här handledningen). Se också till att målfilen inte redan är öppen av till exempel Excel.
Använd Windows Explorer för att navigera till mappen för att se den nya exporterade filen. Till exempel:
Öppna Excel-filen för att se innehållet:
Innan du exporterar data igen, se till att stänga Excel-filen.
SQL Developer har en funktion som gör det mycket enkelt att importera data från ett brett utbud av datakällor till Oracle. Det finns många olika sätt att importera data till Oracle beroende på källan till data. Några vanliga dataformat som SQL Developer kan importera inkluderar:
Det här exemplet förutsätter att du har en anslutning till en Oracle-databas gjord via SQL Developer.
Filen som ska importeras kommer att vara filen customers_export.csv som länkas här. Datan ser ut som följande (319 rader med 21 kolumner):
För att komma igång öppnar du navigeringsträdet i området Anslutningar till vänster på SQL Developer-skärmen. Högerklicka på Tabell och välj menyalternativet Importera data... från popup-menyn.
Vid det här laget kommer äldre versioner av SQL Developer (före 4.1.3) att visa en filvalsdialogruta där du kan välja filen som ska importeras. Nyare versioner av SQL Developer (4.1.3 och senare) kommer att presentera det första steget i dataimportguiden som visas nedan.
För den nyare SQL-utvecklaren, klicka på knappen Webbläsare för att visa dialogrutan Filval för att välja din fil.
Navigera till mappen där din fil finns och välj den. Observera att filtypen har ställts in för att filtrera efter Excel-filer, CSV-filer och några andra varianter av textfiler.
Klicka på knappen Öppna för att starta guiden Dataimport.
Det första steget i Dataimportguiden ger en förhandsvisning av data som ska importeras. I det här exemplet har CSV-filen en rad med rubriker som importguiden kommer att använda för att skapa variabelnamn. Det finns ytterligare alternativ i det här steget i guiden för att hoppa över ett antal rader i början (0 i det här exemplet), välj formatering (csv i det här exemplet), teckenkodning, citattecken som används för att omsluta text eller strängar och rad avslutning/terminator. I de flesta fall kan dessa inställningar lämnas som standard.
Några ändringar som kan hjälpa i vissa situationer inkluderar:
Om alla inställningar ser bra ut och de förhandsgranskade uppgifterna ser bra ut, klicka på knappen Nästa> för att gå till nästa steg.
Importera data med SQL Developer
Komma igång med dataimporten
Förhandsgranska data som ska importeras och bekräfta inställningar
Välja importmetod
Nästa steg i guiden är att ange importmetoden. Ett antal olika importmetoder tillhandahålls:
- Infoga – Infoga data direkt i en ny eller befintlig tabell.
- Infoga skript – Skapa en SQL-skriptfil som innehåller alla nödvändiga DDL- och INSERT-satser för att ladda data till en databas. Det här skriptet kan köras omedelbart eller flyttas till en annan databasanslutning och köras där.
- Extern tabell – Konfigurerar en extern tabellstruktur inom Oracle där tabellen visas i datalexikonet men data bevaras i en extern fil.
- SQL Loader Utility – Skriv SQL Loader-skriptet och kommandon för att importera data till Oracle.
För det här exemplet Infoga metod kommer att användas så att data infogas direkt i en ny tabell.
Ange ett namn på tabellen. Om det finns en anledning att begränsa antalet rader som ska importeras, kontrollera Importera radgräns rutan och ange antalet rader. Till exempel, om din datafil har miljontals rader men du bara är intresserad av att veta hur en del av datan ser ut, kan du begränsa antalet importerade rader. I det här exemplet kommer alla rader att importeras.
Klicka på knappen Nästa> för att gå till nästa steg.
Välj de kolumner som ska importeras
Steg 3 i guiden är att välja de kolumner som ska importeras. Markera eventuella kolumner i Tillgängliga kolumner fönstret och klicka på högerpilen för att flytta dem till Valda kolumner fönster. I det här exemplet kommer alla kolumner att importeras.
Klicka på knappen Nästa> för att gå till nästa steg.
Tilldela datatyper till varje kolumn
Steg 4 i guiden låter oss definiera datatyperna och storlekarna för kolumnerna som ska skapas i den nya datatabellen. Detta är ett mycket viktigt steg! Om fel datatyp väljs, eller om en datatyp inte har tillräckligt med utrymme för att lagra inkommande data, kommer importen att misslyckas.
De nyare versionerna av SQL Developer visar en dataförhandsgranskning för varje kolumn när den väljs:
Några vanliga problem som uppstår inkluderar:
- Det finns inte tillräckligt med utrymme i en VARACHAR-kolumn för att rymma det största strängen/textvärdet.
- Användning av en NUMBER datatyp i en kolumn när vissa texttecken finns i datan.
- Använder ett felaktigt datum- eller tidsformat vid import av datum och tider.
Besök var och en av Källdatakolumnerna genom att klicka på dem en i taget. Gör justeringar av datatyperna allt eftersom. För detta exempel görs följande justeringar:
- CUSTOMER_ID ändra till INTEGER Data Type och ta bort kryssrutan för Nullable
- CUST_FIRST_NAME använder VARCHAR2 med storleken 30
- CUST_LAST_NAME använder VARCHAR2 med storleken 60
- STREET_ADDRESS använder VARCHAR2 med storleken 65
- POST_CODE använder VARCHAR2 med storleken 20
- CITY använder VARCHAR2 med storleken 35
- STATE_PROVINCE använder VARCHAR2 med storleken 6
- COUNTRY_ID använder VARCHAR2 med storleken 4
- COUNTRY_NAME använder VARCHAR2 med storleken 60
- REGION_ID använder VARCHAR2 med storleken 2
- NLS_LANGUAGE använd VARCHAR2 med storleken 6
- NLS_TERRITORY använder VARCHAR2 med storleken 30
- CREDIT_LIMIT använd NUMBER med storlek/precision på 10 och skala 0
- CUST_EMAIL använder VARCHAR2 med storleken 60
- PRIMARY_PHONE_NUMBER använd VARCHAR2 med storleken 30
- PHONE_NUMBER_2 använder VARCHAR2 med storleken 30
- ACCOUNT_MGR_ID använder VARCHAR2 med storleken 6
- LOCATION_GTYPE använder INTEGER
- LOCATION_SRID använder INTEGER
- LOCATION_X använder NUMBER med storlek/precision på 14 och skala 6
- LOCATION_Y använd NUMBER med storlek/precision på 14 och skala 6
Klicka på knappen Nästa> för att gå till nästa steg.
Verifiera importparametrarna (äldre SQL-utvecklare)
För äldre (före 4.1.3) versioner av SQL Developer, ger det sista steget i dataimportguiden en chans att verifiera att dataparametrarna och inställningarna tillåter att datafilen tolkas. Den här skärmen visas nedan:
Klicka på knappen Verifiera för att kontrollera att alla inställningar fungerar korrekt. Resultaten av verifieringsprocessen visas nedan:
Om det finns några problem, använd
Nyare versioner av SQL Developer (4.1.3 och nyare) har en något annorlunda slutskärm. Vid denna tidpunkt har inställningarna redan kontrollerats och därför visas en sammanfattningsskärm. Knappen Spara tillstånd i det övre högra hörnet ger ett sätt att spara alla importinställningar till en fil. Den här inställningsfilen kan laddas nästa gång dataimportguiden körs.
I det här exemplet, om du använder den nyare versionen av SQL Developer, klicka på knappen Spara tillstånd och spara inställningarna i en fil med namnet:oracle_sqldev_import_customers.
I båda fallen (gammal eller nyare version av SQL Developer) för att starta dataimporten, klicka på knappen Slutför. När importen är klar visas en dialogruta. Eventuella fel som uppstår under importen kommer att visas.
Gå tillbaka till SQL Developer och se strukturen för den importerade tabellen.
Granska sedan data (klicka på fliken Data) för att se till att datavärdena importerades korrekt.
Spara importparametrarna (nyare versioner av SQL Developer)
Köra importen
För nyare versioner av SQL Developer kan de sparade importinställningarna importeras i det första steget i guiden Importera data för att köra om eller för att ändra importinställningar innan du kör om dataimporten.