July 30, 2023

tBigQueryBulkExec Standard properties – Docs for ESB 7.x

tBigQueryBulkExec Standard properties

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

The Standard
tBigQueryBulkExec component belongs to the Big Data family.

The component in this framework is available in all Talend

Basic 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

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,
Talend Studio

User Guide.

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.

  • The Record type of BigQuery is not supported.
  • The columns for table metadata such as the Description column or the Mode column cannot be retrieved.
  • The Timestamp data from your BigQuery system is formated to be
    String data.
  • The numeric data of BigQuery is converted to BigDecimal.
Authentication mode Select the mode to be used to authenticate to your project.

  • OAuth 2.0: authenticate the access using
    OAuth credentials. When selecting this mode, the parameters to be
    defined in the Basic settings view are
    Client ID, Client
    and Authorization
  • Service account: authenticate using a Google
    account that is associated with your Google Cloud Platform project.
    When selecting this mode, the parameter to be defined in the
    Basic settings view is Service
    account credentials file
Service account credentials file Enter the path to the credentials file created for the service account
to be used. This file must be stored in the machine in which your Talend Job is actually launched and

For further information about how to create a Google service
account and obtain the credentials file, see Getting Started with
from the Google documentation.

Client ID and Client

Paste the client ID and the client secret, both created and viewable on the
API Access tab view of the project hosting the Google BigQuery service and the Cloud
Storage service you need to use.

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

Project ID

Paste the ID of the project hosting the Google BigQuery service you
need to use.

The ID of your project can be found in the URL of the Google
API Console, or by hovering your mouse pointer over the name of the
project in the BigQuery Browser Tool.

Authorization code

Paste the authorization code provided by Google for the access you are

To obtain the authorization code, you need to execute the Job using this
component and when this Job pauses execution to print out an URL address, you
navigate to this address to copy the authorization code displayed.


Enter the name of the dataset you need to transfer data to.


Enter the name of the table you need to transfer data to.

If this table does not exist, select the Create the table if it doesn’t exist check box.

Action on data

Select the action to be performed from the drop-down list when
transferring data to the target table. The action may be:

  • Truncate: it empties the contents of
    the table and repopulates it with the transferred data.

  • Append: it adds rows to the existing
    data in the table.

  • Empty: it populates the empty

Bulk file already exists in Google storage

Select this check box to reuse the authentication information for Google
Cloud Storage connection, then, complete the File and the Header fields.

Access key and Secret

Paste the authentication information obtained from Google for making
requests to Google Cloud Storage.

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

These keys can be consulted on the Interoperable Access tab view under the
Google Cloud Storage tab of the project.

File to upload

When the data to be transferred to Google BigQuery is not stored on Google Cloud
Storage, browse to, or enter the path to it.


Enter the name of the bucket, the Google Cloud Storage
container, which holds the data to be transferred to Google


Enter the directory of the data stored on Google Cloud Storage
and to be transferred to Google BigQuery. This data must be stored directly
under the bucket root. For example, enter

If the data is not on Google Cloud Storage, this directory is
used as the intermediate destination before the data is transferred to Google


Set values to ignore the header of the transferred data. For
example, enter 0 to ignore no rows for the data without

Die on error

This check box is cleared by default, meaning to skip the row on
error and to complete the process for error-free rows.

Advanced settings

token properties File Name

Enter the path to, or browse to the refresh token file you need to use.

At the first Job execution using the Authorization
you have obtained from Google BigQuery, the value in this field
is the directory and the name of that refresh token file to be created and used; if
that token file has been created and you need to reuse it, you have to specify its
directory and file name in this field.

With only the token file name entered,
Talend Studio
considers the directory of that token file to be the root of the Studio

For further information about the refresh token, see the manual of Google

Set the field delimiter

Enter character, string or regular expression to separate fields for the transferred

Drop table if exists

Select the Drop table if exists check box to remove the table specified in the Table field, if this table already exists.


Select the encoding from the list or select Custom
and define it manually. This field is compulsory for database data handling. The
supported encodings depend on the JVM that you are using. For more information, see

tStatCatcher Statistics

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

Global Variables

Global Variables

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 +
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.


Usage rule

This is a standalone component.

This component automatically detects and
supports both multi-regional locations and regional locations. When using the
regional locations, the buckets and the datasets to be used must be in the same

Parent topic: tBigQueryBulkExec

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