How-To Document

How to use the SQL Worksheet in SQL Developer for Basic SQL Syntax

Updated: July 2007 for SQL Developer 1.2

After completing this How-To, you should be able to understand:

  • How to use the SQL Worksheet to for SQL and SQL*Plus commands

Table of Contents

1. Introduction

Oracle SQL Developer provides a SQL Worksheet that you can use to query data, by writing simple or complex SQL statements. In this How-To, we look at the most basic of these, select all the data in a table, and restricting this query by reducing the columns or rows you retrieve.

2. Software Requirements

3. Browse Your Data

3.1. Write a Select Statement

Once you have a database connection, you are ready to browse the schema, query and modify data.

1.

Once you have created a database connection, you need to ensure you have the SQL Worksheet open. If the worksheet is not open, use the context menu to open it.

 

2.

Once connected, you should see the SQL Worksheet Enter SQL Statement window.

 

3.

Now you are ready to start. Query all the data in the DEPARTMENTS table. Enter

Select * from Departments;

Click F9

Notice, the number of rows retrieved is displayed below the results tab.

3.2. Retrieve Columns

Instead of select all the columns from a table, you can itemize them, selecting only the data you require.

1.

Instead of typing in each column name, you can just drag the table name from the Connection Navigator. Expand the Tables node and drag the EMPLOYEE table onto the worksheet.

 

2.

For longer, more complex queries or statements, it's easier to read the SQL if you format it.

Use the context menu and select Format SQL...

 

3.

Now delete a selection of columns from the statement. An example is show below.

Click F9 to retrieve the records.

3.3. Retrieve Rows

Often you want to restrict the number of records returned. You add a Where Clause to do this. These can be complex and involved. We will start with the most basic.

1.

Using the same Select statement you have above, remove the ' ; ' and add

where department_id = 100;

The results tab shows fewer records returned.

4. Use SQL*Plus commands

The SQL Worksheet allows you to use a selection of SQL*Plus commands. SQL*Plus commands have to be interpreted by the SQL Worksheet before being passed to the database. Some commands are not supported and are hence ignored and are not sent to the Oracle database. For a list of unsupported SQL*Plus commands, see the help or SQL Developer on OTN.

1.

To use the Describe command to describe a schema object, type:

DESCRIBE EMPLOYEES

and click F9.

 

2.

Let's put this to some use. In order to determine what objects this schema owns and what they are, you can interrogate the user_objects dictionary table.

Instead of using 'SELECT * from USER_OBJECTS' you need to find more specific detail, enter:

DESCRIBE USER_OBJECTS

Click F5.

3.

Now that you have seen the columns that define the table, you can write your select statement. Enter:

select object_name, object_type
from user_objects;

Click F9.

The results displayed are the objects your HR schema owns.

 

5. Additional Resources

E-mail this page
Printer View Printer View
Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy