Have access to an Oracle Database 10g instance or perform the Installing Oracle Database 10g on Windows tutorial. Note: you can also perform this tutorial connecting to a non-windows database.

Download Oracle SQL Developer from OTN and unzip it into any directory on your Windows machine.

Make sure the DEPENDENTS table doesn't exist. Open SQL*Plus and execute the following commands:

connect hr/hr
drop table dependents;

Open Windows Explorer and double-click <your_path>\sqldeveloper\sqldeveloper.exe.

Note: you can also execute sqldeveloper in a non-windows environment.

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

Enter <your_schema_db_sid_name> for the Connection Name (or any other name that identifies your connection), hr for the Username and Password, specify your <hostname> for the Hostname and enter <your_db_sid> for the SID. Then click Test.

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

Expand Tables.

Select the Table EMPLOYEES to view the table definition.

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.

Right-click Tables and select New TABLE...

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

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.

Enter FIRST_NAME for the Name, and enter 20 for the Size. Then click the Add Column icon.

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

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

Enter RELATION for the Name, and enter 25 for the Size. Then click the Add Column icon.

Enter GENDER for the Name, and enter 1 for the Size. Then click the Add Column icon.

Enter RELATIVE_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 OK to create the table.

Your new table appears in the list of tables. Select DEPENDENTS from the list.

Click the Actions... button.

Select Column then Drop.

Select the Column Name GENDER and click Apply.

The column has been dropped. Click OK.

Right-click the tables node for the HR_ORCL Database Connection and click Refresh to refresh the Database Connection.

Expand HR_ORCL > Tables, and select the DEPENDENTS table.

Right-click DEPENDENTS table and select Edit...

Click the Primary Key node in the tree.

Select the ID column and click > to shuttle the value to the Selected Columns window. Then click the Foreign Key node in the tree.

Click Add.

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

Click the Data tab.

Then click the Insert Row icon.

Enter the following data and click the Commit Changes icon.

The row you just added was committed to the database.

You can also load multiple rows at one time using a script. Click the SQL Worksheet HR_ORCL tab.

Right-click in the SQL Statement area and select Open File.

Navigate to your working directory (e.g. c:\wkdir) and select the load_dep.sql file and click Open.

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

The data was inserted. To view the data, click the DEPENDENTS tab.

Click Refresh to show all the data.

All the data is displayed

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.

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

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

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

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

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

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

Then click the Execute Statement icon.

The results are shown.

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

Click the Reports tab.

Right-click User Defined Reports and select Add Folder.

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

Right-click DEPENDENT Reports and select Add Report.

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.

Select the Report you just created.

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

The results of your report are shown.

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

Enter col for the Value and click Apply.

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

Select File > Open using the main menu.

From your working directory (c.\wkdir) select createHRpack.sql and click Open.

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

Click the Run Script icon.

The script ran successfully and the package and package body were created. Right-click the Packages node and select Refresh.

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

Select HR_PACK BODY to view the package body definition.

To make any changes to the Package Body, click the Edit icon.

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

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.

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

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.

The value returned is 20400.

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

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

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