> #### How to create a SQL query to retrieve data from a JDBC data source

> This procedure assumes you have already created the JDBC data source that this data set uses.

> 1 | In Data Explorer, right-click Data Sets, then choose New Data Set.

> 2 | On New Data Set, specify the following information:

> 1 | In Data Source Selection, under JDBC Data Source, select the data source to use.

> 2 | In Data Set Type, select SQL Select Query.

> 3 | In Data Set Name, type a name for the data set.

> 4 | Choose Next.

> Query displays the information to help you create a SQL query. Available Items lists the items in the data source.

> 3 | To see the tables in a database, expand the database, as shown in Figure 3‑1.

> Figure 3‑1 | Viewing a schema

> You can use the filter options to specify specific schemas or objects to display.

> n | If you want to see only views in the JDBC data source, in Type, select View, and choose Apply Filter. If you want to see all tables, views, and stored procedures, select All, and choose Apply Filter.

> n | If the data source has a large number of objects, you can limit the number of object names that are retrieved by typing one or more letters in the Filter field and choosing Apply Filter. Available Items displays the objects that have names that begin with the same letter or letters that you typed. You also can use SQL filter characters for the database that you are using. For example, on some databases, an underscore (_) matches any single character, and the percent sign (%) matches any sequence of characters.

> n | If the database supports schemas, a Schema drop-down list is available. Select a schema to display only objects from that schema.

> 4 | To display the columns in a table or view, click the plus sign (+) beside a table or view name.

> 5 | In the text area, type a SQL statement that indicates what data to retrieve from the JDBC data source. You can also drag tables, views, and columns from Available Items to the text area to insert their names in the SQL statement at the insertion point, as shown in Figure 3‑2.

> For some databases, if a table or column name contains spaces or SQL reserved words, you must enclose the name in quotation marks (" "). If you drag and drop tables and columns, and those items need to be enclosed in double quotation marks, select the Use identifier quoting option. When this option is selected, the data set editor inserts the quotation marks around a table or column name when you drop it in the text area.

> Figure 3‑2 | Adding a table to a SQL query

> 6 | Choose Finish. Edit Data Set displays the columns specified in the query, and provides options for editing the data set.

(c) Copyright Actuate Corporation 2009