Първи стъпки с Oracle SQL Developer в Windows

Въведение

Oracle SQL Developer е мощен инструмент за разработка с много функции за взаимодействие с бази данни на Oracle. В допълнение към писането и изпращането на SQL изрази с помощта на SQL работния лист, SQL Developer разполага с мощни инструменти за управление на бази данни, проектиране и обратно инженерство на бази данни с помощта на модели на данни и изпълнение на задачи за извличане на данни. Най-новата версия (Версия 19.4 от 20 декември 2019 г.) включва някои основни инструменти за администриране на база данни, поддръжка на REST заявки и анализиране на JSON документи.

Ако работите на MacOSX, тук можете да намерите инструкции за инсталиране и работа с SQL Developer на MacOSX.

Следващият раздел на този урок обхваща изтеглянето и инсталирането на SQL Developer. Ако вече имате изтеглен и инсталиран SQL Developer, може да пожелаете да преминете напред към следващата страница, за да научите как да създадете нова връзка с базата данни.

Към края на този урок има няколко страници, които обхващат как да пишете, изпълнявате и запазвате SQL изрази, как да експортирате данни с помощта на SQL Developer и как да импортирате данни в Oracle с помощта на SQL Developer. Може също да се интересувате от използването на SQL Developer за обратно проектиране на схема на Oracle. Този урок е свързан тук.

Изтегляне и инсталиране на SQL Developer

SQL Developer може да бъде изтеглен безплатно от мрежата на Oracle Developer. SQL Developer изисква Java Development Kit, за да работи. Например, SQL Developer версия 4.1.3 и по-нова изисква JDK 1.8.

Посетете следната връзка, за да изтеглите файловете на SQL Developer:

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

Изберете версията, която съответства на вашата операционна система (и или която включва JDK, ако е необходимо). Останалата част от този урок беше завършена с версията на Windows.

Изтеглянето на SQL Developer е единичен .zip файл, например:sqldeveloper-4.1.3.20.78-no-jre.zip (или по-нова версия, като sqldeveloper-17.4.0.355.2349-x64.zip)

Разархивирайте zip файла на SQL Developer в подходящо устройство. Резултатът трябва да бъде проста папка sqldeveloper.

Щракнете двукратно върху изпълнимия файл sqldeveloper.exe. Може да се появи диалогов прозорец, който подканва да посочите пътя към началната директория на Java Development Kit (JDK).

Щракнете върху бутона Преглед и отидете до началната папка на JDK.

Щракнете върху Избор на папка и пътят към JDK ще се появи в диалоговия прозорец:

Щракнете върху бутона OK и SQL Developer ще стартира

След като SQL Developer стартира, ще видите следния екран:

Конфигуриране на нова връзка с база данни

Първата поръчка е да създадете нова връзка към вашата база данни на Oracle. За да настроите нова връзка, ще трябва да знаете:

• Името (или IP адреса) на сървъра, на който се изпълнява Oracle. Ако сте инсталирали Oracle на вашия локален компютър, тогава е вероятно да използвате „localhost“ (или 127.0.01).
• Номерът на TCP/IP порта, където се изпълнява процесът на Oracle Listener. По подразбиране за Oracle се използва порт 1521. Освен ако не сте конфигурирали това по различен начин, използвайте 1521.
• Системният идентификатор (SID) на Oracle или име на услугата, който идентифицира конкретния екземпляр на Oracle на сървъра.

Някои често срещани комбинации може да са:

• Oracle 11g или 12c Enterprise Edition, инсталиран на същия (локален) сървър или компютър:Хост:localhost, Порт:1521, SID:orcl
• Oracle 11g Express Edition, инсталиран на същия (локален) сървър или компютър:Хост:localhost, Порт:1521, SID:xe
• Oracle 11g или 12c Enterprise Edition, инсталиран на отдалечения сървър:Хост:myhostname.domain.com, Порт:1521, SID:orcl
• Oracle 12c Enterprise Edition, инсталиран на отдалечения сървър, използвайки база данни с множество наематели:Хост:myhostname.domain.com, Порт:1521, Име на услуга:pdb1
• Oracle Autonomous Data Warehouse или автономна база данни за обработка на транзакции, работеща с Oracle Cloud:Променете Типа на връзка към Cloud Wallet и след това изберете .zip файла на портфейла си, който е изтеглен от вашата облачна база данни. Следвайте тези инструкции (Страница 6).

Имайте предвид, че ако вашата целева СУБД е автономна база данни в Oracle Cloud, ще трябва да следвате малко по-различни инструкции, които използват Oracle Cloud Wallet. Следвайте тези инструкции (Страница 6) за настройване на връзка с автономна база данни.

За да започнете да конфигурирате новата връзка, щракнете върху стрелката надолу до зеления знак + и изберете Нова връзка...

Ще се появи прозорецът по подразбиране „Ново / Избор на връзка с база данни“.

Дайте ново име за вашата връзка и попълнете потребителското име и паролата за акаунта в базата данни на Oracle, с който искате да се свържете.

Попълнете името на хоста с името на интернет хост или IP адреса на сървъра, на който се изпълнява базата данни на Oracle. Задайте порта така, че да съответства на мястото, където се изпълнява Oracle Listener (1521 е типичната по подразбиране).

Ако хостът има зададен системен идентификатор (SID) на Oracle, въведете го. В противен случай, ако сървърът на Oracle използва мулти-наемател (чрез oracle 12c или по-нова версия), изберете Име на услугата и въведете името на услугата за екземпляра на базата данни.

Други разширени настройки за удостоверяване, криптиране и сигурност могат да бъдат специфични, ако е необходимо.

По-долу е даден пример за свързване към екземпляр на Oracle 12c на локалния сървър с помощта на системния акаунт на Oracle. Паролата за този акаунт е зададена по време на инсталирането на базата данни.

Тествайте връзката, като щракнете върху бутона тест. Обърнете внимание на състоянието в долния ляв ъгъл, за да видите дали има съобщения за грешка. Изображението по-долу показва „успех“:

Типични грешки при влизане и неща за проверка

Има редица причини, поради които SQL Developer може да не осъществи успешна връзка със сървъра на Oracle. Някои от най-често срещаните потенциални проблеми и решения са изброени по-долу. Имайте предвид архитектурата на Oracle „клиент/сървър“ и факта, че между тях има мрежа.

Има проблем при свързването през мрежата между клиента на SQL Developer и сървъра на база данни на Oracle. Или името на хоста (или IP адреса), или номерът на порта е неправилен. Или някакъв друг мрежов проблем (DNS, защитна стена и т.н.) пречи на SQL Developer да се свърже със сървъра на Oracle. Възможно е също така Oracle Listener (мрежовата услуга, която приема входящи връзки) да не работи или да слуша друг мрежов порт. Опитайте да използвате traceroute (tracert на Windows), за да видите дали изобщо може да се достигне до сървъра. Проверете дали базата данни на Oracle работи и работи заедно с услугата Oracle Listener и че няма защитни стени да блокират връзките към порт 1521.

SQL Developer се свързва успешно с процеса на слушател на сървъра на Oracle, но предоставеният SID не съвпада с това, което е конфигурирано на сървъра на базата данни.

SQL Developer се свързва успешно със сървъра на Oracle, но предоставеното име на услугата не съответства на това, което е конфигурирано на сървъра на базата данни.

SQL Developer се свързва успешно със сървъра на Oracle и с инстанцията (така че името на хоста, порта и SID или името на услугата са правилни). Потребителското име и/или паролата обаче не съвпадат.

SQL Developer се свързва успешно със сървъра на Oracle и с инстанцията (така че името на хоста, порта и SID или името на услугата са правилни). Въпреки това акаунтът на Oracle е заключен (например твърде много неуспешни опити за влизане или паролата е изтекла).

SQL Developer се свързва успешно със сървъра на Oracle и с инстанцията (така че името на хоста, порта и SID или името на услугата са правилни). Въпреки това слушателят от своя страна не може да направи връзка с базата данни на Oracle. Това може да се случи, ако базата данни не работи или не е отворена, или ако сървърът, работещ с Oracle, няма RAM. Това може да се случи и ако има проблем с потребителските разрешения между процеса на слушател и процесите на базата данни.

Запазване на връзката на SQL Developer

Ако тестът е успешен, щракнете върху бутона Save, за да запазите тази връзка.

Свързване с базата данни на Oracle

И накрая, след като връзката е тествана и запазена, щракнете върху бутона Свързване, за да се свържете със сървъра на базата данни.

Четирите основни области на екрана вече включват:

Прозорец за връзка, прозорец на навигатора на отчети, работен лист на SQL и прозорец за изход на скрипт. Може да не видите прозореца за изход на скрипт, докато не изпълните SQL израз в работния лист на SQL. Ако по някаква причина работният лист на SQL не може да се види, издърпайте надолу Инструменти меню и изберете SQL работен лист елемент от менюто.

Всички SQL изрази могат да бъдат въведени директно в SQL работния лист или поставени от друг документ, уеб страница, имейл и т.н.

На работния лист на SQL е дадено име на файл по подразбиране, като orcl_localhost.sql

Този файл може да бъде запазен във всяка локална папка на компютъра. Запазването на този файл е чудесен начин да следите историята на SQL изразите, докато ги пишете и пренаписвате.

За да отворите съществуващ файл на SQL скрипт, издърпайте надолу менюто Файл и изберете Отвори. Придвижете се до папката с файла на SQL скрипта, маркирайте я и щракнете върху бутона Отвори.

Експортиране на данни на Oracle със SQL Developer

SQL Developer има функция, която прави много лесно експортирането на данни от таблица или изглед на Oracle. Има много различни начини за експортиране на данни от Oracle в зависимост от възможностите на целевата база данни или инструменти за данни. Някои често срещани примери за експортиране на данни включват:

• SQL Data Definition Language и SQL INSERT файл с изрази, използвани за повторно създаване на таблицата с данни в друга база данни.
• Файл и скриптове на Oracle SQL Loader, които могат да се използват за импортиране на данните в друга база данни или схема на Oracle.
• Файл със стойности, разделени със запетая (.csv), който може да бъде импортиран от много различни софтуерни инструменти, бази данни и т.н.
• Файл на Microsoft Excel
• Файл с разширяем език за маркиране (XML), който може да бъде импортиран в различни софтуерни инструменти
• Файл на езика за маркиране на хипертекст (HTML), който може да се показва на уеб страница
• Обикновен текстов файл с фиксирано разстояние или използващ някакъв друг разделител, който може да бъде импортиран от много различни софтуерни инструменти и бази данни.

Този пример предполага, че имате поне една таблица или изглед с данни във вашата схема (връзка), които могат да бъдат експортирани. Ако нямате нищо в схемата си, създайте основна таблица и добавете някои данни, като използвате SQL изразите по-долу:

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

За да започнете, отворете навигационното дърво в областта Connections отляво на екрана на SQL Developer. Под името на връзката ще бъдат изброени таблиците, изгледите, изгледите за издание, индексите и т.н. Отворете Таблиците и Прегледи категории също.

За този пример таблицата EMPLOYEE ще бъде експортирана.

Щракнете с десния бутон върху таблицата СЛУЖИТЕЛИ и изберете елемента от менюто Експортиране..., както е показано по-долу.

Това ще изведе кратък съветник за експортиране.

Настройките по подразбиране за експортиране на таблица на Oracle

Има много различни начини за експортиране на данни от Oracle в зависимост от възможностите на целевата база данни или инструменти за данни. За този пример таблицата EMPLOYEE ще бъде експортирана в електронна таблица на Microsoft Excel.

Когато експортирате в CSV файл или електронна таблица, не е необходимо да включвате езика за дефиниране на данни (DDL), който определя структурата на таблицата или изгледа. Така че за този пример премахнете квадратчето за отметка до Експортиране на DDL .

В Експортиране на данни раздел, променете Формат: доexcel 2003+ (xlsx)

Тази настройка за формат ще използва по-новия файлов формат на Excel, който може да побере до един милион реда. За обратна съвместимост с по-стари версии на Excel можете вместо това да изберете Excel ’95 – 2003 (xls) като формат.

Дайте име на новия работен лист в текстовото поле до Име на работен лист с данни: подкана.

Ако искате да включите текста на SQL израза, използван за изтегляне на данните от Oracle, поставете отметка в квадратчето до Query Worksheet Name и след това дайте ново име за работния лист на Excel, където ще се появи SQL синтаксисът (за този пример, избрахме да не включваме SQL кода).

Последният раздел указва как трябва да се съхраняват данните във файл или набор от файлове. За този пример данните ще бъдат експортирани в един файл. След това името на файла се дава в текстовото поле до Файл: бърза. Използвайте бутона Преглед..., за да намерите папка (директория), която има достатъчно свободно дисково пространство. След това добавете името на файла към пътя.

След като всички те са настроени (както е показано по-долу), щракнете върху бутона Next>.

Следващият екран предоставя две възможности за филтриране на колоните и/или редовете на данните, които ще бъдат експортирани.

По подразбиране всички колони и всички редове ще бъдат експортирани. За да изберете конкретни колони, щракнете върху пространството до таблицата под Колони заглавие. След това щракнете върху иконата на молив, за да редактирате. Ще се появи нов прозорец с отметки до колоните, които трябва да бъдат включени в експортирането на данни. За този пример всички колони ще бъдат експортирани.

Щракнете върху OK, за да затворите прозореца Data Columns.

За да филтрирате редовете, които ще бъдат експортирани, може да се добави клауза WHERE. Щракнете в пространството под заглавието Обект Къде и след това щракнете върху иконата Молив, за да изведете редактора Къде.

Добавете всякакви условия (като номер_отдел =1) необходими. За този пример не бяха добавени условия Where, тъй като бихме искали всички данни да бъдат експортирани. Щракнете върху бутона OK, за да затворите прозореца Data Where, когато приключите.

Щракнете върху бутона Next>, за да стигнете до екрана Export Summary. На този екран е посочено обобщение на всички опции за експортиране.

Ако някоя от опциите не е зададена правилно, използвайте бутона <Назад, за да се върнете към предишна стъпка и направете корекции, ако е необходимо.

Ако всички опции за експортиране изглеждат добре, щракнете върху бутона Край, за да започнете заданието за експортиране.

Ако получите някакви грешки, уверете се, че сте посочили дестинационна папка, която действително съществува (не просто копирайте сляпо това, което имам в този урок). Също така се уверете, че целевият файл не е вече отворен от Excel например.

Използвайте Windows Explorer, за да отидете до папката, за да видите новия експортиран файл. Например:

Отворете файла на Excel, за да видите съдържанието:

Преди да експортирате отново данните, не забравяйте да затворите файла на Excel.

Импортиране на данни с SQL Developer

SQL Developer има функция, която прави много лесно импортирането на данни от широк спектър от източници на данни в Oracle. Има много различни начини за импортиране на данни в Oracle в зависимост от източника на данните. Някои често срещани формати на данни, които SQL Developer може да импортира, включват:

• SQL Data Definition Language и SQL INSERT файл с изрази, използвани за повторно създаване на таблицата с данни в Oracle.
• Файл и скриптове на Oracle SQL Loader, които могат да се използват за импортиране на данните в Oracle.
• Файл със стойности, разделени със запетая (.csv)
• Файл на Microsoft Excel (.xls и .xlsx)
• Файл с разширяем език за маркиране (XML)
• Обикновен текстов файл с фиксирано разстояние или с друг разделител

Този пример предполага, че имате връзка с база данни на Oracle, направена чрез SQL Developer.

Файлът, който ще бъде импортиран, ще бъде файлът customers_export.csv, свързан тук. Данните изглеждат по следния начин (319 реда с 21 колони):

Първи стъпки с импортирането на данни

За да започнете, отворете навигационното дърво в областта Connections отляво на екрана на SQL Developer. Щракнете с десния бутон върху Таблиците запис и изберете елемента от менюто Импортиране на данни... от изскачащото меню.

В този момент по-старите версии на SQL Developer (преди 4.1.3) ще изведат диалогов прозорец за избор на файл, където можете да изберете файла, който да бъде импортиран. По-новите версии на SQL Developer (4.1.3 и по-нови) ще представят първата стъпка от съветника за импортиране на данни, както е показано по-долу.

За по-нов SQL Developer щракнете върху бутона Браузър, за да изведете диалоговия прозорец за избор на файл, за да изберете своя файл.

Придвижете се до папката, където се намира вашият файл, и го изберете. Имайте предвид, че Типът на файла е настроен да филтрира за файлове на Excel, CSV файлове и няколко други варианта на текстови файлове.

Щракнете върху бутона Отвори, за да стартирате съветника за импортиране на данни.

Преглед на данните за импортиране и потвърждаване на настройките

Първата стъпка от съветника за импортиране на данни предоставя предварителен преглед на данните, които ще бъдат импортирани. За този пример CSV файлът има ред заглавки, които съветникът за импортиране ще използва за създаване на имена на променливи. В тази стъпка на съветника има допълнителни опции за пропускане на определен брой редове в началото (0 в този пример), избор на форматиране (csv в този пример), кодиране на знаци, символи за кавички, използвани за ограждане на текст или низове и ред край/терминатор. В повечето случаи тези настройки могат да бъдат оставени по подразбиране.

Някои промени, които могат да помогнат в определени ситуации, включват:

• Променете Line Terminator на Line Feed само ако CSV файлът е създаден на операционна система Linux или Mac.
• Променете кодирането на конкретна кодова страница, която съответства на вашия регион на света (или света, под който е генериран CSV файлът).
• Променете броя на редовете за визуализация и превъртете през данните, за да се уверите, че всичко е анализирано правилно.

Ако всички настройки изглеждат добре и визуализираните данни изглеждат добре, щракнете върху бутона Next>, за да преминете към следващата стъпка.

Избор на метод за импортиране

Следващата стъпка в съветника е да посочите метода за импортиране. Предлагат се редица различни методи за импортиране:

• Вмъкване – Директно вмъкване на данните в нова или съществуваща таблица.
• Вмъкване на скрипт – Създайте файл на SQL скрипт, който включва всички необходими DDL и INSERT изрази за зареждане на данните в база данни. Този скрипт може да се стартира незабавно или да се премести в друга връзка с базата данни и да се стартира там.
• Външна таблица – Създава структура на външна таблица в Oracle, където таблицата се появява в речника с данни, но данните се поддържат във външен файл.
• Помощна програма за зареждане на SQL – Напишете скрипта и командите на SQL Loader за импортиране на данните в Oracle.

За този пример Вмъкване ще се използва методът, така че данните ще бъдат вмъкнати директно в нова таблица.

Посочете име на таблицата. Ако има причина да ограничите редовете за импортиране, проверете Ограничение за импортиране на редове поле и посочете броя на редовете. Например, ако вашият файл с данни има милиони редове, но вие просто се интересувате да знаете как изглежда част от данните, можете да ограничите броя на импортираните редове. В този пример всички редове ще бъдат импортирани.

Щракнете върху бутона Next>, за да преминете към следващата стъпка.

Изберете колоните за импортиране

Стъпка 3 от съветника е да изберете колоните за импортиране. Маркирайте всички колони в Налични колони прозорец и щракнете върху стрелката надясно, за да ги преведете до Избрани колони прозорец. В този пример всички колони ще бъдат импортирани.

Щракнете върху бутона Next>, за да преминете към следващата стъпка.

Присвояване на типове данни за всяка колона

Стъпка 4 от съветника ни позволява да дефинираме типовете данни и размерите за колоните, които да бъдат създадени в новата таблица с данни. Това е много критична стъпка! Ако е избран грешен тип данни или ако даден тип данни няма достатъчно място за съхранение на входящите данни, импортирането ще бъде неуспешно.

По-новите версии на SQL Developer ще показват визуализация на данните за всяка колона, когато е избрана:

Някои често срещани проблеми включват:

• Не осигурява достатъчно място в колона VARACHAR, за да побере най-голямата низова/текстова стойност.
• Използване на тип данни NUMBER в колона, когато някои текстови знаци присъстват в данните.
• Използване на неправилен формат на дата или час при импортиране на дати и часове.

Посетете всяка от Колоните с изходни данни като щракнете върху тях един по един. Направете корекции на типовете данни, докато продължавате. За този пример се правят следните корекции:

• CUSTOMER_ID променете на INTEGER тип данни и премахнете квадратчето за отметка за Nullable
• CUST_FIRST_NAME използва VARCHAR2 с размер 30
• CUST_LAST_NAME използва VARCHAR2 с размер 60
• STREET_ADDRESS използва VARCHAR2 с размер 65
• POST_CODE използва VARCHAR2 с размер 20
• CITY използва VARCHAR2 с размер 35
• STATE_PROVINCE използва VARCHAR2 с размер 6
• COUNTRY_ID използва VARCHAR2 с размер 4
• COUNTRY_NAME използва VARCHAR2 с размер 60
• REGION_ID използва VARCHAR2 с размер 2
• NLS_LANGUAGE използва VARCHAR2 с размер 6
• NLS_TERRITORY използват VARCHAR2 с размер 30
• CREDIT_LIMIT използвайте NUMBER с размер/прецизност 10 и мащаб 0
• CUST_EMAIL използва VARCHAR2 с размер 60
• PRIMARY_PHONE_NUMBER използва VARCHAR2 с размер 30
• PHONE_NUMBER_2 използва VARCHAR2 с размер 30
• ACCOUNT_MGR_ID използва VARCHAR2 с размер 6
• LOCATION_GTYPE използва INTEGER
• LOCATION_SRID използва INTEGER
• LOCATION_X използва NUMBER с размер/прецизност 14 и мащаб 6
• LOCATION_Y използвайте NUMBER с размер/прецизност 14 и мащаб 6

Щракнете върху бутона Next>, за да преминете към следващата стъпка.

Проверете параметрите за импортиране (по-стар SQL разработчик)

За по-стари (преди 4.1.3) версии на SQL Developer, последната стъпка от съветника за импортиране на данни дава възможност да се провери дали параметрите и настройките на данните ще позволят анализирането на файла с данни. Този екран е показан по-долу:

Щракнете върху бутона Проверка, за да се уверите, че всички настройки работят правилно. Резултатите от процеса на проверка са показани по-долу:

Ако има някакви проблеми, използвайте бутона <Назад, за да се върнете към предишните екрани, за да промените настройките.

Запазете параметрите за импортиране (по-нови версии на SQL Developer)

По-новите версии на SQL Developer (4.1.3 и по-нови) имат малко по-различен краен екран. В този момент настройките вече са проверени и така се показва екран с обобщение. Бутонът Save State в горния десен ъгъл предоставя начин да запишете всички настройки за импортиране във файл. Този файл с настройки може да бъде зареден следващия път, когато се стартира съветникът за импортиране на данни.

За този пример, ако използвате по-новата версия на SQL Developer, щракнете върху бутона Save State и запазете настройките във файл с име:oracle_sqldev_import_customers.

Изпълнение на импортирането

И в двата случая (стара или по-нова версия на SQL Developer), за да започнете импортирането на данни, щракнете върху бутона Край. След като импортирането приключи, ще се появи диалогов прозорец. Всички грешки, възникнали по време на импортирането, ще бъдат показани.

Върнете се обратно към SQL Developer и вижте структурата на импортираната таблица.

След това прегледайте данните (щракнете върху раздела Данни), за да се уверите, че стойностите на данните са импортирани правилно.

За по-нови версии на SQL Developer, запазените файлове с настройки за импортиране могат да бъдат импортирани на първата стъпка от съветника за импортиране на данни, за да се стартират повторно или да се променят настройките за импортиране преди повторното изпълнение на импортирането на данни.