You use Designer, one of the DataStage clients, for ETL jobs development. When you start Designer, in addition to entering your host system and credential, you must also specify the project you’d like to work on.
A DataStage project stores jobs and define their environment, such as their security and execution resources. Your project, as well as your user account, is typically created by your DataStage administrator.
To develop a new job, on the icon toolbar, click the drop-down arrow to the right of the New icon (I circle in red).
We’ll develop a parallel job, so click the Parallel Job from the drop-down list.
In DataStage, a parallel job can execute in parallel mode (in simple terms, this means the job does not process its data records sequentially, one record after another).
We can now start to design our job in the job canvas. For now, our parallel job name is Untitled 1, as shown on the canvas title.
Our job extracts its input data from a customer sequential file, transforms the data, and then loads it into an Oracle table. The customer file contains new customers and name changes of the existing customers. The customer file has more data (more columns) than we need; we’ll extract only those we need.
In DataStage, you build a job by selecting and linking stages on the job canvas. So, on the Palette, click File, look for Sequential File stage by clicking the up or down arrow.
Drag and drop our first stage, the Sequential File stage, from the Palette to the left side of the canvas.
We’d like to layout our stages left to right to visualize them processing data in that direction, so we start placing the input stage on the left of the canvas (we can move stages around the canvas, though, by dragging them).
Rename the Sequential File stage to Customer by selecting (clicking) and clicking it again, and typing over the default name (Sequential_File_1).
Next, add Transformer stage (under Processing palette) and Oracle Enterprise stage (under Database palette) that we need for our job. Rename them as shown.
We use the Transformer stage to change (transform) customer names to uppercase.
Now that we have the stages we need for our job, we’ll link them together. Right click the Customer stage, hold and drag & drop on the Uppercase stage, and then, from Uppercase stage to the Customer_Dim stage.
You can rename the links just like the way you rename stages.
Just in case something happens to our system, we’d like to save our works so far.
Name the job Load_Customer_Dim and you can choose the folder (called Category in DataStage) of your choice where you want to put the job.
Notice the canvas title now reflects the name of our parallel job (changes from its default name given when we’re creating it).
The Customer stage has a warning sign (the yellow! sign), which indicates that it has an error. This is because we haven’t specified its parameters. For example, the file it refers to. So, let’s fix it.
Double-click the Customer stage. On the Properties tab select the File property, and type in the file name including its full path. The sequential file must be accessible by the DataStage server.
Next, we need to specify the format of our file. For example, set the Record level’s Final delimiter and Field default’s Delimiter as shown.
We must also specify the record layout, i.e. its fields (columns).
To test that the stage will be able to read the data as specified, click the View Data button (upper right hand corner).
You can specify the number of rows (records) you’d like to view.
When you click OK and you have set the correct specification for the file, you’d see the data.
When you finish viewing the data, close the view window as well as the property window. We’re done with the Customer stage.
We’ll now fix the specification of the Customer_Dim stage. What we want here is to insert a new customer and apply the customer name changes to the existing customer record on the CUSTOMER_DIM table. So, put down the specification in the sequence of the screenshots shown.
Note that we use Oracle’s sequence to generate the CUSTOMER_ID; the value of this column doesn’t come from the input.
When you close the property window, back to the main Designer’s window all warnings on the stages should have disappeared.
Though the Uppercase stage doesn’t have any warning sign, we haven’t actually specified what transformation we’d like this stage to do. We need the first two columns only. So, on the mapping window select the two columns on the input link, then drag and drop onto the load link.
We’d like to just pass the CUSTOMER_NO data, but we’d like to convert (transform) CUSTOMER_NAME data into uppercase. So, double-click the input.CUSTOMER_NAME on the Derivation section of the load link. Erase the content of the derivation editor (input.CUSTOMER_NAME), and then click the ... button (ellipsis).
Expand String and select UpCase.
Click the ellipsis button again, and then select Input Column.
Select CUSTOMER_NAME and then click on the white space outside of the editor.
Close the window by clicking OK.
Let’s now compile the job by clicking the compile button (I circle in red).
Confirm to save the job when prompted.
When the compilation status confirms your job doesn’t have any error, you job is ready to run. Close the compilation status window; and let’s test this job.
Note that you must already have the Customer sequential file with some data in it, as well the Customer_Dim table in its Oracle database—DataStage doesn’t (can’t) create it.
Click the run button (red-circled) to run the job.
Click Run on the Job Run Options window.
You can monitor the job execution right on the canvas (the flow of data, how many records have been processed). When the job is completed successfully you’ll see the green links with two numbers: one number shows the number of records processed (flowed) in the link (e.g. input: 5), the other the processing speed (5 rows/sec).
When you check the Oracle table, you should have the four customer records in the table with the CUSTOMER_ID populated with the Oracle sequence values, and that the customer names are all in uppercase.
In this article I showed you how easy it is using a GUI client we built an ETL job with the IBM WebSphere DataStage. DataStage has a lot of other functions and features, such as the availability of built-in stages (we used only three stages in this article; we can also build our own custom stage), other GUI clients (such as that for debugging, job flow development.