Class InsertAllRequest (2.21.0)

public final class InsertAllRequest implements Serializable

Google Cloud BigQuery insert all request. This class can be used to stream data into BigQuery one record at a time without needing to run a load job. This approach enables querying data without the delay of running a load job. There are several important trade-offs to consider before choosing an approach. See Also: Streaming Data into BigQuery

Inheritance

Object > InsertAllRequest

Implements

Serializable

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

newBuilder(TableId table)

public static InsertAllRequest.Builder newBuilder(TableId table)

Returns a builder for an InsertAllRequest object given the destination table.

Parameter

Name	Description
`table`	`TableId`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(TableId table, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest.Builder newBuilder(TableId table, InsertAllRequest.RowToInsert[] rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`table`	`TableId`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(TableId table, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest.Builder newBuilder(TableId table, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`table`	`TableId`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(TableInfo tableInfo, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest.Builder newBuilder(TableInfo tableInfo, InsertAllRequest.RowToInsert[] rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableInfo`	`TableInfo`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(TableInfo tableInfo, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest.Builder newBuilder(TableInfo tableInfo, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableInfo`	`TableInfo`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(String datasetId, String tableId)

public static InsertAllRequest.Builder newBuilder(String datasetId, String tableId)

Returns a builder for an InsertAllRequest object given the destination table.

Parameters

Name	Description
`datasetId`	`String`
`tableId`	`String`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(String datasetId, String tableId, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest.Builder newBuilder(String datasetId, String tableId, InsertAllRequest.RowToInsert[] rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`datasetId`	`String`
`tableId`	`String`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest.Builder`

newBuilder(String datasetId, String tableId, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest.Builder newBuilder(String datasetId, String tableId, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a builder for an InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`datasetId`	`String`
`tableId`	`String`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest.Builder`

of(TableId tableId, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest of(TableId tableId, InsertAllRequest.RowToInsert[] rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableId`	`TableId`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest`

of(TableId tableId, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest of(TableId tableId, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableId`	`TableId`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest`

of(TableInfo tableInfo, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest of(TableInfo tableInfo, InsertAllRequest.RowToInsert[] rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableInfo`	`TableInfo`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest`

of(TableInfo tableInfo, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest of(TableInfo tableInfo, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`tableInfo`	`TableInfo`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest`

of(String datasetId, String tableId, InsertAllRequest.RowToInsert[] rows)

public static InsertAllRequest of(String datasetId, String tableId, InsertAllRequest.RowToInsert[] rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`datasetId`	`String`
`tableId`	`String`
`rows`	`RowToInsert[]`

Returns

Type	Description
`InsertAllRequest`

of(String datasetId, String tableId, Iterable<InsertAllRequest.RowToInsert> rows)

public static InsertAllRequest of(String datasetId, String tableId, Iterable<InsertAllRequest.RowToInsert> rows)

Returns a InsertAllRequest object given the destination table and the rows to insert.

Parameters

Name	Description
`datasetId`	`String`
`tableId`	`String`
`rows`	`Iterable<RowToInsert>`

Returns

Type	Description
`InsertAllRequest`

Methods

equals(Object obj)

public boolean equals(Object obj)

Parameter

Name	Description
`obj`	`Object`

Returns

Type	Description
`boolean`

Overrides

Object.equals(Object)

getRows()

public List<InsertAllRequest.RowToInsert> getRows()

Returns the rows to be inserted.

Returns

Type	Description
`List<RowToInsert>`

getTable()

public TableId getTable()

Returns the destination table for rows insert request.

Returns

Type	Description
`TableId`

getTemplateSuffix()

public String getTemplateSuffix()

If specified, the destination table is treated as a base template. Rows are inserted into an instance table named "{destination}{templateSuffix}". BigQuery will manage the creation of the instance table, using the schema of the base template table. Table creation might take some time. To obtain table's information after BigQuery#insertAll(InsertAllRequest) is called use:


 String suffixTableId = ...;
 TableInfo suffixTable = bigquery.getTable(DATASET, suffixTableId);
 while (suffixTable == null) {
   Thread.sleep(1000L);
   suffixTable = bigquery.getTable(DATASET, suffixTableId);
 }

hashCode()

public int hashCode()

Returns

Type	Description
`int`

Overrides

Object.hashCode()

ignoreUnknownValues()

public Boolean ignoreUnknownValues()

Returns whether to accept rows that contain values that do not match the schema. The unknown values are ignored. If not set, rows with unknown values are considered to be invalid.

Returns

Type	Description
`Boolean`

skipInvalidRows()

public Boolean skipInvalidRows()

Returns whether to insert all valid rows of a request, even if invalid rows exist. If not set the entire insert request will fail if it contains an invalid row.

Returns

Type	Description
`Boolean`

toString()

public String toString()

Returns

Type	Description
`String`

Overrides

Object.toString()