tGSPut Standard properties - Cloud

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

The Standard tGSPut component belongs to the Big Data and the Cloud families.

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

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.
Credential type	Select the mode to be used to authenticate to your project. 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 is Service account key. Application Default Credentials: authenticate using the Application Default Credentials. When selecting this mode, no additional parameters need to be defined as credentials are automatically found based on the application environment. OAuth Access Token: authenticate using an OAuth access token. When selecting this mode, the parameter to be defined is OAuth Access Token. To know more about the Google Cloud authentication process, read the Google Cloud documentation.
Service account key	Click the [...] button next to the service account key field to browse for the JSON file that contains your service account key. This property is only available when you authenticate using Service account.
OAuth Access Token	Enter an access token. The lifetime of the token is one hour. The component does not perform the token refresh operation but will fetch the new access token to operate beyond the one-hour limit. This property is only available when you authenticate using OAuth Access Token.
Bucket name	Type in the name of the bucket into which you want to upload files.
Project ID	When the credential type is set to OAuth Access Token, specify the project ID into which you want to upload files.
Local directory or file	Type in the full path of or browse to the local file or directory where the files to be uploaded are located. If you select the Use files list check box, you can only specify a directory in this field. If you unselect the Use files list check box, you can specify a file or directory in this field.
Google Storage directory	Type in the Google Storage directory to which you want to upload files.
Use files list	Select this check box and complete the Files table with the files to be uploaded. Filemask: enter the pattern used to match the file or files you want to upload. If you enter part of a file name, you can use the "" character to replace any number of characters in the file name. For example, sales_.csv would look for both sales_112023.csv and sales_122023.csv New name: enter a new name for the file to be uploaded.
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

Use a custom endpoint	Select this check box to use a private endpoint rather than the default one. When selected, enter the URL in the Google Storage Private API URL property, by respecting the following format: `"https://storage.goggleapis.com"`. For more information, see Access Google APIs through endpoints from Google documentation. This property is only available when you authenticate using Service account.
Part size(Mb)	Specify the part size (in MB) when uploading an object in parts. The property work as follows: If the value is 0, the object is uploaded without being divided into parts. If the value is bigger than 0, the object that is bigger than the part size is uploaded in parts. If the value is bigger than 0, the object that is smaller is uploaded without being divided into parts. The file should not be larger than 2147483647 bytes when the value is 0. This option is only available when you select Service Account from the Credential type drop-down list in the Basic settings view.
tStatCatcher Statistics	Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

Use a custom endpoint

Select this check box to use a private endpoint rather than the default one.

When selected, enter the URL in the Google Storage Private API URL property, by respecting the following format: "https://storage.goggleapis.com".

For more information, see Access Google APIs through endpoints from Google documentation.

This property is only available when you authenticate using Service account.

Part size(Mb)

Specify the part size (in MB) when uploading an object in parts. The property work as follows:

If the value is 0, the object is uploaded without being divided into parts.
If the value is bigger than 0, the object that is bigger than the part size is uploaded in parts.
If the value is bigger than 0, the object that is smaller is uploaded without being divided into parts.

The file should not be larger than 2147483647 bytes when the value is 0.

This option is only available when you select Service Account from the Credential type drop-down list in the Basic settings view.

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

Global Variables	NB_LINE: the number of rows read by an input component or transferred to an output component. This is an After variable and it returns an integer. 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 more information about variables, see Using contexts and variables.

NB_LINE: the number of rows read by an input component or transferred to an output component. This is an After variable and it returns an integer.

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 more information about variables, see Using contexts and variables.

Usage

Usage rule	This component can be used together with other components, particularly the tGSGet component.