C API  19.3.0
Oracle NoSQL Database C Client
Durability

Functions

kv_durability_t kv_create_durability (kv_sync_policy_enum master, kv_sync_policy_enum replica, kv_ack_policy_enum ack)
 Creates a durability policy, which is then used for store write operations. More...
 
kv_sync_policy_enum kv_get_durability_master_sync (kv_durability_t durability)
 Returns the sync policy in use by the Master for the given durability policy. More...
 
kv_sync_policy_enum kv_get_durability_replica_sync (kv_durability_t durability)
 Returns the sync policy in use by the replicas for the given durability policy. More...
 
kv_ack_policy_enum kv_get_durability_replica_ack (kv_durability_t durability)
 Returns the acknowledgement policy in use for the given durability policy. More...
 

Detailed Description

Durability policies are used with write operations to manage how likely your data writes are to persist in the event of a catastrophic failure, be it in your hardware or software layers. By default, your writes are highly durable. So managing durability policies is mostly about relaxing your durability guarantees in an effort to improve your write throughput.

Function Documentation

kv_durability_t kv_create_durability ( kv_sync_policy_enum  master,
kv_sync_policy_enum  replica,
kv_ack_policy_enum  ack 
)

Creates a durability policy, which is then used for store write operations.

Parameters
[in]masterThe synchronization policy in effect for the master in this replication group for this durability guarantee.
[in]replicaThe synchronization policy in effect for the replicas in this replication group for this durability guarantee.
[in]ackThe acknowledgement policy to be used for this durability guarantee.
Returns
The durability policy.
kv_sync_policy_enum kv_get_durability_master_sync ( kv_durability_t  durability)

Returns the sync policy in use by the Master for the given durability policy.

Parameters
[in]durabilityThe durability policy to be examined.
Returns
The sync policy in use by the Master.
kv_ack_policy_enum kv_get_durability_replica_ack ( kv_durability_t  durability)

Returns the acknowledgement policy in use for the given durability policy.

Parameters
[in]durabilityThe durability policy to be examined.
Returns
The acknowledgement policy.
kv_sync_policy_enum kv_get_durability_replica_sync ( kv_durability_t  durability)

Returns the sync policy in use by the replicas for the given durability policy.

Parameters
[in]durabilityThe durability policy to be examined.
Returns
The sync policy in use by the replicas.