Generate Compare Pairs using mapped objects
post
http://{host}:{port}/veridata/v1/services/configuration/cps
Required Role: Administrator, SuperUser, CommandLineOperator
Create compare pairs for preview purpose.This will not save the compare pairs in repository.This API doesn't need group ID and hence should be used when compare pairs are to be previewed without mapped to any group.
Request
Query Parameters
- includeColumnMapping: boolean Include column mapping details in payload.
- sourceConnectionId(required): integer(int64) Source Connection ID.
- targetConnectionId(required): integer(int64) Target Connection ID.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source object
Example:
{ "mappedObjectWithOptions":[ { "name":"EMPLOYEE=EMPLOYEE", "srcTable":[ { "name":"EMPLOYEE", "schema":"VERIDATA", "catalog":"ORCL1", "tablePartition":[ { "name":"EMP_2025" } ] } ], "tgtTable":[ { "name":"EMPLOYEE", "schema":"VERIDATA", "catalog":"ORCL1", "tablePartition":[ { "name":"EMP_2025" } ] } ], "profileId":1, "options":[ { "autoPartitionInfo":[ { "autoPartition":true, "autoPartitionNumber":10 } ] } ], "rowPartition":[ { "side":"SOURCE", "name":"employee ID's greater than 100", "whereClause":"ID > 100", "type":"S", "runtime":true }, { "side":"TARGET", "name":"employee ID's greater than 100", "whereClause":"ID > 100", "type":"S", "runtime":true } ], "delta":[ { "srcColumn":"UPDATED_DATE", "tgtColumn":"UPDATED_DATE", "srcDeltaQuery":"select MAX(UPDATED_DATE) from ORCL1.VERIDATA.EMPLOYEE", "tgtDeltaQuery":"select MAX(UPDATED_DATE) from ORCL1.VERIDATA.EMPLOYEE", "srcDeltaCols":[ "UPDATED_DATE, MODIFIED_TS" ], "tgtDeltaCols":[ "UPDATED_DATE, MODIFIED_TS" ], "columnMapping":[ { "useSourceColsAsKeys":true, "useTargetColsAsKeys":true, "useAllColsAsKeys":true } ] } ] } ] }
Nested Schema : MappedObjectWithOptions
Type:
Show Source object
- options: object MappedObjectOptions
- profileId: integer (int64) Default Value:
1
Profile ID.
Match All
Show Source Nested Schema : MappedObjectOptions
Type:
Show Source object
- autoPartitionInfo: object AutoPartitionInfo
- columnMapping: object ColumnMappingPattern
- delta: object DeltaProcessing Defines Delta Setting. For NSK this will be an empty object.
- rowPartition: array rowPartition
- srcEnscribeInfo: array srcEnscribeInfo
- tgtEnscribeInfo: array tgtEnscribeInfo
Nested Schema : MappedObjectRequest
Type:
Show Source object
- name: string Mapping name . Default is source table name = target table name.
- srcTable(required): srcTable Represents a table in compare pair with table and row partitions info, if any.
- tgtTable(required): tgtTable Represents a table in compare pair with table and row partitions info, if any.
Nested Schema : AutoPartitionInfo
Type:
Show Source object
- autoPartition: string Allowed Values:
[ false, true ]
Represents boolean TRUE/FALSE - autoPartitionNumber: integer (int32) Default Value:
10
Nested Schema : ColumnMappingPattern
Type:
Show Source object
- useAllColsAsKeys: boolean Default Value:
true
- useSourceColsAsKeys: boolean Default Value:
true
- useTargetColsAsKeys: boolean Default Value:
true
Nested Schema : DeltaProcessing
Type:
object
Defines Delta Setting. For NSK this will be an empty object.
Show Source - srcColumn: string Delta Source column.
- srcDeltaCols: array srcDeltaCols List of Source Delta columns.
- srcDeltaQuery: string Source Delta query.
- tgtColumn: string Delta Target column.
- tgtDeltaCols: array tgtDeltaCols List of Target Delta columns.
- tgtDeltaQuery: string Target Delta query.
Nested Schema : RowPartitionSide
Type:
Show Source object
- side: string Allowed Values:
[ "SOURCE", "TARGET" ]
SOURCE or TARGET.
Nested Schema : RowPartitionParams
Type:
Show Source object
- endingKey: string Enscribe ending key.
- isAscii: boolean Enscribe is ASCII.
- name(required): string
- runtime: boolean Use at runtime.
- startingKey: string Enscribe starting key.
- type(required): string Allowed Values:
[ "S", "E", "A" ]
Type of Row Partition (SQL{S} , Enscribe{E} , Auto{A}) - whereClause: string SQL Predicate Statement.
Nested Schema : EnscribeAttributeRequest
Type:
Show Source object
- default: boolean
- name: string Allowed Values:
[ "AltKey", "Dictionary", "Record", "ExpandDDLRedefs", "ExpandDDLResolveDupAppend", "ExpandDDLResolveDupPrepend", "ExpandDDLExpandGroupArrays", "ExpandDDLFixLongNames", "ExpandDDLMaxColNameLen", "ExpandDDLSeparator", "ExpandDDLZeroFill" ]
- value: string
Nested Schema : srcTable
Represents a table in compare pair with table and row partitions info, if any.
Match All
Represents a table in compare pair with table and row partitions info, if any.
Represents a table in compare pair with table and row partitions info, if any.
Show Source - object ReqTable Defines a table in request body.
- object srcTable-allOf[1]
Nested Schema : tgtTable
Represents a table in compare pair with table and row partitions info, if any.
Match All
Represents a table in compare pair with table and row partitions info, if any.
Represents a table in compare pair with table and row partitions info, if any.
Show Source - object ReqTable Defines a table in request body.
- object tgtTable-allOf[1]
Nested Schema : ReqTable
Type:
object
Defines a table in request body.
Show Source - catalog: string
- filePattern: string Valid for NSK Enscribe database.
- name: string
- schema: string
- tablePartition: object tablePartition
Nested Schema : srcTable-allOf[1]
Type:
object
Nested Schema : tgtTable-allOf[1]
Type:
object
Response
Supported Media Types
- application/json
200 Response
Compare Pairs created successfully.
Nested Schema : ComparePairInDetailsView
Type:
Show Source object
- columnMappings: array columnMappings
- columnsSystemMapped: boolean Default Value:
true
Is the key columns system mapped. - delta: delta
- deltaProcessingEnabled: boolean Default Value:
false
Delta processing is enabled for this compare pair. - enabled: boolean Default Value:
true
Compare Pair is enabled in the group to run. - keyColumnsSystemMapped: boolean Default Value:
true
Is the key columns system mapped. - profile: profile Profile Object.
- setting: object ComparePairSetting Mapping of a column in a table.
- srcIndexName: string
- srcRowPartitions: array srcRowPartitions
- srcTable: srcTable Represents a table in compare pair with table and row partitions info, if any.
- tgtIndexName: string
- tgtRowPartitions: array tgtRowPartitions
- tgtTable: tgtTable Represents a table in compare pair with table and row partitions info, if any.
- validationStatus: string Allowed Values:
[ "NeverValidated", "Validated" ]
enum for compare pair validation status. - validationTime: string (date-time)
Match All
Show Source Nested Schema : delta
Match All
Show Source - object DeltaProcessing Defines Delta Setting. For NSK this will be an empty object.
Nested Schema : ComparePairSetting
Type:
object
Mapping of a column in a table.
Show Source - compareMethod: string Allowed Values:
[ "Key", "Hash", "Literal" ]
Compare Mapping Type. - exclude: array exclude Array of column names which are excluded.
- keyColsMappingMethod: string Allowed Values:
[ "system", "user" ]
Column Mapping Method. - otherColsMappingMethod: string Allowed Values:
[ "system", "user" ]
Column Mapping Method. - srcIndexType: string Allowed Values:
[ "index", "columns" ]
Source/Target Key Index. - tgtIndexType: string Allowed Values:
[ "index", "columns" ]
Source/Target Key Index. - unmapped: array unmapped Array of column names which are unmapped.
Nested Schema : srcTable
Represents a table in compare pair with table and row partitions info, if any.
Match All
Represents a table in compare pair with table and row partitions info, if any.
Represents a table in compare pair with table and row partitions info, if any.
Show Source - object BasicTable Defines a table.
- object srcTable-allOf[1]
Nested Schema : tgtTable
Represents a table in compare pair with table and row partitions info, if any.
Match All
Represents a table in compare pair with table and row partitions info, if any.
Represents a table in compare pair with table and row partitions info, if any.
Show Source - object BasicTable Defines a table.
- object tgtTable-allOf[1]
Nested Schema : BaseObject_2
Type:
Show Source object
- createdOn: string (date-time) Pattern:
YYYY-MM-DDTHH:mm:ss.sssZ
Example:2024-02-03T10:15:30Z
- id: integer (int64) Object Id.
- name: string Object Name.
- updatedOn: string (date-time) Pattern:
YYYY-MM-DDTHH:mm:ss.sssZ
Example:2024-02-03T10:15:30Z
Nested Schema : ComparePairInDetailsView-allOf[1]
Type:
object
Nested Schema : ColumnMapping
Type:
Show Source object
- compareFormat: string Allowed Values:
[ "string", "string_en", "binary", "timestamp", "timestamp_tz", "date", "time", "datetime", "smalldatetime", "clob", "blob", "Float", "dec_float", "interval", "number", "binary_timestamp", "string_nfc", "clob_nfc", "sybtime", "bit", "Double" ]
Compare Format. - dataType: string
- mappingType: string Allowed Values:
[ "Key", "Hash", "Literal" ]
Compare Mapping Type. - precision: integer (int32) Default Value:
0
- scale: integer (int32) Default Value:
0
- srcColumn: object Column Defines a column.
- supportedCompareFormats: array supportedCompareFormats
- tgtColumn: object Column Defines a column.
- timezone: string
Nested Schema : Column
Type:
object
Defines a column.
Show Source - columnName: string Column Name.
- dataType: string Data type of the column.
- jdbcType: integer (int32) java.sql.Types type number.
- lob: boolean
- precision: integer (int32) Default Value:
0
- scale: integer (int32) Default Value:
0
- timezone: string
- typeNum: integer (int32) internal column type number.
Nested Schema : supportedCompareFormats
Type:
Show Source array
- Array of: string Allowed Values:
[ "string", "string_en", "binary", "timestamp", "timestamp_tz", "date", "time", "datetime", "smalldatetime", "clob", "blob", "Float", "dec_float", "interval", "number", "binary_timestamp", "string_nfc", "clob_nfc", "sybtime", "bit", "Double" ]
Compare Format.
Nested Schema : DeltaProcessing
Type:
object
Defines Delta Setting. For NSK this will be an empty object.
Show Source - srcColumn: string Delta Source column.
- srcDeltaCols: array srcDeltaCols List of Source Delta columns.
- srcDeltaQuery: string Source Delta query.
- tgtColumn: string Delta Target column.
- tgtDeltaCols: array tgtDeltaCols List of Target Delta columns.
- tgtDeltaQuery: string Target Delta query.
Nested Schema : BaseObject_3
Type:
Show Source object
- id: integer (int64) Object Id.
- name: string Object Name.
Nested Schema : profile-allOf[1]
Type:
object
Nested Schema : RowPartitionParams
Type:
Show Source object
- endingKey: string Enscribe ending key.
- isAscii: boolean Enscribe is ASCII.
- name(required): string
- runtime: boolean Use at runtime.
- startingKey: string Enscribe starting key.
- type(required): string Allowed Values:
[ "S", "E", "A" ]
Type of Row Partition (SQL{S} , Enscribe{E} , Auto{A}) - whereClause: string SQL Predicate Statement.
Nested Schema : srcTable-allOf[1]
Type:
object
Nested Schema : tgtTable-allOf[1]
Type:
object
400 Response
Bad Request.
Root Schema : Error
Type:
Show Source object
- errCode: string Veridata Error Code.
- errMsg: string Veridata Error Message.
Example:
{ "errCode":"OGGV-00001", "errMsg":"Error message" }
401 Response
Unauthorized.
Root Schema : Error
Type:
Show Source object
- errCode: string Veridata Error Code.
- errMsg: string Veridata Error Message.
Example:
{ "errCode":"OGGV-00001", "errMsg":"Error message" }
404 Response
Not Found.
Root Schema : Error
Type:
Show Source object
- errCode: string Veridata Error Code.
- errMsg: string Veridata Error Message.
Example:
{ "errCode":"OGGV-00001", "errMsg":"Error message" }
500 Response
Server Error.
Root Schema : Error
Type:
Show Source object
- errCode: string Veridata Error Code.
- errMsg: string Veridata Error Message.
Example:
{ "errCode":"OGGV-00001", "errMsg":"Error message" }