tCreateTable Standard properties - 7.3

Database utility

Version
7.3
Language
English (United States)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
Data Governance > Third-party systems > Database components > Database utility components
Data Quality and Preparation > Third-party systems > Database components > Database utility components
Design and Development > Third-party systems > Database components > Database utility components

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

The Standard tCreateTable component belongs to the Databases family.

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

Basic settings

Database Type

Select the type of the database. The connection properties may differ slightly according to the database type selected.

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.

Use an existing connection

Select this check box and in the Component List drop-down list, select the desired 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.

JDBC Provider

Select the provider of the JDBC driver to be used, either Microsoft (the default, recommended) or Open source JTDS.

When Microsoft is selected, you need to download the Microsoft JDBC Driver for SQL Server on Microsoft Download Center, unpack the downloaded zip file, choose a jar in the unzipped folder based on your JRE version, rename the jar to mssql-jdbc.jar and install it manually. For more information about choosing the jar, see the System Requirements information on Microsoft Download Center.

When using this component with Datasource in Talend Runtime, you need to use the Open source JTDS driver.

This option is available when MSSQLServer is selected from the Database Type drop-down list.

Note: This option defaults to Microsoft only if you have installed the R2020-06 Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

DB Version

Select the version of the database.

Host

The IP address or hostname of the database.

Port

The listening port number of the database.

Database name

The name of the database.

Schema

The name of the database schema.

This property is available for DB2, Exasol, Greenplum, Informix, MS SQL Server, Oracle, PostgresPlus, Postgresql, Redshift, Sybase, and Vertica database types.

Access File

The path to the Access database file.

Firebird File

The path to the Firebird database file.

Interbase File

The path to the Interbase database file.

SQLite File

The path to the SQLite database file.

Running Mode

Select the Server Mode that corresponds to your database setup.

This property is available only for the HSQLDb database type.

Use TLS/SSL Sockets

Select this check box to enable the security mode if required.

This property is available only for the HSQLDb database type.

DB Alias

The name of the database.

This property is available only for the HSQLDb database type.

Framework Type

Select the framework type for your database.

This property is available only for the JavaDb database type.

DB Root Path

Browse to your database root.

This property is available only for the JavaDb database type.

ODBC Name

The name of the ODBC database.

Connection Type

Select the Oracle database connection type.

  • Oracle SID: select this connection type to uniquely identify a particular database on a system.

  • Oracle Service: select this connection type to use the TNS alias that you give when you connect to the remote database.

  • Oracle OCI: select this connection type to use Oracle Call Interface with a set of C-language software APIs that provide an interface to the Oracle database.

  • Oracle Custom: select this connection type to access a clustered database.

  • WALLET: select this connection type to store credentials in an Oracle wallet.

Account

In the Account field, enter, in double quotation marks, the account name that has been assigned to you by Snowflake.

This property is available only for the Snowflake database type.

Username and Password

The database 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.

Role

Enter, in double quotation marks, the default access control role to use to initiate the Snowflake session.

This role must already exist and has been granted to the user ID you are using to connect to Snowflake. If this field is left empty, the PUBLIC role is automatically granted. For information about Snowflake access control model, see Understanding the Access Control Model.

This property is available only for the Snowflake database type.

Table name

The name of the table to be created.

Table Action

Select the action to be carried out on the table.

  • Create table: the specified table doesn't exist and gets created.

  • Create table if not exists: the specified table is created if it does not exist.

  • Drop table if exits and create: the table is removed if it already exists and gets created again.

Temporary Table Select this check box to create a temporary table during an operation, which is automatically dropped at the end of the operation. Since temporary tables exist in a special schema, you cannot specify a schema name when creating a temporary table, and the name of the temporary table must be distinct from the name of any other table, sequence, index, and view in the same schema.

Note that once you select to create a temporary table, you should empty the values when you edit schema.

This field is available only when Postgresql is selected from the Database Type drop-down list.

Unlogged Table Select this check box to create an unlogged table during an operation. This way, data is loaded considerably faster than an ordinary table where the data is logged and then written. However, the data in an unlogged table is not crash-safe.

This field is available only when Postgresql is selected from the Database Type drop-down list and Temporary Table is not selected.

Case Sensitive

Select this check box to make the table/column name case sensitive.

This property is available only for the HSQLDb database type.

Temporary Table

Select this check box if you want to save the created table temporarily.

This property is available only for the MySQL database type.

Create

Select the type of the table to be created.

  • SET TABLE: the table that does not allow duplicate rows.

  • MULTISET TABLE: the table that allows duplicate rows.

This property is available only for the Teradata database type.

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.

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

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

When the schema to be reused has default values that are integers or functions, ensure that these default values are not enclosed within quotation marks. If they are, you must remove the quotation marks manually.

For more information, see the related description of retrieving table schemas in 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.

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.

This property is available for the AS/400 and MSSQL Server database types.

Authenticate using Azure Active Directory

Select this option to use Azure Active Directory authentication when establishing the connection. See Azure AD Authentication for related information.

This option is available when MSSQLServer is selected from the Database Type drop-down list and Microsoft is selected from the JDBC Provider drop-down list in the Basic settings view.

Note: This option is available only if you have installed the R2020-05 Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

Create projection

Select this check box to create a projection.

This property is available only for the Vertica database type.

Enforce database delimited identifiers

Select this check box to enable delimited identifiers.

This property is available only for the Snowflake database type.

For more information on delimited identifiers, see https://docs.intersystems.com/latest/csp/docbook/DocBook.UI.Page.cls?KEY=GSQL_identifiers.

Note: If you use special characters in your column names, select this checkbox to avoid possible errors or Job execution failure.

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

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.

Usage

Usage rule

This component can be used as a standalone component of a Job or subJob.