Connections > Google Cloud Storage V2 connection properties > Connect to Google Cloud Storage V2

Connect to Google Cloud Storage V2

Let's configure the Google Cloud Storage V2 connection properties to connect to Google Cloud Storage.

Before you begin

Before you use Google Cloud Storage V2 Connector, complete the following prerequisite tasks:

1Ensure that you have a Google service account to access Google Cloud Storage.
2Ensure that you have the client_email, project_id, and private_key values for the service account. You will need to enter these details when you create a Google Cloud Storage connection in Data Integration.
3Ensure that you have enabled the Google Cloud Storage JSON API for your service account. Google Cloud Storage V2 Connector uses the Google API to integrate with Google Cloud Storage.
4Verify that you have read and write access to the Google Cloud Storage bucket that contains the source file and target file.
5When you read data from or write data to a Google Cloud Storage file in a mapping, you must have the required permissions to run the mapping successfully.
6To use the Informatica Encryption method, perform the following tasks:

- Ensure that you add the following firewall rules for the VPC network on the Google Cloud Platform advanced cluster:

▪ List of Secure Agent IP address ranges in the Source Filter section.
▪ Google Cloud Platform cluster IP address ranges in the Source Filter section.
▪ Port number 0-65535 and udp:443 under Protocols and Ports section.
▪ Ensure that the VPC network tag in the virtual machine that hosts the Secure Agent has the same value as the source tag and target tag of the firewall rules.

- Ensure that the Informatica crypto library license is enabled.

Connection details

The following table describes the Google Cloud Storage V2 connection properties:

Property	Description
Connection Name	Name of the connection. Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -, Maximum length is 255 characters.
Description	Description of the connection. Maximum length is 4000 characters.
Use Secret Vault	Stores sensitive credentials for this connection in the secrets manager that is configured for your organization. This property appears only if secrets manager is set up for your organization. This property is not supported by Data Ingestion and Replication. When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured. For information about how to configure and use a secrets manager, see Secrets manager configuration.
Type	Google Cloud Storage V2
Runtime Environment	The name of the runtime environment where you want to run tasks. Select a Secure Agent, Hosted Agent, or serverless runtime environment. You cannot run a database ingestion and replication task or streaming ingestion and replication task on a Hosted Agent or serverless runtime environment.
Service Account ID	The client_email value from the Google service account key JSON file.
Service Account Key	The private_key value from the Google service account key JSON file.
Project ID	The project_id value from the Google service account key JSON file. If you have created multiple projects with the same service account, enter the ID of the project that contains the dataset that you want to connect to.
Optimize Object Metadata Import	Optimizes the import of metadata for the selected object without parsing other objects, folders, or sub-folders available in the bucket. Directly importing metadata for the selected object can improve performance by reducing the overhead and time taken to parse each object available in the bucket. Default is not selected.

Advanced settings

The following table describes the advanced connection properties:

Property	Description
Private Key ID	The private_key_id value from the Google service account key JSON file. This property applies only to a database ingestion and replication or streaming ingestion and replication task.
Client ID	The client_id value from the Google service account key JSON file. This property applies only to a database ingestion and replication or streaming ingestion and replication task.
Is Encrypted File	Specifies whether a file is encrypted. Select this option when you import an encrypted file from Google Cloud Storage. Default is unselected. This property applies only to mappings in advanced mode.
Bucket Name	The Google Cloud Storage bucket name that you want to connect to. When you select a source object or target object in a mapping, the Package Explorer lists files and folders available in the specified Google Cloud Storage bucket. If you do not specify a bucket name, you can select a bucket from the Package Explorer to select a source or target object.