Class CreateReadSessionRequest.Builder (2.45.0)

public static final class CreateReadSessionRequest.Builder extends GeneratedMessageV3.Builder<CreateReadSessionRequest.Builder> implements CreateReadSessionRequestOrBuilder

Request message for CreateReadSession.

Protobuf type google.cloud.bigquery.storage.v1.CreateReadSessionRequest

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public CreateReadSessionRequest.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

build()

public CreateReadSessionRequest build()
Returns
TypeDescription
CreateReadSessionRequest

buildPartial()

public CreateReadSessionRequest buildPartial()
Returns
TypeDescription
CreateReadSessionRequest

clear()

public CreateReadSessionRequest.Builder clear()
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

clearField(Descriptors.FieldDescriptor field)

public CreateReadSessionRequest.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

clearMaxStreamCount()

public CreateReadSessionRequest.Builder clearMaxStreamCount()

Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table. There is a default system max limit of 1,000.

This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle.

int32 max_stream_count = 3;

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public CreateReadSessionRequest.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

clearParent()

public CreateReadSessionRequest.Builder clearParent()

Required. The request project that owns the session, in the form of projects/{project_id}.

string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

clearPreferredMinStreamCount()

public CreateReadSessionRequest.Builder clearPreferredMinStreamCount()

The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams. This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization).

The system will make a best effort to provide at least this number of streams, but in some cases might provide less.

int32 preferred_min_stream_count = 4;

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

clearReadSession()

public CreateReadSessionRequest.Builder clearReadSession()

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
CreateReadSessionRequest.Builder

clone()

public CreateReadSessionRequest.Builder clone()
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

getDefaultInstanceForType()

public CreateReadSessionRequest getDefaultInstanceForType()
Returns
TypeDescription
CreateReadSessionRequest

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getMaxStreamCount()

public int getMaxStreamCount()

Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table. There is a default system max limit of 1,000.

This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle.

int32 max_stream_count = 3;

Returns
TypeDescription
int

The maxStreamCount.

getParent()

public String getParent()

Required. The request project that owns the session, in the form of projects/{project_id}.

string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }

Returns
TypeDescription
String

The parent.

getParentBytes()

public ByteString getParentBytes()

Required. The request project that owns the session, in the form of projects/{project_id}.

string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }

Returns
TypeDescription
ByteString

The bytes for parent.

getPreferredMinStreamCount()

public int getPreferredMinStreamCount()

The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams. This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization).

The system will make a best effort to provide at least this number of streams, but in some cases might provide less.

int32 preferred_min_stream_count = 4;

Returns
TypeDescription
int

The preferredMinStreamCount.

getReadSession()

public ReadSession getReadSession()

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
ReadSession

The readSession.

getReadSessionBuilder()

public ReadSession.Builder getReadSessionBuilder()

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
ReadSession.Builder

getReadSessionOrBuilder()

public ReadSessionOrBuilder getReadSessionOrBuilder()

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
ReadSessionOrBuilder

hasReadSession()

public boolean hasReadSession()

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
boolean

Whether the readSession field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(CreateReadSessionRequest other)

public CreateReadSessionRequest.Builder mergeFrom(CreateReadSessionRequest other)
Parameter
NameDescription
otherCreateReadSessionRequest
Returns
TypeDescription
CreateReadSessionRequest.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public CreateReadSessionRequest.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public CreateReadSessionRequest.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

mergeReadSession(ReadSession value)

public CreateReadSessionRequest.Builder mergeReadSession(ReadSession value)

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
valueReadSession
Returns
TypeDescription
CreateReadSessionRequest.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final CreateReadSessionRequest.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

setField(Descriptors.FieldDescriptor field, Object value)

public CreateReadSessionRequest.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

setMaxStreamCount(int value)

public CreateReadSessionRequest.Builder setMaxStreamCount(int value)

Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table. There is a default system max limit of 1,000.

This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle.

int32 max_stream_count = 3;

Parameter
NameDescription
valueint

The maxStreamCount to set.

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

setParent(String value)

public CreateReadSessionRequest.Builder setParent(String value)

Required. The request project that owns the session, in the form of projects/{project_id}.

string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }

Parameter
NameDescription
valueString

The parent to set.

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

setParentBytes(ByteString value)

public CreateReadSessionRequest.Builder setParentBytes(ByteString value)

Required. The request project that owns the session, in the form of projects/{project_id}.

string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }

Parameter
NameDescription
valueByteString

The bytes for parent to set.

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

setPreferredMinStreamCount(int value)

public CreateReadSessionRequest.Builder setPreferredMinStreamCount(int value)

The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams. This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization).

The system will make a best effort to provide at least this number of streams, but in some cases might provide less.

int32 preferred_min_stream_count = 4;

Parameter
NameDescription
valueint

The preferredMinStreamCount to set.

Returns
TypeDescription
CreateReadSessionRequest.Builder

This builder for chaining.

setReadSession(ReadSession value)

public CreateReadSessionRequest.Builder setReadSession(ReadSession value)

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
valueReadSession
Returns
TypeDescription
CreateReadSessionRequest.Builder

setReadSession(ReadSession.Builder builderForValue)

public CreateReadSessionRequest.Builder setReadSession(ReadSession.Builder builderForValue)

Required. Session to be created.

.google.cloud.bigquery.storage.v1.ReadSession read_session = 2 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
builderForValueReadSession.Builder
Returns
TypeDescription
CreateReadSessionRequest.Builder

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

public CreateReadSessionRequest.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final CreateReadSessionRequest.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CreateReadSessionRequest.Builder
Overrides