Class WriteChannelConfiguration (2.41.0)

public final class WriteChannelConfiguration implements LoadConfiguration, Serializable

Google BigQuery Configuration for a load operation. A load configuration can be used to load data into a table with a com.google.cloud.WriteChannel (BigQuery#writer(WriteChannelConfiguration)).

Inheritance

Object > WriteChannelConfiguration

Static Methods

newBuilder(TableId destinationTable)

public static WriteChannelConfiguration.Builder newBuilder(TableId destinationTable)

Creates a builder for a BigQuery Load Configuration given the destination table.

Parameter
Name Description
destinationTable TableId
Returns
Type Description
WriteChannelConfiguration.Builder

newBuilder(TableId destinationTable, FormatOptions format)

public static WriteChannelConfiguration.Builder newBuilder(TableId destinationTable, FormatOptions format)

Creates a builder for a BigQuery Load Configuration given the destination table and format.

Parameters
Name Description
destinationTable TableId
format FormatOptions
Returns
Type Description
WriteChannelConfiguration.Builder

of(TableId destinationTable)

public static WriteChannelConfiguration of(TableId destinationTable)

Returns a BigQuery Load Configuration for the given destination table.

Parameter
Name Description
destinationTable TableId
Returns
Type Description
WriteChannelConfiguration

of(TableId destinationTable, FormatOptions format)

public static WriteChannelConfiguration of(TableId destinationTable, FormatOptions format)

Returns a BigQuery Load Configuration for the given destination table and format.

Parameters
Name Description
destinationTable TableId
format FormatOptions
Returns
Type Description
WriteChannelConfiguration

Constructors

WriteChannelConfiguration(WriteChannelConfiguration.Builder builder)

protected WriteChannelConfiguration(WriteChannelConfiguration.Builder builder)
Parameter
Name Description
builder WriteChannelConfiguration.Builder

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
boolean
Overrides

getAutodetect()

public Boolean getAutodetect()

[Experimental] Returns whether automatic inference of the options and schema for CSV and JSON sources is set.

Returns
Type Description
Boolean

getClustering()

public Clustering getClustering()

Returns the clustering specification for the definition table.

Returns
Type Description
Clustering

getConnectionProperties()

public List<ConnectionProperty> getConnectionProperties()
Returns
Type Description
List<ConnectionProperty>

getCreateDisposition()

public JobInfo.CreateDisposition getCreateDisposition()

Returns whether the job is allowed to create new tables.

Returns
Type Description
JobInfo.CreateDisposition

getCreateSession()

public Boolean getCreateSession()
Returns
Type Description
Boolean

getCsvOptions()

public CsvOptions getCsvOptions()

Returns additional properties used to parse CSV data (used when #getFormat() is set to CSV). Returns null if not set.

Returns
Type Description
CsvOptions

getDatastoreBackupOptions()

public DatastoreBackupOptions getDatastoreBackupOptions()

Returns additional options used to load from a Cloud datastore backup.

Returns
Type Description
DatastoreBackupOptions

getDecimalTargetTypes()

public List<String> getDecimalTargetTypes()

Returns the list of possible SQL data types to which the source decimal values are converted. This list and the precision and the scale parameters of the decimal field determine the target type. In the order of NUMERIC, BIGNUMERIC, and STRING, a type is picked if it is in the specified list and if it supports the precision and the scale. STRING supports all precision and scale values.

Returns
Type Description
List<String>

getDestinationEncryptionConfiguration()

public EncryptionConfiguration getDestinationEncryptionConfiguration()
Returns
Type Description
EncryptionConfiguration

getDestinationTable()

public TableId getDestinationTable()

Returns the destination table to load the data into.

Returns
Type Description
TableId

getFormat()

public String getFormat()

Returns the format of the data files.

Returns
Type Description
String

getLabels()

public Map<String,String> getLabels()
Returns
Type Description
Map<String,String>

getMaxBadRecords()

public Integer getMaxBadRecords()

Returns the maximum number of bad records that BigQuery can ignore when running the job. If the number of bad records exceeds this value, an invalid error is returned in the job result. By default no bad record is ignored.

Returns
Type Description
Integer

getNullMarker()

public String getNullMarker()

Returns the string that represents a null value in a CSV file.

Returns
Type Description
String

getSchema()

public Schema getSchema()

Returns the schema for the destination table, if set. Returns null otherwise.

Returns
Type Description
Schema

getSchemaUpdateOptions()

public List<JobInfo.SchemaUpdateOption> getSchemaUpdateOptions()

[Experimental] Returns options allowing the schema of the destination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema.

Returns
Type Description
List<SchemaUpdateOption>

getTimePartitioning()

public TimePartitioning getTimePartitioning()

Returns the time partitioning specification defined for the destination table.

Returns
Type Description
TimePartitioning

getUseAvroLogicalTypes()

public Boolean getUseAvroLogicalTypes()

Returns True/False. Indicates whether the logical type is interpreted.

Returns
Type Description
Boolean

getWriteDisposition()

public JobInfo.WriteDisposition getWriteDisposition()

Returns the action that should occur if the destination table already exists.

Returns
Type Description
JobInfo.WriteDisposition

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

ignoreUnknownValues()

public Boolean ignoreUnknownValues()

Returns whether BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If true, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. By default unknown values are not allowed.

Returns
Type Description
Boolean

toBuilder()

public WriteChannelConfiguration.Builder toBuilder()

Returns a builder for the load configuration object.

Returns
Type Description
WriteChannelConfiguration.Builder

toString()

public String toString()
Returns
Type Description
String
Overrides