Authorities
and privilegesUse the SQL Step notebook to define a step that passes an SQL statement. From this notebook, you can create, generate, or edit SQL statements.
You cannot change the step in Production mode.
To define a step:
Specify information for your step:
In the Name field, you can type a new name for the step. Otherwise, you can keep the name that the Data Warehouse Center automatically supplied for the step. This field is required.
In the Administrator field, type the name of the person who is responsible for the maintenance of this step. This field is optional.
In the Description field, type a business description for your step. This description can be a maximum of 255 characters. This field is optional.
In the Notes field, type detailed information that might be helpful to users who can access this step. This field is optional.
On the SQL Statement page, create an SQL statement:
If you want to use SQL Assist to generate SQL, click Build SQL. SQL Assist is launched. After you finish using SQL Assist, the newly generated SQL is displayed in the SQL statement field.
If you want to create SQL manually, or you want to edit SQL that is generated by SQL Assist, click Edit. The SQL Statement field is available. SQL Assist is no longer available.
Optional: If you want to erase the text in the SQL statement field, click Clear. If you want to create new SQL, you must click Edit again.
Optional: When you finish generating or editing your SQL, click Test to test the SQL query. The Data Warehouse Center returns sample results of your query.
On the Column Mapping page, map the output columns that result from the SQL statement that you defined on the Parameters page to columns on your target table. On this page, output columns from the Parameters page are referred to as source columns. Source columns are listed on the left side of the page. Target columns from the output table linked to the step are listed on the right side of the page. Use the Column Mapping page to perform the following tasks:
To create a mapping, click a source column and drag it to a target column. An arrow is drawn between the source column and the target column.
To delete a mapping, right-click an arrow and select Delete.
If the output table is not used by any steps that are in Test or Production, you can change the attributes of the target column. To rename a target column, double-click the column name and type the new name. You can also modify any other attributes of the target column by double-clicking the attribute.
To move a target column up or down the list, select the column. Then, click the Up arrow or Down arrow buttons. If the target column is mapped to a source column, the mapping remains intact.
If the Parameters page produces no output columns, or if this step is not linked to a target table and you have not specified automatic generation of a default table in the Parameters page, you will not be able to use this page to map your columns. Some steps will not allow you to change the column mapping.
On the Processing Options page, in the Population type list, select whether the step appends or replaces data in the target.
In the Agent Site list, select an agent site where you want your step to run. The selections in this list are agent sites that are common to the source tables and the target table.
If you want to have the option to to run your step at any time, select the Run on demand checkbox. Your step must be in test or production mode before you can run it.
Optional: Select the Populate externally check box if the step is populated externally, meaning that it is invoked in some way other than by the Data Warehouse Center. The step does not have to have any other means of running in the Data Warehouse Center in order to change the mode to production.
If Populate externally is not selected, then the step must either have a schedule, be linked to a transient table that is input to another step, or be started by another program in order to change the mode to production.
In the Retry area, specify how many times you want the step to run again if it needs to be retried and the amount of time that you want to pass before the next run of the step.
In the Return Codes area, select the return code level that you would like to receive if no rows are returned or an SQL warning occurs when your step is run.
In the Incremental commit checkbox and the Every x rows field, specify whether you want the step to perform an incremental commit and, if so, how often you want the commit to occur.
Click OK to save your changes and close the step notebook.
Related information