Class CloudSpannerProperties.Builder (2.44.0)

public static final class CloudSpannerProperties.Builder extends GeneratedMessageV3.Builder<CloudSpannerProperties.Builder> implements CloudSpannerPropertiesOrBuilder

Connection properties specific to Cloud Spanner.

Protobuf type google.cloud.bigquery.connection.v1.CloudSpannerProperties

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public CloudSpannerProperties.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

build()

public CloudSpannerProperties build()
Returns
Type Description
CloudSpannerProperties

buildPartial()

public CloudSpannerProperties buildPartial()
Returns
Type Description
CloudSpannerProperties

clear()

public CloudSpannerProperties.Builder clear()
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

clearDatabase()

public CloudSpannerProperties.Builder clearDatabase()

Cloud Spanner database in the form `project/instance/database'

string database = 1;

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clearDatabaseRole()

public CloudSpannerProperties.Builder clearDatabaseRole()

Optional. Cloud Spanner database role for fine-grained access control. The Cloud Spanner admin should have provisioned the database role with appropriate permissions, such as SELECT and INSERT. Other users should only use roles provided by their Cloud Spanner admins.

For more details, see About fine-grained access control.

REQUIRES: The database role name must start with a letter, and can only contain letters, numbers, and underscores.

string database_role = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clearField(Descriptors.FieldDescriptor field)

public CloudSpannerProperties.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

clearMaxParallelism()

public CloudSpannerProperties.Builder clearMaxParallelism()

Allows setting max parallelism per query when executing on Spanner independent compute resources. If unspecified, default values of parallelism are chosen that are dependent on the Cloud Spanner instance configuration.

REQUIRES: use_parallelism must be set. REQUIRES: Either use_data_boost or use_serverless_analytics must be set.

int32 max_parallelism = 5;

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public CloudSpannerProperties.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

clearUseDataBoost()

public CloudSpannerProperties.Builder clearUseDataBoost()

If set, the request will be executed via Spanner independent compute resources. REQUIRES: use_parallelism must be set.

NOTE: use_serverless_analytics will be deprecated. Prefer use_data_boost over use_serverless_analytics.

bool use_data_boost = 6;

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clearUseParallelism()

public CloudSpannerProperties.Builder clearUseParallelism()

If parallelism should be used when reading from Cloud Spanner

bool use_parallelism = 2;

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clearUseServerlessAnalytics()

public CloudSpannerProperties.Builder clearUseServerlessAnalytics()

If the serverless analytics service should be used to read data from Cloud Spanner. Note: use_parallelism must be set when using serverless analytics.

bool use_serverless_analytics = 3;

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

clone()

public CloudSpannerProperties.Builder clone()
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

getDatabase()

public String getDatabase()

Cloud Spanner database in the form `project/instance/database'

string database = 1;

Returns
Type Description
String

The database.

getDatabaseBytes()

public ByteString getDatabaseBytes()

Cloud Spanner database in the form `project/instance/database'

string database = 1;

Returns
Type Description
ByteString

The bytes for database.

getDatabaseRole()

public String getDatabaseRole()

Optional. Cloud Spanner database role for fine-grained access control. The Cloud Spanner admin should have provisioned the database role with appropriate permissions, such as SELECT and INSERT. Other users should only use roles provided by their Cloud Spanner admins.

For more details, see About fine-grained access control.

REQUIRES: The database role name must start with a letter, and can only contain letters, numbers, and underscores.

string database_role = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
String

The databaseRole.

getDatabaseRoleBytes()

public ByteString getDatabaseRoleBytes()

Optional. Cloud Spanner database role for fine-grained access control. The Cloud Spanner admin should have provisioned the database role with appropriate permissions, such as SELECT and INSERT. Other users should only use roles provided by their Cloud Spanner admins.

For more details, see About fine-grained access control.

REQUIRES: The database role name must start with a letter, and can only contain letters, numbers, and underscores.

string database_role = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ByteString

The bytes for databaseRole.

getDefaultInstanceForType()

public CloudSpannerProperties getDefaultInstanceForType()
Returns
Type Description
CloudSpannerProperties

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getMaxParallelism()

public int getMaxParallelism()

Allows setting max parallelism per query when executing on Spanner independent compute resources. If unspecified, default values of parallelism are chosen that are dependent on the Cloud Spanner instance configuration.

REQUIRES: use_parallelism must be set. REQUIRES: Either use_data_boost or use_serverless_analytics must be set.

int32 max_parallelism = 5;

Returns
Type Description
int

The maxParallelism.

getUseDataBoost()

public boolean getUseDataBoost()

If set, the request will be executed via Spanner independent compute resources. REQUIRES: use_parallelism must be set.

NOTE: use_serverless_analytics will be deprecated. Prefer use_data_boost over use_serverless_analytics.

bool use_data_boost = 6;

Returns
Type Description
boolean

The useDataBoost.

getUseParallelism()

public boolean getUseParallelism()

If parallelism should be used when reading from Cloud Spanner

bool use_parallelism = 2;

Returns
Type Description
boolean

The useParallelism.

getUseServerlessAnalytics()

public boolean getUseServerlessAnalytics()

If the serverless analytics service should be used to read data from Cloud Spanner. Note: use_parallelism must be set when using serverless analytics.

bool use_serverless_analytics = 3;

Returns
Type Description
boolean

The useServerlessAnalytics.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(CloudSpannerProperties other)

public CloudSpannerProperties.Builder mergeFrom(CloudSpannerProperties other)
Parameter
Name Description
other CloudSpannerProperties
Returns
Type Description
CloudSpannerProperties.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public CloudSpannerProperties.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
CloudSpannerProperties.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public CloudSpannerProperties.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final CloudSpannerProperties.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

setDatabase(String value)

public CloudSpannerProperties.Builder setDatabase(String value)

Cloud Spanner database in the form `project/instance/database'

string database = 1;

Parameter
Name Description
value String

The database to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setDatabaseBytes(ByteString value)

public CloudSpannerProperties.Builder setDatabaseBytes(ByteString value)

Cloud Spanner database in the form `project/instance/database'

string database = 1;

Parameter
Name Description
value ByteString

The bytes for database to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setDatabaseRole(String value)

public CloudSpannerProperties.Builder setDatabaseRole(String value)

Optional. Cloud Spanner database role for fine-grained access control. The Cloud Spanner admin should have provisioned the database role with appropriate permissions, such as SELECT and INSERT. Other users should only use roles provided by their Cloud Spanner admins.

For more details, see About fine-grained access control.

REQUIRES: The database role name must start with a letter, and can only contain letters, numbers, and underscores.

string database_role = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The databaseRole to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setDatabaseRoleBytes(ByteString value)

public CloudSpannerProperties.Builder setDatabaseRoleBytes(ByteString value)

Optional. Cloud Spanner database role for fine-grained access control. The Cloud Spanner admin should have provisioned the database role with appropriate permissions, such as SELECT and INSERT. Other users should only use roles provided by their Cloud Spanner admins.

For more details, see About fine-grained access control.

REQUIRES: The database role name must start with a letter, and can only contain letters, numbers, and underscores.

string database_role = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes for databaseRole to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setField(Descriptors.FieldDescriptor field, Object value)

public CloudSpannerProperties.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

setMaxParallelism(int value)

public CloudSpannerProperties.Builder setMaxParallelism(int value)

Allows setting max parallelism per query when executing on Spanner independent compute resources. If unspecified, default values of parallelism are chosen that are dependent on the Cloud Spanner instance configuration.

REQUIRES: use_parallelism must be set. REQUIRES: Either use_data_boost or use_serverless_analytics must be set.

int32 max_parallelism = 5;

Parameter
Name Description
value int

The maxParallelism to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public CloudSpannerProperties.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final CloudSpannerProperties.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
CloudSpannerProperties.Builder
Overrides

setUseDataBoost(boolean value)

public CloudSpannerProperties.Builder setUseDataBoost(boolean value)

If set, the request will be executed via Spanner independent compute resources. REQUIRES: use_parallelism must be set.

NOTE: use_serverless_analytics will be deprecated. Prefer use_data_boost over use_serverless_analytics.

bool use_data_boost = 6;

Parameter
Name Description
value boolean

The useDataBoost to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setUseParallelism(boolean value)

public CloudSpannerProperties.Builder setUseParallelism(boolean value)

If parallelism should be used when reading from Cloud Spanner

bool use_parallelism = 2;

Parameter
Name Description
value boolean

The useParallelism to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.

setUseServerlessAnalytics(boolean value)

public CloudSpannerProperties.Builder setUseServerlessAnalytics(boolean value)

If the serverless analytics service should be used to read data from Cloud Spanner. Note: use_parallelism must be set when using serverless analytics.

bool use_serverless_analytics = 3;

Parameter
Name Description
value boolean

The useServerlessAnalytics to set.

Returns
Type Description
CloudSpannerProperties.Builder

This builder for chaining.