Link Search Menu Expand Document

VerticaBulkImportIdentityBehavior


This enum defines the behavior of the identity property/column when an entity is bulk-imported into a target table. It applies only to Vertica.

Enum Values

NameDescription
KeepIdentityThe value of the identity property/column will be kept and used. (This is the default value)
ReturnIdentityThe newly generated identity value from the target table will be set back to the entity.

There is no Unspecified state — this enum defaults straight to KeepIdentity, the same shape as Db2BulkImportIdentityBehavior and FirebirdBulkImportIdentityBehavior.

Usability

This enum is used by both the BulkInsert and BulkMerge operations of RepoDb.Vertica.BulkOperations. Pass the value to the identityBehavior argument when calling the operation.

For BulkInsert:

using (var connection = new VerticaConnection(connectionString))
{
    var people = GetPeople(1000);
    var insertedRows = connection.BulkInsert(people,
        identityBehavior: VerticaBulkImportIdentityBehavior.ReturnIdentity);
}

For BulkMerge:

using (var connection = new VerticaConnection(connectionString))
{
    var people = GetPeople(1000);
    var mergedRows = connection.BulkMerge(people,
        identityBehavior: VerticaBulkImportIdentityBehavior.ReturnIdentity);
}