public static final class StreamWriter.Builder
Methods
build()
public StreamWriter build()
Builds the StreamWriterV2
.
setChannelProvider(TransportChannelProvider channelProvider)
public StreamWriter.Builder setChannelProvider(TransportChannelProvider channelProvider)
ChannelProvider
to use to create Channels, which must point at Cloud BigQuery Storage
API endpoint.
For performance, this client benefits from having multiple underlying connections. See
com.google.api.gax.grpc.InstantiatingGrpcChannelProvider.Builder#setPoolSize(int).
setCompressorName(String compressorName)
public StreamWriter.Builder setCompressorName(String compressorName)
Parameter |
Name |
Description |
compressorName |
String
|
setCredentialsProvider(CredentialsProvider credentialsProvider)
public StreamWriter.Builder setCredentialsProvider(CredentialsProvider credentialsProvider)
CredentialsProvider
to use to create Credentials to authenticate calls.
setDefaultMissingValueInterpretation(AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation)
public StreamWriter.Builder setDefaultMissingValueInterpretation(AppendRowsRequest.MissingValueInterpretation defaultMissingValueInterpretation)
Sets the default missing value interpretation value if the column is not presented in the
missing_value_interpretations map.
setEnableConnectionPool(boolean enableConnectionPool)
public StreamWriter.Builder setEnableConnectionPool(boolean enableConnectionPool)
Enable multiplexing for this writer. In multiplexing mode tables will share the same
connection if possible until the connection is overwhelmed.
Parameter |
Name |
Description |
enableConnectionPool |
boolean
|
setEnableLatencyProfiler(boolean enableLatencyProfiler)
public StreamWriter.Builder setEnableLatencyProfiler(boolean enableLatencyProfiler)
Enable a latency profiler that would periodically generate a detailed latency report for the
top latency requests. This is currently an experimental API.
Parameter |
Name |
Description |
enableLatencyProfiler |
boolean
|
setEnableOpenTelemetry(boolean enableOpenTelemetry)
public StreamWriter.Builder setEnableOpenTelemetry(boolean enableOpenTelemetry)
Enable generation of metrics for OpenTelemetry.
Parameter |
Name |
Description |
enableOpenTelemetry |
boolean
|
setEndpoint(String endpoint)
public StreamWriter.Builder setEndpoint(String endpoint)
Gives the ability to override the gRPC endpoint.
Parameter |
Name |
Description |
endpoint |
String
|
setExecutorProvider(ExecutorProvider executorProvider)
public StreamWriter.Builder setExecutorProvider(ExecutorProvider executorProvider)
ExecutorProvider
to use to create Executor to run background jobs.
setLimitExceededBehavior(FlowController.LimitExceededBehavior limitExceededBehavior)
public StreamWriter.Builder setLimitExceededBehavior(FlowController.LimitExceededBehavior limitExceededBehavior)
Sets the limit exceeded behavior.
Exceptions |
Type |
Description |
io.grpc.StatusRuntimeException |
|
setLocation(String location)
public StreamWriter.Builder setLocation(String location)
Location of the table this stream writer is targeting.
Parameter |
Name |
Description |
location |
String
|
setMaxInflightBytes(long value)
public StreamWriter.Builder setMaxInflightBytes(long value)
Parameter |
Name |
Description |
value |
long
|
setMaxInflightRequests(long value)
public StreamWriter.Builder setMaxInflightRequests(long value)
Parameter |
Name |
Description |
value |
long
|
setMaxRetryDuration(Duration maxRetryDuration)
public StreamWriter.Builder setMaxRetryDuration(Duration maxRetryDuration)
Parameter |
Name |
Description |
maxRetryDuration |
Duration
|
setMissingValueInterpretationMap(Map<String,AppendRowsRequest.MissingValueInterpretation> missingValueInterpretationMap)
public StreamWriter.Builder setMissingValueInterpretationMap(Map<String,AppendRowsRequest.MissingValueInterpretation> missingValueInterpretationMap)
Sets the missing value interpretation map for the stream writer. The input
missingValueInterpretationMap is used for all write requests unless otherwise changed.
setRetrySettings(RetrySettings retrySettings)
public StreamWriter.Builder setRetrySettings(RetrySettings retrySettings)
Enable client lib automatic retries on request level errors.
Immeidate Retry code:
ABORTED, UNAVAILABLE, CANCELLED, INTERNAL, DEADLINE_EXCEEDED
Backoff Retry code:
RESOURCE_EXHAUSTED
Example:
RetrySettings retrySettings = RetrySettings.newBuilder()
.setInitialRetryDelay(Duration.ofMillis(500)) // applies to backoff retry
.setRetryDelayMultiplier(1.1) // applies to backoff retry
.setMaxAttempts(5) // applies to both retries
.setMaxRetryDelay(Duration.ofMinutes(1)) // applies to backoff retry .build();
setTraceId(String traceId)
public StreamWriter.Builder setTraceId(String traceId)
Sets traceId for debuging purpose. TraceId must follow the format of
CustomerDomain:DebugString, e.g. DATAFLOW:job_id_x.
Parameter |
Name |
Description |
traceId |
String
|
setWriterSchema(ProtoSchema writerSchema)
public StreamWriter.Builder setWriterSchema(ProtoSchema writerSchema)
Sets the proto schema of the rows.