Google Spanner Connection

See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Google Spanner connector.

Google Spanner is a contact management service developed by Google.

This topic describes how to authenticate to Google Spanner and configure any necessary connection properties in the Google Spanner connection connector.

Prerequisites

Enable the Spanner API

Follow these steps to enable the Spanner API:

  1. Navigate to the Google Cloud Console.

  2. Select Library from the left-hand navigation menu. This opens the Library page.

  3. In the search field, enter “Spanner API” and select Spanner API from the search results.

  4. On the Spanner API page, click ENABLE.


Connection Configuration

Each connection property available in the Google Spanner connector is explained below.


Connection Name

The name of the connection to be created should be provided. This is the name that will display on the list of available connections.


Auth Scheme

The type of authentication to use when connecting to Google Spanner.

Possible Values


OAuth2

Set this to use OAuth2 authentication.

If OAuth2 is selected, additional configuration parameters will get listed.

Client ID

The client ID assigned when you register your application with an OAuth authorization server.

Client Secret

The client secret assigned when you register your application with an OAuth authorization server.

Refresh Token

The OAuth refresh token for the corresponding OAuth access token.


Service Account

Set this to use Service Account as authentication.

If Service Account is selected, additional configuration parameters will get listed.

Certificate Type

The type of key store containing the Service Account Certificate.

Possible Values


JSON

Set this to use a certificate with type as JSON, for authentication.

If JSON is selected, proceed by uploading the keystore file.


PFX

Set this to use a certificate with type as P12, for authentication.

If PFX is selected, additional configuration parameters will get listed.

  • Certificate Issuer: Set this to the email address of the service account. This address will usually include the domain iam.gserviceaccount.com.

  • Certificate Password: Set this to the .pfx file password. In most cases you must provide this since Google encrypts PFX certificates.


Upload File

Upload Service Account Certificate. Use JSON file if Certificate Type is JSON, else use PFX(P12).


Database Dialect

The diealect type of the connected database.

Possible Values: GoogleStandardSQL, PostgreSQL


Database

The name of the Google Spanner database to connect to.


Instance ID

The address of the Google Spanner instance to which you are connecting.

You can find this value at instance overview.

Instances will be listed once you select Spanner from the Google Cloud Console Menu.


Project ID

The id of the project where your Google Spanner instance resides.

You can find this value by going to Google Cloud Console and clicking the project name at the top left screen.

The ProjectId is displayed on the Id column of the matching project.


UseGrpcEndpoint

This property determines whether or not the Grpc endpoint will be used.

Most proxies will not work with the Grpc endpoint.

If set to false, the protobuf endpoint will be used.

The latter has issues with NULL values, but proxies will work on it.


After entering all the details, click on the TEST button.

If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.

Click on the CREATE button to save the changes.

If the details are incorrect or the server is down, you will get a message “Connection unavailable”.

Top