August 16, 2023

tSasInput – Docs for ESB 6.x

tSasInput

Executes a DB query with a strictly defined statement which must correspond to the
schema definition.

Warning:

Before being able to benefit from all functional
objectives of the SAS components, make sure to install the following three modules:
sas.core.jar, sas.intrnet.javatools.jar and sas.svc.connection.jar in the path lib >
java in your
Talend Studio
directory. You can later verify, if needed whether the modules
are successfully installed through the Modules view of the Studio.

tSasInput reads a database and
extracts fields based on a query. Then it passes on the field list to the component that
follows via a Row > Main connection.

tSasInput Standard properties

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

The Standard
tSasInput component belongs to the Databases family.

The component in this framework is generally available.

Basic settings

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.

Save_Icon.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
.

Host name

SAS server IP address.

Port

Listening port number of server.

Librefs

Enter the directory name that holds the table to read followed by
its access path. For example:

“TpSas ‘C:/SAS/TpSas'”

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. The schema is either Built-In or stored remotely in the Repository.

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.

Table Name

Enter the name of the table to read preceded by the directory name
that holds it. For example:

"TpSas.Customers"
.

Query type

The query can be Built-in
for a particular job, or for commonly used query, it can be
stored in the Repository to
ease the query reuse
.

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

Query

If your query is not stored in the Repository,
type in your DB query paying particularly attention to
properly sequence the fields in order to match the schema
definition.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the job processing metadata at a
Job level as well as at each component level.

Global Variables

Global Variables

NB_LINE: the number of rows processed. This is an After
variable and it returns an integer.

QUERY: the query statement being processed. This is a Flow
variable and it returns a string.

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.

Usage

Usage rule

This component covers all possible SQL queries for databases using
SAS connections.

Limitation

Due to license incompatibility, one or more JARs required to use this component are not
provided. You can install the missing JARs for this particular component by clicking the
Install button on the Component tab view. You can also find out and add all missing JARs easily on the
Modules tab in the
Integration
perspective of your
studio. You can find more details about how to install external modules in Talend Help Center (https://help.talend.com).


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