July 30, 2023

tAS400Input – Docs for ESB 7.x

tAS400Input

Reads a database and extracts fields based on a query.

tAS400Input executes a DB query with a strictly defined order which
must correspond to the schema definition. Then it passes on the field list to the next
component via a Row > Main link.

tAS400Input Standard properties

These properties are used to configure tAS400Input running in the Standard Job framework.

The Standard
tAS400Input component belongs to the Databases family.

The component in this framework is available in all Talend
products
.

Note: This component is a specific version of a dynamic database
connector. The properties related to database settings vary depending on your database
type selection. For more information about dynamic database connectors, see Dynamic database components.

Basic settings

Database

Select a type of database from the list and click
Apply.

Use an existing connection

Select this check box and in the Component List click the relevant connection component to
reuse the connection details you already defined.

Note: When a Job contains the parent Job and the child Job, if you
need to share an existing connection between the two levels, for example, to share the
connection created by the parent Job with the child Job, you have to:

  1. In the parent level, register the database connection
    to be shared in the Basic
    settings
    view of the connection component which creates that very database
    connection.

  2. In the child level, use a dedicated connection
    component to read that registered database connection.

For an example about how to share a database connection
across Job levels, see

Talend Studio
User Guide
.

Property type

Either Built-in or Repository
.

 

Built-in: No property data stored
centrally.

 

Repository: Select the repository
file in which the properties are stored. The fields that follow are
completed automatically using the data retrieved.

tAS400Input_1.png

Click this icon to open a database connection wizard and store the
database connection parameters you set in the component Basic settings view.

For more information about setting up and storing database connection
parameters, see
Talend Studio User
Guide
.

DB Version

Select the AS 400 version in use

Host

Database server IP address

Port

Listening port number of DB server.

Database

Name of the database

Username and Password

DB user authentication data.

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Schema and Edit
Schema

A schema is a row description. It defines the number of fields
(columns) to be processed and passed on to the next component. When you create a Spark
Job, avoid the reserved word line when naming the
fields.

This
component offers the advantage of the dynamic schema feature. This allows you to
retrieve unknown columns from source files or to copy batches of columns from a source
without mapping each column individually. For further information about dynamic schemas,
see
Talend Studio

User Guide.

This
dynamic schema feature is designed for the purpose of retrieving unknown columns of a
table and is recommended to be used for this purpose only; it is not recommended for the
use of creating tables.

 

Built-in: The schema is created and
stored locally for this component only. Related topic: see
Talend Studio User Guide
.

 

Repository: The schema already exists
and is stored in the Repository, hence can be reused. Related topic: see

Talend Studio User
Guide
.

 

Click Edit
schema
to make changes to the schema. If the current schema is of the Repository type, three options are available:

  • View schema: choose this
    option to view the schema only.

  • Change to built-in property:
    choose this option to change the schema to Built-in for local changes.

  • Update repository connection:
    choose this option to change the schema stored in the repository and decide whether
    to propagate the changes to all the Jobs upon completion. If you just want to
    propagate the changes to the current Job, you can select No upon completion and choose this schema metadata
    again in the Repository Content
    window.

Query type and Query

Enter your DB query paying particularly attention to properly
sequence the fields in order to match the schema definition.

If using the dynamic schema
feature, the SELECT query must include the * wildcard, to retrieve all of the columns from the table
selected.

Advanced settings

Additional JDBC parameters

Specify additional connection properties for the DB connection you are
creating. This option is not available if you have selected the
Use an existing connection check
box in the Basic settings.

Trim all the String/Char columns

Select this check box to remove leading and trailing whitespace from
all the String/Char columns.

Trim column

Remove leading and trailing whitespace from defined columns.

tStat
Catcher Statistics

Select this check box to collect log data at the component
level.

Usage

Usage rule

This component offers the flexibility of the DB query and covers all
possible SQL queries.

Dynamic settings

Click the [+] button to add a row in the table
and fill the Code field with a context
variable to choose your database connection dynamically from multiple
connections planned in your Job. This feature is useful when you need to
access database tables having the same data structure but in different
databases, especially when you are working in an environment where you
cannot change your Job settings, for example, when your Job has to be
deployed and executed independent of Talend Studio.

The Dynamic settings table is
available only when the Use an existing
connection
check box is selected in the Basic settings view. Once a dynamic parameter is
defined, the Component List box in the
Basic settings view becomes unusable.

For examples on using dynamic parameters, see Reading data from databases through context-based dynamic connections and Reading data from different MySQL databases using dynamically loaded connection parameters. For more information on Dynamic
settings
and context variables, see Talend Studio
User Guide.

Handling data with AS/400

This scenario describes a Job that writes the user information into AS/400, and then reads
the information in AS/400 and displays it on the console.

tAS400Input_2.png

Adding and linking the components

  1. Create a new Job and add a tFixedFlowInput component, a
    tAS400Output component, a tAS400Input component, and a tLogRow component by typing their names in the design workspace
    or dropping them from the Palette.
  2. Connect tFixedFlowInput to tAS400Output using a Row >
    Main connection.
  3. Do the same to connect tAS400Input to tLogRow.
  4. Connect tFixedFlowInput to tAS400Input using a Trigger
    > OnSubjobOk connection.

Configuring the components

Writing the data into AS/400

  1. Double-click tFixedFlowInput to open its
    Basic settings view.

    tAS400Input_3.png

  2. Click the […] button next to Edit
    schema
    and in the Schema
    dialog box define the schema by adding three columns: id of Integer type, and name
    and city of String type.

    tAS400Input_4.png

    Click OK to close the Schema dialog box and accept the propagation prompted by the
    pop-up dialog box.
  3. In the Mode area, select Use Inline Content (delimited file) and enter the
    following user information in the Content
    field.

  4. Double-click tAS400Output to open its Basic settings view.

    tAS400Input_5.png

  5. In the Host, Database, Username and
    Password fields, enter the information
    required for the connection to AS/400.
  6. In the Table field, specify the table into which you want
    to write the data. In this example, it is doct1018.
  7. Select Drop table if exists and create from
    the Action on table drop-down list, and select
    Insert from the Action on data drop-down list.

Retrieving the data from AS/400

  1. Double-click tAS400Input to open its Basic settings view.

    tAS400Input_6.png

  2. In the Host, Database, Username and
    Password fields, enter the information
    required for the connection to AS/400.
  3. Click the […] button next to Edit
    schema
    and in the Schema
    dialog box define the schema by adding three columns: id of Integer type, and name
    and city of String type. The data structure
    is same as the structure you have defined for tFixedFlowInput.
  4. In the Table Name field, enter or browse to the table
    into which you write the data. In this example, it is doct1018.
  5. In the Query field, enter the SQL query sentence to be
    used to retrieve the user data from AS/400. In this example, it is SELECT * FROM doct1018.
  6. Double-click tLogRow to open its Basic settings view.

    tAS400Input_7.png

  7. In the Mode area, select Table (print values in cells of a table) for better
    readability of the result.

Saving and executing the Job

  1. Press Ctrl + S to save the Job.
  2. Press F6 or click Run on the Run tab to run the
    Job.

    tAS400Input_8.png

    As shown above, the user information is written into AS/400, and then the data is
    retrieved from AS/400 and displayed on the console.

Related scenarios


Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x