Package com.google.cloud.bigquery.storage.v1

Interface AppendRowsRequestOrBuilder

All Superinterfaces:
com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
All Known Implementing Classes:
AppendRowsRequest, AppendRowsRequest.Builder
public interface AppendRowsRequestOrBuilder extends com.google.protobuf.MessageOrBuilder

  • Method Details

    • getWriteStream

      String getWriteStream()
       Required. The write_stream identifies the append operation. It must be
 provided in the following scenarios:

 * In the first request to an AppendRows connection.

 * In all subsequent requests to an AppendRows connection, if you use the
 same connection to write to multiple tables or change the input schema for
 default streams.

 For explicitly created write streams, the format is:

 * `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`

 For the special default stream, the format is:

 * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`.

 An example of a possible sequence of requests with write_stream fields
 within a single connection:

 * r1: {write_stream: stream_name_1}

 * r2: {write_stream: /*omit*/}

 * r3: {write_stream: /*omit*/}

 * r4: {write_stream: stream_name_2}

 * r5: {write_stream: stream_name_2}

 The destination changed in request_4, so the write_stream field must be
 populated in all subsequent requests in this stream.
      string write_stream = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
      Returns:
      The writeStream.

    • getWriteStreamBytes

      com.google.protobuf.ByteString getWriteStreamBytes()
       Required. The write_stream identifies the append operation. It must be
 provided in the following scenarios:

 * In the first request to an AppendRows connection.

 * In all subsequent requests to an AppendRows connection, if you use the
 same connection to write to multiple tables or change the input schema for
 default streams.

 For explicitly created write streams, the format is:

 * `projects/{project}/datasets/{dataset}/tables/{table}/streams/{id}`

 For the special default stream, the format is:

 * `projects/{project}/datasets/{dataset}/tables/{table}/streams/_default`.

 An example of a possible sequence of requests with write_stream fields
 within a single connection:

 * r1: {write_stream: stream_name_1}

 * r2: {write_stream: /*omit*/}

 * r3: {write_stream: /*omit*/}

 * r4: {write_stream: stream_name_2}

 * r5: {write_stream: stream_name_2}

 The destination changed in request_4, so the write_stream field must be
 populated in all subsequent requests in this stream.
      string write_stream = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
      Returns:
      The bytes for writeStream.

    • hasOffset

      boolean hasOffset()
       If present, the write is only performed if the next append offset is same
 as the provided value. If not present, the write is performed at the
 current end of stream. Specifying a value for this field is not allowed
 when calling AppendRows for the '_default' stream.
      .google.protobuf.Int64Value offset = 2;
      Returns:
      Whether the offset field is set.

    • getOffset

      com.google.protobuf.Int64Value getOffset()
       If present, the write is only performed if the next append offset is same
 as the provided value. If not present, the write is performed at the
 current end of stream. Specifying a value for this field is not allowed
 when calling AppendRows for the '_default' stream.
      .google.protobuf.Int64Value offset = 2;
      Returns:
      The offset.

    • getOffsetOrBuilder

      com.google.protobuf.Int64ValueOrBuilder getOffsetOrBuilder()
       If present, the write is only performed if the next append offset is same
 as the provided value. If not present, the write is performed at the
 current end of stream. Specifying a value for this field is not allowed
 when calling AppendRows for the '_default' stream.
      .google.protobuf.Int64Value offset = 2;

    • hasProtoRows

      boolean hasProtoRows()
       Rows in proto format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ProtoData proto_rows = 4;
      Returns:
      Whether the protoRows field is set.

    • getProtoRows

      AppendRowsRequest.ProtoData getProtoRows()
       Rows in proto format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ProtoData proto_rows = 4;
      Returns:
      The protoRows.

    • getProtoRowsOrBuilder

      AppendRowsRequest.ProtoDataOrBuilder getProtoRowsOrBuilder()
       Rows in proto format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ProtoData proto_rows = 4;

    • hasArrowRows

      boolean hasArrowRows()
       Rows in arrow format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ArrowData arrow_rows = 5;
      Returns:
      Whether the arrowRows field is set.

    • getArrowRows

      AppendRowsRequest.ArrowData getArrowRows()
       Rows in arrow format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ArrowData arrow_rows = 5;
      Returns:
      The arrowRows.

    • getArrowRowsOrBuilder

      AppendRowsRequest.ArrowDataOrBuilder getArrowRowsOrBuilder()
       Rows in arrow format.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.ArrowData arrow_rows = 5;

    • getTraceId

      String getTraceId()
       Id set by client to annotate its identity. Only initial request setting is
 respected.
      string trace_id = 6;
      Returns:
      The traceId.

    • getTraceIdBytes

      com.google.protobuf.ByteString getTraceIdBytes()
       Id set by client to annotate its identity. Only initial request setting is
 respected.
      string trace_id = 6;
      Returns:
      The bytes for traceId.

    • getMissingValueInterpretationsCount

      int getMissingValueInterpretationsCount()
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • containsMissingValueInterpretations

      boolean containsMissingValueInterpretations(String key)
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretations

      @Deprecated Map<String,AppendRowsRequest.MissingValueInterpretation> getMissingValueInterpretations()
      Deprecated.
      Use getMissingValueInterpretationsMap() instead.

    • getMissingValueInterpretationsMap

      Map<String,AppendRowsRequest.MissingValueInterpretation> getMissingValueInterpretationsMap()
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretationsOrDefault

      AppendRowsRequest.MissingValueInterpretation getMissingValueInterpretationsOrDefault(String key, AppendRowsRequest.MissingValueInterpretation defaultValue)
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretationsOrThrow

      AppendRowsRequest.MissingValueInterpretation getMissingValueInterpretationsOrThrow(String key)
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretationsValue

      @Deprecated Map<String,Integer> getMissingValueInterpretationsValue()
      Deprecated.
      Use getMissingValueInterpretationsValueMap() instead.

    • getMissingValueInterpretationsValueMap

      Map<String,Integer> getMissingValueInterpretationsValueMap()
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretationsValueOrDefault

      int getMissingValueInterpretationsValueOrDefault(String key, int defaultValue)
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getMissingValueInterpretationsValueOrThrow

      int getMissingValueInterpretationsValueOrThrow(String key)
       A map to indicate how to interpret missing value for some fields. Missing
 values are fields present in user schema but missing in rows. The key is
 the field name. The value is the interpretation of missing values for the
 field.

 For example, a map {'foo': NULL_VALUE, 'bar': DEFAULT_VALUE} means all
 missing values in field foo are interpreted as NULL, all missing values in
 field bar are interpreted as the default value of field bar in table
 schema.

 If a field is not in this map and has missing values, the missing values
 in this field are interpreted as NULL.

 This field only applies to the current request, it won't affect other
 requests on the connection.

 Currently, field name can only be top-level column name, can't be a struct
 field path like 'foo.bar'.
      map<string, .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation> missing_value_interpretations = 7;

    • getDefaultMissingValueInterpretationValue

      int getDefaultMissingValueInterpretationValue()
       Optional. Default missing value interpretation for all columns in the
 table. When a value is specified on an `AppendRowsRequest`, it is applied
 to all requests from that point forward, until a subsequent
 `AppendRowsRequest` sets it to a different value.
 `missing_value_interpretation` can override
 `default_missing_value_interpretation`. For example, if you want to write
 `NULL` instead of using default values for some columns, you can set
 `default_missing_value_interpretation` to `DEFAULT_VALUE` and at the same
 time, set `missing_value_interpretations` to `NULL_VALUE` on those columns.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation default_missing_value_interpretation = 8 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      The enum numeric value on the wire for defaultMissingValueInterpretation.

    • getDefaultMissingValueInterpretation

      AppendRowsRequest.MissingValueInterpretation getDefaultMissingValueInterpretation()
       Optional. Default missing value interpretation for all columns in the
 table. When a value is specified on an `AppendRowsRequest`, it is applied
 to all requests from that point forward, until a subsequent
 `AppendRowsRequest` sets it to a different value.
 `missing_value_interpretation` can override
 `default_missing_value_interpretation`. For example, if you want to write
 `NULL` instead of using default values for some columns, you can set
 `default_missing_value_interpretation` to `DEFAULT_VALUE` and at the same
 time, set `missing_value_interpretations` to `NULL_VALUE` on those columns.
      .google.cloud.bigquery.storage.v1.AppendRowsRequest.MissingValueInterpretation default_missing_value_interpretation = 8 [(.google.api.field_behavior) = OPTIONAL];
      Returns:
      The defaultMissingValueInterpretation.

    • getRowsCase

      AppendRowsRequest.RowsCase getRowsCase()