Začínáme s Oracle SQL Developer v systému Windows

Úvod

Oracle SQL Developer je výkonný vývojový nástroj s mnoha funkcemi pro interakci s databázemi Oracle. Kromě psaní a odesílání příkazů SQL pomocí pracovního listu SQL má SQL Developer výkonné nástroje pro správu databází, navrhování a reverzní inženýrství databází pomocí datových modelů a spouštění úloh dolování dat. Nejnovější verze (verze 19.4 z 20. prosince 2019) obsahuje některé základní nástroje pro správu databáze, podporu pro dotazy REST a analýzu dokumentů JSON.

Pokud pracujete na MacOSX, pokyny k instalaci a práci s SQL Developer na MacOSX naleznete zde.

Další část tohoto kurzu se zabývá stažením a instalací SQL Developer. Pokud již máte SQL Developer stažený a nainstalovaný, možná budete chtít přeskočit na další stránku, kde se dozvíte, jak vytvořit nové připojení k databázi.

Ke konci tohoto tutoriálu je několik stránek, které pokrývají, jak psát, spouštět a ukládat příkazy SQL, jak exportovat data pomocí SQL Developer a jak importovat data do Oracle pomocí SQL Developer. Také by vás mohlo zajímat použití SQL Developer k reverzní analýze schématu Oracle. Tento návod je propojen zde.

Stažení a instalace SQL Developer

SQL Developer lze zdarma stáhnout ze sítě Oracle Developer's. SQL Developer vyžaduje ke spuštění Java Development Kit. Například SQL Developer verze 4.1.3 a novější vyžaduje JDK 1.8.

Navštivte následující odkaz a stáhněte si soubory SQL Developer:

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

Vyberte verzi, která odpovídá vašemu operačnímu systému (a nebo která v případě potřeby obsahuje JDK). Zbytek tohoto kurzu byl dokončen pomocí verze pro Windows.

SQL Developer ke stažení je jeden soubor .zip, například:sqldeveloper-4.1.3.20.78-no-jre.zip (nebo novější verze, jako je sqldeveloper-17.4.0.355.2349-x64.zip)

Rozbalte soubor zip SQL Developer na příslušnou jednotku. Výsledkem by měla být jednoduchá složka sqldeveloper.

Dvakrát klikněte na spustitelný soubor sqldeveloper.exe. Může se objevit dialogové okno s výzvou k zadání cesty k domovskému adresáři Java Development Kit (JDK).

Klikněte na tlačítko Procházet a přejděte do domovské složky JDK.

Klikněte na Vybrat složku a v dialogovém okně se objeví cesta k JDK:

Klikněte na tlačítko OK a SQL Developer se spustí

Jakmile je SQL Developer spuštěn, uvidíte následující obrazovku:

Konfigurace nového databázového připojení

Prvním úkolem je vytvořit nové připojení k vaší databázi Oracle. Chcete-li nastavit nové připojení, budete potřebovat vědět:

• Název (nebo IP adresa) serveru, na kterém běží Oracle. Pokud jste na svůj místní počítač nainstalovali Oracle, pak je pravděpodobné, že můžete použít „localhost“ (nebo 127.0.01).
• Číslo portu TCP/IP, na kterém běží proces Oracle Listener. Výchozí pro Oracle je použití portu 1521. Pokud jste toto nenakonfigurovali jinak, použijte 1521.
• Identifikátor systému Oracle (SID) nebo název služby, který identifikuje konkrétní instanci Oracle na serveru.

Některé běžné kombinace mohou být:

• Oracle 11g nebo 12c Enterprise Edition nainstalovaný na stejném (místním) serveru nebo PC:Host:localhost, Port:1521, SID:orcl
• Oracle 11g Express Edition nainstalovaný na stejném (místním) serveru nebo PC:Hostitel:localhost, Port:1521, SID:xe
• Oracle 11g nebo 12c Enterprise Edition nainstalovaný na vzdáleném serveru:Host:myhostname.domain.com, Port:1521, SID:orcl
• Oracle 12c Enterprise Edition nainstalovaný na vzdáleném serveru pomocí databáze pro více tenantů:Host:myhostname.domain.com, Port:1521, Service Name:pdb1
• databáze Oracle Autonomous Data Warehouse nebo Autonomous Transaction Processing se systémem Oracle Cloud:Změňte Typ připojení do Cloudové peněženky a poté vyberte soubor .zip vaší peněženky, který se stáhl z instance vaší cloudové databáze. Postupujte podle těchto pokynů (Strana 6).

Všimněte si, že pokud je vaším cílovým DBMS autonomní databáze v Oracle Cloud, budete muset postupovat podle mírně odlišných pokynů, které využívají Oracle Cloud Wallet. Při nastavování připojení k autonomní databázi postupujte podle těchto pokynů (Strana 6).

Chcete-li začít s konfigurací nového připojení, klikněte na šipku dolů vedle zeleného znaku + a vyberte Nové připojení…

Zobrazí se výchozí okno „New / Select Database Connection“.

Zadejte nový název pro své připojení a vyplňte uživatelské jméno a heslo pro databázový účet Oracle, ke kterému se chcete připojit.

Do pole Hostname zadejte název internetového hostitele nebo IP adresu serveru, na kterém běží databáze Oracle. Nastavte port tak, aby odpovídal tomu, kde běží Oracle Listener (1521 je typické výchozí nastavení).

Pokud má hostitel nastavený identifikátor systému Oracle (SID), zadejte jej. V opačném případě, pokud server Oracle používá více nájemců (prostřednictvím Oracle 12c nebo novější), vyberte Název služby a zadejte název služby pro instanci databáze.

Další pokročilá nastavení ověřování, šifrování a zabezpečení pak mohou být v případě potřeby specifická.

Níže je uveden příklad připojení k instanci Oracle 12c na místním serveru pomocí systémového účtu Oracle. Heslo pro tento účet bylo nastaveno během instalace databáze.

Otestujte připojení kliknutím na testovací tlačítko. Všimněte si Stavu v levém dolním rohu, abyste viděli, zda se nevyskytují nějaké chybové zprávy. Obrázek níže ukazuje „úspěch“:

Typické chyby přihlášení a věci ke kontrole

Existuje řada důvodů, proč se SQL Developer nemusí úspěšně připojit k serveru Oracle. Některé z častějších potenciálních problémů a řešení jsou uvedeny níže. Mějte na paměti architekturu Oracle „Client/Server“ a skutečnost, že mezi nimi existuje síť.

Došlo k problému s připojením přes síť mezi klientem SQL Developer a databázovým serverem Oracle. Název hostitele (nebo adresa IP) nebo číslo portu jsou nesprávné. Nebo nějaký jiný síťový problém (DNS, Firewall atd.) brání SQL Developeru v připojení k serveru Oracle. Je také možné, že Oracle Listener (síťová služba, která přijímá příchozí připojení) neběží nebo naslouchá jinému síťovému portu. Zkuste použít traceroute (tracert v systému Windows), abyste zjistili, zda je server vůbec dosažitelný. Ověřte, že je databáze Oracle spuštěna a běží společně se službou Oracle Listener a že připojení k portu 1521 neblokují žádné brány firewall.

SQL Developer se úspěšně připojuje k procesu naslouchání serveru Oracle, avšak poskytnuté SID neodpovídá tomu, co je nakonfigurováno na databázovém serveru.

SQL Developer se úspěšně připojuje k serveru Oracle, ale zadaný název služby neodpovídá tomu, co je nakonfigurováno na databázovém serveru.

SQL Developer se úspěšně připojuje k serveru Oracle a k instanci (takže název hostitele, port a SID nebo název služby jsou správné). Uživatelské jméno a/nebo heslo se však neshodují.

SQL Developer se úspěšně připojuje k serveru Oracle a k instanci (takže název hostitele, port a SID nebo název služby jsou správné). Účet Oracle byl však uzamčen (např. příliš mnoho neúspěšných pokusů o přihlášení nebo vypršela platnost hesla).

SQL Developer se úspěšně připojuje k serveru Oracle a k instanci (takže název hostitele, port a SID nebo název služby jsou správné). Posluchač se však nemůže připojit k databázi Oracle. K tomu může dojít, pokud databáze není spuštěna nebo otevřena, nebo pokud serveru se systémem Oracle dochází RAM. Může k tomu také dojít, pokud mezi procesem posluchače a procesy databáze dojde k problému s uživatelskými oprávněními.

Uložení SQL Developer Connection

Pokud je test úspěšný, kliknutím na tlačítko Uložit toto připojení uložte.

Připojení k databázi Oracle

Nakonec, když bylo připojení otestováno a uloženo, klepnutím na tlačítko Připojit se připojte k databázovému serveru.

Čtyři hlavní oblasti obrazovky nyní zahrnují:

Okno připojení, okno Navigátor sestav, pracovní list SQL a okno výstupu skriptu. Okno Výstup skriptu se nemusí zobrazit, dokud nespustíte příkaz SQL v listu SQL. Pokud z nějakého důvodu nelze pracovní list SQL navštívit, stáhněte si Nástroje a vyberte SQL list položka nabídky.

Jakékoli příkazy SQL lze zadat přímo do listu SQL nebo vložit z jiného dokumentu, webové stránky, e-mailu atd.

List SQL má výchozí název souboru, například orcl_localhost.sql

Tento soubor lze uložit do libovolné místní složky v počítači. Uložení tohoto souboru je skvělý způsob, jak sledovat historii příkazů SQL při jejich psaní a přepisování.

Chcete-li otevřít existující soubor skriptu SQL, rozbalte nabídku Soubor a vyberte Otevřít. Přejděte do složky se souborem skriptu SQL, zvýrazněte ji a klikněte na tlačítko Otevřít.

Export dat Oracle pomocí SQL Developer

SQL Developer má funkci, která velmi usnadňuje export dat z tabulky nebo pohledu Oracle. Existuje mnoho různých způsobů exportu dat z Oracle v závislosti na možnostech cílové databáze nebo datových nástrojů. Mezi běžné příklady exportu dat patří:

• SQL Data Definition Language a soubor příkazů SQL INSERT používaný k opětovnému vytvoření tabulky s daty v jiné databázi.
• Soubor a skripty Oracle SQL Loader, které lze použít k importu dat do jiné databáze nebo schématu Oracle.
• Soubor .csv (Comma-Separated Values), který lze importovat mnoha různými softwarovými nástroji, databázemi atd.
• Soubor Microsoft Excel
• Soubor XML (eXtensible Markup Language), který lze importovat do různých softwarových nástrojů
• Soubor HTML (HyperText Markup Language), který lze zobrazit na webové stránce
• Prostý textový soubor s pevnými mezerami nebo pomocí jiného oddělovače, který lze importovat mnoha různými softwarovými nástroji a databázemi.

Tento příklad předpokládá, že máte alespoň jednu tabulku nebo pohled s daty ve schématu (připojení), které lze exportovat. Pokud ve schématu nic nemáte, vytvořte základní tabulku a přidejte některá data pomocí příkazů SQL níže:

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

Chcete-li začít, otevřete navigační strom v oblasti Připojení nalevo na obrazovce SQL Developer. Pod názvem připojení budou uvedeny Tabulky, Zobrazení, Zobrazení vydání, Indexy atd. Otevřete Tabulky a Zobrazení kategorie také.

V tomto příkladu bude exportována tabulka ZAMĚSTNANCI.

Klikněte pravým tlačítkem na tabulku ZAMĚSTNANEC a vyberte položku nabídky Export…, jak je uvedeno níže.

Zobrazí se krátký Průvodce exportem.

Výchozí nastavení pro export tabulky Oracle

Existuje mnoho různých způsobů exportu dat z Oracle v závislosti na možnostech cílové databáze nebo datových nástrojů. V tomto příkladu bude tabulka ZAMĚSTNANEC exportována do tabulky Microsoft Excel.

Při exportu do souboru CSV nebo tabulky není nutné zahrnout jazyk DDL (Data Definition Language), který určuje strukturu tabulky nebo pohledu. V tomto příkladu tedy zrušte zaškrtnutí políčka Exportovat DDL .

V části Export dat části, změňte Formát: na excel 2003+ ( xlsx )

Toto nastavení formátu použije novější formát souboru aplikace Excel, který pojme až jeden milion řádků. Pro zpětnou kompatibilitu se staršími verzemi Excelu můžete místo toho vybrat Excel ’95 – 2003 (xls) jako Formát.

Zadejte název nového listu v textovém poli vedle položky Název datového listu: výzva.

Pokud chcete zahrnout text příkazu SQL použitého k vytažení dat z Oracle, zaškrtněte políčko vedle Název listu dotazu a poté zadejte nový název listu Excelu, kde se objeví syntaxe SQL (pro tento příklad rozhodli jsme se nezahrnout kód SQL).

Poslední část určuje, jak mají být data uložena v souboru nebo sadě souborů. V tomto příkladu budou data exportována do jednoho souboru. Název souboru je pak uveden v textovém poli vedle Soubor: výzva. Pomocí tlačítka Procházet… vyhledejte složku (adresář), která má dostatek volného místa na disku. Poté do cesty přidejte název souboru.

Jakmile jsou všechny tyto položky nastaveny (jak je uvedeno níže), klepněte na tlačítko Další>.

Další obrazovka nabízí dvě možnosti filtrování sloupců a/nebo řádků v datech, která mají být exportována.

Ve výchozím nastavení budou exportovány všechny sloupce a všechny řádky. Chcete-li vybrat konkrétní sloupce, klikněte na místo vedle tabulky pod položkou Sloupce nadpis. Poté klikněte na ikonu tužky a upravte. Objeví se nové okno se zaškrtávacími značkami vedle sloupců, které mají být zahrnuty do exportu dat. V tomto příkladu budou exportovány všechny sloupce.

Klepnutím na OK zavřete okno Data Columns.

Chcete-li filtrovat řádky, které se mají exportovat, lze přidat klauzuli WHERE. Klikněte do prostoru pod nadpisem Kde objektu a poté kliknutím na ikonu tužky vyvolejte editor kde.

Přidejte jakékoli podmínky (jako například číslo_oddělení =1) nutné. V tomto příkladu nebyly přidány žádné podmínky Where, protože bychom chtěli exportovat všechna data. Klepnutím na tlačítko OK po dokončení zavřete okno Data Where.

Klepnutím na tlačítko Další> přejděte na obrazovku Souhrn exportu. Na této obrazovce je uveden souhrn všech možností exportu.

Pokud některá z možností není nastavena správně, pomocí tlačítka

Pokud všechny možnosti exportu vypadají dobře, kliknutím na tlačítko Dokončit spusťte úlohu exportu.

Pokud se zobrazí nějaké chyby, ujistěte se, že jste zadali cílovou složku, která skutečně existuje (nestačí jen slepě zkopírovat to, co mám v tomto návodu). Také se ujistěte, že cílový soubor již není otevřen například aplikací Excel.

Pomocí Průzkumníka Windows přejděte do složky a zobrazte nový exportovaný soubor. Například:

Chcete-li zobrazit obsah, otevřete soubor aplikace Excel:

Před opětovným exportem dat nezapomeňte zavřít soubor Excel.

Import dat pomocí SQL Developer

SQL Developer má funkci, která velmi usnadňuje import dat z široké škály datových zdrojů do Oracle. Existuje mnoho různých způsobů, jak importovat data do Oracle v závislosti na zdroji dat. Některé běžné datové formáty, které může SQL Developer importovat, zahrnují:

• SQL Data Definition Language a soubor příkazů SQL INSERT používaný k opětovnému vytvoření tabulky s daty v Oracle.
• Soubor Oracle SQL Loader a skripty, které lze použít k importu dat do Oracle.
• Soubor s hodnotami oddělenými čárkami (.csv)
• Soubor Microsoft Excel (.xls a .xlsx)
• Soubor XML (eXtensible Markup Language)
• Prostý textový soubor s pevnými mezerami nebo pomocí jiného oddělovače

Tento příklad předpokládá, že máte připojení k databázi Oracle vytvořené prostřednictvím SQL Developer.

Soubor, který se má importovat, bude soubor customers_export.csv, který je zde propojen. Data vypadají následovně (319 řádků s 21 sloupci):

Začínáme s importem dat

Chcete-li začít, otevřete navigační strom v oblasti Připojení nalevo na obrazovce SQL Developer. Klikněte pravým tlačítkem na Tabulky a vyberte položku nabídky Importovat data… z místní nabídky.

V tomto okamžiku starší verze SQL Developer (před 4.1.3) zobrazí dialogové okno pro výběr souboru, kde můžete vybrat soubor, který chcete importovat. Novější verze SQL Developer (4.1.3 a novější) představí první krok Průvodce importem dat, jak je znázorněno níže.

Pro novější SQL Developer kliknutím na tlačítko Browser vyvolejte dialogové okno File Selection pro výběr souboru.

Přejděte do složky, kde se nachází váš soubor, a vyberte jej. Všimněte si, že Typ souboru byl nastaven na filtrování souborů Excel, CSV a několika dalších variant textových souborů.

Klepnutím na tlačítko Otevřít spustíte průvodce importem dat.

Náhled dat k importu a potvrzení nastavení

První krok Průvodce importem dat poskytuje náhled dat, která mají být importována. V tomto příkladu má soubor CSV řadu záhlaví, které průvodce importem použije k vytvoření názvů proměnných. V tomto kroku průvodce jsou další možnosti pro přeskočení určitého počtu řádků na začátku (v tomto příkladu 0), výběr formátování (v tomto příkladu csv), kódování znaků, symboly uvozovek používané k uzavření textu nebo řetězců a řádku zakončení/terminátor. Ve většině případů lze tato nastavení ponechat ve výchozím nastavení.

Některé změny, které mohou v určitých situacích pomoci, zahrnují:

• Změnu Line Terminator na Line Feed pouze v případě, že soubor CSV byl vytvořen v operačním systému Linux nebo Mac.
• Změňte kódování na konkrétní kódovou stránku, která odpovídá vaší světové oblasti (nebo světové oblasti, pod kterou byl soubor CSV vygenerován).
• Změňte počet řádků náhledu a procházejte data, abyste se ujistili, že bylo vše správně analyzováno.

Pokud všechna nastavení vypadají dobře a data v náhledu vypadají dobře, klikněte na tlačítko Další> a přejděte k dalšímu kroku.

Výběr metody importu

Dalším krokem v průvodci je zadání metody importu. K dispozici je řada různých metod importu:

• Vložit – Přímo vloží data do nové nebo existující tabulky.
• Vložit skript – Vytvořte soubor skriptu SQL, který obsahuje všechny potřebné příkazy DDL a INSERT k načtení dat do databáze. Tento skript lze spustit okamžitě nebo jej přesunout do jiného připojení k databázi a spustit tam.
• Externí tabulka – Nastavuje externí strukturu tabulky v rámci Oracle, kde se tabulka zobrazuje v datovém slovníku, ale data jsou udržována v externím souboru.
• Nástroj SQL Loader Utility – Napište skript SQL Loader a příkazy pro import dat do Oracle.

V tomto příkladu Vložit bude použita metoda, takže data budou vložena přímo do nové tabulky.

Zadejte název tabulky. Pokud existuje důvod k omezení počtu řádků k importu, zaškrtněte políčko Importovat limit řádků pole a zadejte počet řádků. Pokud má například váš datový soubor miliony řádků, ale zajímá vás, jak vypadá část dat, můžete omezit počet importovaných řádků. V tomto příkladu budou importovány všechny řádky.

Klepnutím na tlačítko Další> přejděte k dalšímu kroku.

Vyberte sloupce k importu

Krok 3 průvodce je výběr sloupců k importu. Zvýrazněte všechny sloupce v části Dostupné sloupce a kliknutím na šipku vpravo je přesuňte do Vybraných sloupců okno. V tomto příkladu budou importovány všechny sloupce.

Klepnutím na tlačítko Další> přejděte k dalšímu kroku.

Přiřazení datových typů ke každému sloupci

Krok 4 průvodce nám umožňuje definovat datové typy a velikosti pro sloupce, které mají být vytvořeny v nové datové tabulce. Toto je velmi důležitý krok! Pokud je vybrán nesprávný datový typ nebo pokud datový typ nemá dostatek místa pro uložení příchozích dat, import se nezdaří.

Novější verze SQL Developer zobrazí náhled dat pro každý sloupec, jak je vybrán:

Mezi běžné problémy patří:

• Ve sloupci VARACHAR není k dispozici dostatek místa pro umístění největší hodnoty řetězce/textu.
• Použití datového typu NUMBER ve sloupci, pokud jsou v datech přítomny nějaké textové znaky.
• Použití nesprávného formátu data nebo času při importu dat a časů.

Navštivte každý ze sloupců zdrojových dat kliknutím na ně jeden po druhém. Průběžně upravujte datové typy. V tomto příkladu jsou provedeny následující úpravy:

• CUSTOMER_ID se změní na typ dat INTEGER a zrušte zaškrtnutí políčka pro hodnotu Null
• CUST_FIRST_NAME používá VARCHAR2 o velikosti 30
• CUST_LAST_NAME používá VARCHAR2 o velikosti 60
• STREET_ADDRESS používá VARCHAR2 o velikosti 65
• POST_CODE používá VARCHAR2 o velikosti 20
• CITY používá VARCHAR2 o velikosti 35
• STATE_PROVINCE používá VARCHAR2 o velikosti 6
• COUNTRY_ID používá VARCHAR2 o velikosti 4
• COUNTRY_NAME používá VARCHAR2 o velikosti 60
• REGION_ID používá VARCHAR2 o velikosti 2
• NLS_LANGUAGE používá VARCHAR2 s velikostí 6
• NLS_TERRITORY používá VARCHAR2 o velikosti 30
• CREDIT_LIMIT použijte NUMBER s velikostí/přesností 10 a měřítkem 0
• CUST_EMAIL používá VARCHAR2 o velikosti 60
• PRIMARY_PHONE_NUMBER používá VARCHAR2 o velikosti 30
• PHONE_NUMBER_2 používá VARCHAR2 o velikosti 30
• ACCOUNT_MGR_ID používá VARCHAR2 o velikosti 6
• LOCATION_GTYPE používá INTEGER
• LOCATION_SRID používá INTEGER
• LOCATION_X používá NUMBER s velikostí/přesností 14 a měřítkem 6
• LOCATION_Y používá NUMBER s velikostí/přesností 14 a měřítkem 6

Klepnutím na tlačítko Další> přejděte k dalšímu kroku.

Ověřte parametry importu (starší vývojář SQL)

U starších verzí (před verzí 4.1.3) SQL Developer poskytuje poslední krok Průvodce importem dat možnost ověřit, zda parametry a nastavení dat umožní analýzu datového souboru. Tato obrazovka je zobrazena níže:

Klikněte na tlačítko Ověřit, abyste ověřili, že všechna nastavení fungují správně. Výsledky ověřovacího procesu jsou uvedeny níže:

Pokud se vyskytnou nějaké problémy, pomocí tlačítka

Uložte parametry importu (novější verze SQL Developer)

Novější verze SQL Developer (4.1.3 a novější) mají mírně odlišnou konečnou obrazovku. V tomto okamžiku již byla nastavení zkontrolována, a tak se zobrazí obrazovka Souhrn. Tlačítko Uložit stav v pravém horním rohu poskytuje způsob, jak uložit všechna nastavení importu do souboru. Tento soubor nastavení lze načíst při příštím spuštění Průvodce importem dat.

V tomto příkladu, pokud používáte novější verzi SQL Developer, klikněte na tlačítko Uložit stav a uložte nastavení do souboru s názvem:oracle_sqldev_import_customers.

Spuštění importu

V obou případech (stará nebo novější verze SQL Developer) spustíte import dat kliknutím na tlačítko Dokončit. Po dokončení importu se zobrazí dialogové okno. Zobrazí se všechny chyby, ke kterým dojde během importu.

Vraťte se zpět do SQL Developer a zobrazte strukturu importované tabulky.

Dále zkontrolujte data (klikněte na kartu Data), abyste se ujistili, že hodnoty dat byly importovány správně.

U novějších verzí SQL Developer lze uložené soubory nastavení importu importovat v prvním kroku průvodce importem dat a znovu spustit nebo změnit nastavení importu před opětovným spuštěním importu dat.