Managing Your Database Using Oracle SQL Developer

Purpose

This tutorial introduces Oracle SQL Developer and shows you how to manage your database objects.

Time to Complete

Approximately 50 minutes

Topics

This tutorial covers the following topics:

 Overview
 Prerequisites
 Creating a Database Connection
 Adding a New Table Using the Create Table Dialog Box
 Changing a Table Definition
 Adding Table Constraints
 Adding Data to a Table
 Accessing Data
 Creating Reports
 Creating and Executing PL/SQL
 Summary

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: This action loads all screenshots simultaneously, so response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over an individual icon in the following steps to load and view only the screenshot associated with that step. You can hide an individual screenshot by clicking it.

Overview

Oracle SQL Developer is a free graphical tool that enhances productivity and simplifies database development tasks. Using SQL Developer, users can browse database objects, run SQL statements, edit and debug PL/SQL statements and run reports, whether provided or created.

Developed in Java, SQL Developer runs on Windows, Linux and the Mac OS X. This is a great advantage to the increasing numbers of developers using alternative platforms. Multiple platform support also means that users can install SQL Developer on the Database Server and connect remotely from their desktops, thus avoiding client server network traffic.

Default connectivity to the database is through the JDBC Thin driver, so no Oracle Home is required. To install SQL Developer simply unzip the downloaded file. With SQL Developer users can connect to Oracle Databases 9.2.0.1 and later, and all Oracle database editions including Express Edition.

Back to Topic List

Prerequisites

Before you perform this tutorial, you should:

1.

Install the Oracle Database 10g or later or Oracle Database XE.

2.

Install Oracle SQL Developer 1.5.1.
Note: Oracle SQL Developer is available for download for FREE from OTN. To install Oracle SQL Developer, unzip it into any directory on your machine.

3.

Download and unzip the sqldevmngdb.zip file into your working directory (i.e.wkdir)

4.

Make sure that the Sample Schemas are installed. You will use the HR schema in this tutorial.

Back to Topic List

Creating a Database Connection

The first step to managing database objects using Oracle SQL Developer is to create a database connection. Perform the following steps:

1.

Open Oracle SQL Developer from the icon on your desktop.

 

2.

In the Connections navigator, right-click Connections and select New Connection.

 

3.

Enter HR_ORCL for the Connection Name (or any other name that identifies your connection), hr for the Username and Password, specify your localhost for the Hostname and enter ORCL for the SID. Click Test.

 

4.

The status of the connection was tested successfully. The connection was not saved however. Click Save to save the connection, and then click Connect.

The connection was saved and you see the database in the list.

 

5.

Expand HR_ORCL.

Note: When a connection is opened, a SQL Worksheet is opened automatically. The SQL Worksheet allows you to execute SQL against the connection you just created.

 

6.

Expand Tables .

 

7.

Select the Table EMPLOYEES to view the table definition.

 

8.

To see the data, click the Data tab.

The data is shown. In the next topic, you create a new table and populate the table with data.

Back to Topic List

Adding a New Table Using the Create Table Dialog Box

You create a new table called DEPENDENTS which has a foreign key to the EMPLOYEES table. Perform the following steps:

1.

Right-click Tables and select New TABLE...

 

2.

Enter DEPENDENTS for the Table Name and click the Advanced check box.

 

3.

Enter ID for the Name, select NUMBER for the Data type and enter 6 for the Precision. Select the Cannot be NULL check box. Then click the Add Column icon.

 

4.

Enter FIRST_NAME for the Name, leave type as VARCHAR2 and 20 for the Size. Then click the Add Column icon.

 

5.

Enter LAST_NAME for the Name, leave type as VARCHAR2 and enter 25 for the Size. Select the Cannot be NULL check box. Then click the Add Column icon.

 

6.

Enter BIRTHDATE for the Name, select DATE for the Data type. Then click the Add Column icon.

 

7.

Enter RELATION for the Name, leave type as VARCHAR2 and enter 25 for the Size.

Click OK to create the table.

Your new table appears in the list of tables.

 

Back to Topic List

Changing a Table Definition

Oracle SQL Developer makes it very easy to make changes to database objects. In this topic, you add a column to the DEPENDENTS table you just created. Perform the following steps:

1.

Select the DEPENDENTS table.

 

2.

Right-click, select Column then Add.

 

3.

Enter RELATIVE_ID, select NUMBER from the droplist, set the Scale to 0 and the Precision to 6.

Click Apply.

 

4.

The confirmation verifies that a column has been added.

Click OK.

 

5.

Right-click the Tables node for the HR_ORCL Database Connection and click Refresh.

 

6.

Expand the DEPENDENTS table to review the updates.

 

Back to Topic List

Adding Table Constraints

In this topic, you create the Primary and Foreign Key Constraints for the DEPENDENTS table. Perform the following steps:

1.

Right-click DEPENDENTS table and select Edit...

 

2.

Click the Primary Key node in the tree.

 

3.

Select the ID column and click > to shuttle the value to the Selected Columns window.

 

4.

Select the Foreign Key node in the tree and click Add.

 

5.

Select EMPLOYEES for the Referenced Table and select RELATIVE_ID for the Local Column and click OK.

 

Back to Topic List

Adding Data to a Table

You can add data to the DEPENDENTS table by performing the following steps:

1.

With the DEPENDENTS table still selected, click the Data tab.

 

2.

Then click the Insert Row icon.

 

3.

Enter the following data.

ID: 209
FIRST_NAME: Sue
LAST_NAME: Littlefield
BIRTHDATE: 01-JAN-97
RELATION: Daughter
RELATIVE_ID: 110

 

4.

Click Commit  to commit the row to the database. The outcome of the commit action displays in the log window.

 

5.

You can also load multiple rows at one time using a script. Click File Open...

 

6.

Navigate the directory where you unzipped the prerequisite files and select the load_dep.sql file and click Open.

 

7.

Select the HR_ORCL connection in the connection drop list to the right of the SQL Worksheet.

 

8.

The SQL from the script is shown. Click the Run Script icon.

The data was inserted.

 

9.

To view the data, select the DEPENDENTS tab, click the Data tab and Refresh to show all the data.

All the data is displayed

 

10.

You can export the data so it can be used in another tool, for example, Excel. Right-click on one of the values in any column, select Export and then one of the file types, such as csv.

 

11.

Specify the directory and name of the file and click Apply.

 

12.

If you review the DEPENDENTS.CSV file, you should see the following:

 

Back to Topic List

Accessing Data

One way to access DEPENDENTS data is to generate a SELECT statement on the DEPENDENTS table and add a WHERE clause. Perform the following steps:

1.

Select the HR_ORCL Database Connection, right-click and select Open SQL Worksheet.

 

2.

Drag and Drop the DEPENDENTS table from the list of database objects to the SQL statement area.

 

3.

A SELECT statement is shown with all the columns contained in the DEPENDENTS table. Right-click and select Format.

Review the formatted SQL.

 

4.

Select the menu Tools -> Preferences. Select the Database node in the tree and expand SQL Formatter.

 

5.

Select Alignment and Indentation:

  • Uncheck Right-align Master Keywords
  • Uncheck Align on Comma
  • Check Use Tabulator

and click OK.

 

6.

Select the SQL text, right-click and select Format, to reformat the SQL text. Review the changes applied to the formatting.

 

7.

Add the WHERE clause where relative_id > 110 to the end of the SELECT statement BEFORE the ';'.

Click the Execute Statement icon.

The results are shown.

 

Back to Topic List

Creating Reports

As the SQL you just ran in the previous topic needs to be executed frequently, you can create a custom report based on the SQL. In addition, you can run a report of your database data dictionary using bind variables. Perform the following steps:

1.

Select the SQL in the HR_ORCL SQL Worksheet that you executed, right-click and select Copy.

 

2.

Click the Reports tab.

 

3.

Right-click User Defined Reports and select Add Folder.

 

4.

Enter the Folder Name DEPENDENTS Reports. You can add a Description and Tooltip of your choice. Click Apply.

 

5.

Right-click DEPENDENTS folder and select Add Report.

 

6.

Enter a Name for the report and click ctrl+v in the SQL area to paste the SQL you copied from the HR_ORCL SQL Worksheet. Then click Apply.

 

7.

Select the Report you just created.

 

8.

Select HR_ORCL from the drop list and click OK to connect to your database.

The results of your report are shown.

 

9.

You can also run a Data Dictionary report. Expand Data Dictionary Reports > Data Dictionary. Then select Dictionary Views.

 

10.

Enter col for the Value and click Apply.

All the Data Dictionary views that contain 'col' in its name are displayed.

 

Back to Topic List

Creating and Executing PL/SQL

Oracle SQL Developer contains extensive PL/SQL editing capabilities. In this topic, you create a Package Spec and Package Body that adjusts an employee's salary. Perform the following steps:

1.

Select File > Open using the main menu.

 

2.

Browse to the directory where you unzipped the prerequisite files and select createHRpack.sql Click Open.

 

3.

Select the HR_ORCL database connection from the the drop list on the right.

 

4.

Click the Run Script icon.

 

5.

Click the Connections navigator .

 

6.

Expand HR_ORCL > Packages > HR_PACK and select HR_PACK to view the package definition.

 

7.

Select HR_PACK BODY to view the package body definition.

 

8.

To make any changes to the Package Body, you need to access the PL/SQL Editor. Click the Edit icon.

 

9.

Click on any one of the - to collapse the code or press + to expand the code.

 

10.

If your line numbers do not appear, you can right-click in the line number area and click Toggle Line Numbers to turn them on. This is useful for debugging purposes.

 

11.

In the Connections Navigator, select Packages > HR_PACK, right-click and select Run.

 

12.

A parameter window appears. You need to set the input parameters here.

Set the P_ID to 102 and P_INCREMENT to 1.2 . What this means is that the Employee who has the ID 102, their salary is increased by 20%. The current SALARY for EMPLOYEE_ID 102 is 17000. Click OK.

 

13.

The value returned is 20400.

 

14.

To test the Exception Handling, right-click on HR_PACK in the navigator and select Run.

 

15.

This time, change the P_INCREMENT value to 5 and click OK.

 

16.

In this case, an exception was raised with "Invalid increment value" because the P_INCREMENT value was greater than 1.5.

 

Back to Topic List

Summary

In this tutorial, you learned how to:

 Create a database connection
 Add a new table using the Table Dialog Box
 Change a table definition
 Add data to a table
 Access data
 Generate a report
 Create and execute PL/SQL

Back to Topic List

 Move your mouse over this icon to hide all screenshots.

 

Left Curve
Popular Downloads
Right Curve
Untitled Document