InsertRecordsRequest.Options (Kinetica Java API 7.2.3.0 API)

Skip navigation links

All Classes

Summary:
Nested |
Field |
Constr |
Method

Detail:
Field |
Constr |
Method

java.lang.Object
- com.gpudb.protocol.InsertRecordsRequest.Options

Enclosing class:

InsertRecordsRequest<T>
```
public static final class InsertRecordsRequest.Options
extends Object
```
A set of string constants for the InsertRecordsRequest parameter options.
Optional parameters.

Field Summary

Fields
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`	`IGNORE_EXISTING_PK` Specifies the record collision error-suppression policy for inserting into a table with a	`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 Method Summary Methods inherited from class java.lang.Object `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait` Field Detail UPDATE_ON_EXISTING_PK public static final String 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 (the new data will be "upserted"). If set to `FALSE`, any existing table record with primary key values that match those of a record being inserted will remain unchanged, while the new record will be rejected and the error handled as determined by `IGNORE_EXISTING_PK`, `ALLOW_PARTIAL_BATCH`, & `RETURN_INDIVIDUAL_ERRORS`. If the specified table does not have a primary key, then this option has no effect. Supported values: `TRUE`: Upsert new records when primary keys match existing records `FALSE`: Reject new records when primary keys match existing records The default value is `FALSE`. See Also: Constant Field Values TRUE public static final String TRUE See Also: Constant Field Values FALSE public static final String FALSE See Also: Constant Field Values IGNORE_EXISTING_PK public static final String IGNORE_EXISTING_PK Specifies the record collision error-suppression policy for inserting into a table with a primary key, only used when not in upsert mode (upsert mode is disabled when `UPDATE_ON_EXISTING_PK` is `FALSE`). If set to `TRUE`, any record being inserted that is rejected for having primary key values that match those of an existing table record will be ignored with no error generated. If `FALSE`, the rejection of any record for having primary key values matching an existing record will result in an error being reported, as determined by `ALLOW_PARTIAL_BATCH` & `RETURN_INDIVIDUAL_ERRORS`. If the specified table does not have a primary key or if upsert mode is in effect (`UPDATE_ON_EXISTING_PK` is `TRUE`), then this option has no effect. Supported values: `TRUE`: Ignore new records whose primary key values collide with those of existing records `FALSE`: Treat as errors any new records whose primary key values collide with those of existing records The default value is `FALSE`. See Also: Constant Field Values RETURN_RECORD_IDS public static final String RETURN_RECORD_IDS If `TRUE` then return the internal record id along for each inserted record. Supported values: `TRUE` `FALSE` The default value is `FALSE`. See Also: Constant Field Values TRUNCATE_STRINGS public static final String 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: `TRUE` `FALSE` The default value is `FALSE`. See Also: Constant Field Values RETURN_INDIVIDUAL_ERRORS public static final String 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: `TRUE` `FALSE` The default value is `FALSE`. See Also: Constant Field Values ALLOW_PARTIAL_BATCH public static final String 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: `TRUE` `FALSE` The default value is `FALSE`. See Also: Constant Field Values DRY_RUN public static final String DRY_RUN If set to `TRUE`, no data will be saved and any errors will be returned. Supported values: `TRUE` `FALSE` The default value is `FALSE`. See Also: Constant Field Values Skip navigation links Overview Package Class Use Tree Deprecated Index Help Prev Class Next Class Frames No Frames All Classes Summary: Nested \| Field \| Constr \| Method Detail: Field \| Constr \| Method Copyright © 2025. All rights reserved.