public static final class InsertRecordsRequest.Options extends Object
UPDATE_ON_EXISTING_PK
: Specifies the record collision policy for
inserting into a table with a primary key. If set to true
, any existing
table record with primary key values that match those of a record being
inserted will be replaced by that new record. If set to false
,
any existing table record with primary key values that match those of a
record being inserted will remain unchanged and the new record
discarded. If the specified table does not have a primary key, then
this option is ignored.
Supported values:
The default value is FALSE
.
RETURN_RECORD_IDS
: If true
then return the internal record id
along for each inserted record.
Supported values:
The default value is FALSE
.
TRUNCATE_STRINGS
: If set to true
, any strings which are too
long for their target charN string columns will be truncated to fit.
Supported values:
The default value is FALSE
.
RETURN_INDIVIDUAL_ERRORS
: If set to true
, success will always
be returned, and any errors found will be included in the info map. The
"bad_record_indices" entry is a comma-separated list of bad records
(0-based). And if so, there will also be an "error_N" entry for each
record with an error, where N is the index (0-based).
Supported values:
The default value is FALSE
.
ALLOW_PARTIAL_BATCH
: If set to true
, all correct records will
be inserted and incorrect records will be rejected and reported.
Otherwise, the entire batch will be rejected if any records are
incorrect.
Supported values:
The default value is FALSE
.
DRY_RUN
: If
set to true
, no data will be saved and any errors will be
returned.
Supported values:
The default value is FALSE
.
Map
.
A set of string constants for the parameter options
.Modifier and Type | Field and Description |
---|---|
static String |
ALLOW_PARTIAL_BATCH
If set to
true , all correct records will be inserted and
incorrect records will be rejected and reported. |
static String |
DRY_RUN
If set to
true , no data will be saved and any errors will be
returned. |
static String |
FALSE |
static String |
RETURN_INDIVIDUAL_ERRORS
If set to
true , success will always be returned, and any
errors found will be included in the info map. |
static String |
RETURN_RECORD_IDS
If
true then return the internal record id along for each
inserted record. |
static String |
TRUE |
static String |
TRUNCATE_STRINGS
If set to
true , any strings which are too long for their
target charN string columns will be truncated to fit. |
static String |
UPDATE_ON_EXISTING_PK
Specifies the record collision policy for inserting into a table
with a primary key.
|
public static final String UPDATE_ON_EXISTING_PK
true
, any existing
table record with primary key values that match those of a record
being inserted will be replaced by that new record. If set to
false
, any existing table record with primary key values
that match those of a record being inserted will remain unchanged
and the new record discarded. If the specified table does not have
a primary key, then this option is ignored.
Supported values:
The default value is FALSE
.public static final String TRUE
public static final String FALSE
public static final String RETURN_RECORD_IDS
true
then return the internal record id along for each
inserted record.
Supported values:
The default value is FALSE
.public static final String TRUNCATE_STRINGS
true
, any strings which are too long for their
target charN string columns will be truncated to fit.
Supported values:
The default value is FALSE
.public static final String RETURN_INDIVIDUAL_ERRORS
true
, success will always be returned, and any
errors found will be included in the info map. The
"bad_record_indices" entry is a comma-separated list of bad records
(0-based). And if so, there will also be an "error_N" entry for
each record with an error, where N is the index (0-based).
Supported values:
The default value is FALSE
.public static final String ALLOW_PARTIAL_BATCH
true
, all correct records will be inserted and
incorrect records will be rejected and reported. Otherwise, the
entire batch will be rejected if any records are incorrect.
Supported values:
The default value is FALSE
.public static final String DRY_RUN
true
, no data will be saved and any errors will be
returned.
Supported values:
The default value is FALSE
.Copyright © 2020. All rights reserved.