July 30, 2023

tSQLDWHInput – Docs for ESB 7.x


Reads data and extracts fields based on a query from an Azure SQL Data Warehouse

tSQLDWHInput Standard properties

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

The Standard
tSQLDWHInput component belongs to two families: Cloud and Databases.

The component in this framework is available in all Talend

Basic settings

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.

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

Select the way the connection details
will be set.

  • Built-In: The connection details will be set
    locally for this component. You need to specify the values for all
    related connection properties manually.

  • Repository: The connection details stored
    centrally in Repository > Metadata will be reused by this component. You need to click
    the […] button next to it and in the pop-up
    Repository Content dialog box, select the
    connection details to be reused, and all related connection
    properties will be automatically filled in.

JDBC Provider

Select the provider of the JDBC driver to be used.


Specify the IP address or hostname of the Azure SQL Data Warehouse to be used.


Specify the listening port number of the Azure SQL Data Warehouse to be used.


Enter the name of the Azure SQL Data Warehouse schema.


Specify the name of the Azure SQL Data Warehouse to be used.

Username and Password

Enter the user authentication data to access the Azure SQL Data Warehouse.

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

  • Built-In: You create and store the schema locally for this component

  • Repository: You have already created the schema and stored it in the
    Repository. You can reuse it in various projects and Job designs.

Click Edit
to make changes to the schema.

Note: If you
make changes, the schema automatically becomes built-in.
  • 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

Table name

Specify the name of the table to be used.

Query Type

Select the way the query will be set.

  • Built-in: Fill in manually the query statement or build it
    graphically using SQLBuilder.

  • Repository: Select the relevant query stored in the
    Repository. The Query field gets accordingly filled in.

Guess Query

Click this button to generate the query which corresponds to your table schema in the
Query field.

Guess schema

Click this button to generate the schema columns based on the query specified in the
Query field.


Specify the query paying particularly attention to properly sequence the fields in
order to match the schema definition.

Specify a data source alias

Select this check box and in the
Data source alias field displayed, specify the alias of
a data source created on Talend Runtime side to use
the shared connection pool defined in the data source configuration. This option
works only when you deploy and run your Job in Talend Runtime.

This check box is not available when the Use an existing
check box is selected.

Advanced settings

Additional JDBC Parameters

Specify additional connection properties for the database
connection you are creating. The properties are separated by semicolon and
each property is a key-value pair. For example, encrypt=true;trustServerCertificate=false;
hostNameInCertificate=*.database.windows.net;loginTimeout=30; for
Azure SQL database connection.

Trim all the String/Char columns

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

Trim column

Select the check box(es) in the Trim column to remove leading
and trailing whitespace from the corresponding column(s).

This property is not available if the Trim all the String/Char
check box is selected.

tStatCatcher Statistics

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

Global Variables


The error message generated by the component when an error occurs. This is an After
variable and it returns a string.


The number of rows processed. This is an After variable and it returns an integer.


The query statement being processed. This is a Flow variable and it returns a


Usage rule

This component is usually used as a start component of a Job or
subJob and it always needs an output link.

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
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
and context variables, see Talend Studio
User Guide.


Note that some features that are supported by
other databases are not supported by Azure SQL Data Warehouse. For more information,
see Unsupported table features.

Related scenario

No scenario is available for this component yet.

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