Detailed Description

Read Policy

Definition at line 561 of file as_policy.h.

#include "as_policy.h"

Collaboration diagram for as_policy_read:

Data Fields
bool	async_heap_rec

as_policy_base	base

bool	deserialize

as_policy_key	key

as_policy_read_mode_ap	read_mode_ap

as_policy_read_mode_sc	read_mode_sc

int	read_touch_ttl_percent

as_policy_replica	replica

Related Symbols
(Note that these are not member symbols.)
static void	as_policy_read_copy (const as_policy_read src, as_policy_read trg)

static as_policy_read *	as_policy_read_init (as_policy_read *p)

Friends And Related Symbol Documentation

◆ as_policy_read_copy()

static void as_policy_read_copy	(	const as_policy_read *	src,
		as_policy_read *	trg )

Parameters

src	The source policy.
trg	The target policy.

Definition at line 1711 of file as_policy.h.

◆ as_policy_read_init()

static as_policy_read * as_policy_read_init ( as_policy_read * p )

Parameters

p	The policy to initialize.

Returns: The initialized policy.

Definition at line 1689 of file as_policy.h.

References as_policy_base_read_init(), AS_POLICY_KEY_DEFAULT, AS_POLICY_READ_MODE_AP_DEFAULT, AS_POLICY_READ_MODE_SC_DEFAULT, AS_POLICY_REPLICA_DEFAULT, async_heap_rec, base, deserialize, key, read_mode_ap, read_mode_sc, read_touch_ttl_percent, and replica.

Field Documentation

◆ async_heap_rec

bool as_policy_read::async_heap_rec

Should as_record instance be allocated on the heap before user listener is called in async commands. If true, the user is responsible for calling as_record_destroy() when done with the record. If false, as_record_destroy() is automatically called by the client after the user listener function completes. This field is ignored for sync commands.

Default: false

Definition at line 627 of file as_policy.h.

◆ base

as_policy_base as_policy_read::base

Generic policy fields.

Definition at line 566 of file as_policy.h.

◆ deserialize

bool as_policy_read::deserialize

Should raw bytes representing a list or map be deserialized to as_list or as_map. Set to false for backup programs that just need access to raw bytes.

Default: true

Definition at line 617 of file as_policy.h.

◆ key

as_policy_key as_policy_read::key

Specifies the behavior for the key.

Definition at line 571 of file as_policy.h.

◆ read_mode_ap

as_policy_read_mode_ap as_policy_read::read_mode_ap

Read policy for AP (availability) namespaces. Default: AS_POLICY_READ_MODE_AP_ONE

Definition at line 582 of file as_policy.h.

◆ read_mode_sc

as_policy_read_mode_sc as_policy_read::read_mode_sc

Read policy for SC (strong consistency) namespaces. Default: AS_POLICY_READ_MODE_SC_SESSION

Definition at line 588 of file as_policy.h.

◆ read_touch_ttl_percent

int as_policy_read::read_touch_ttl_percent

Determine how record TTL (time to live) is affected on reads. When enabled, the server can efficiently operate as a read-based LRU cache where the least recently used records are expired. The value is expressed as a percentage of the TTL sent on the most recent write such that a read within this interval of the record’s end of life will generate a touch.

For example, if the most recent write had a TTL of 10 hours and read_touch_ttl_percent is set to 80, the next read within 8 hours of the record's end of life (equivalent to 2 hours after the most recent write) will result in a touch, resetting the TTL to another 10 hours.

Values:

0 : Use server config default-read-touch-ttl-pct for the record's namespace/set.
-1 : Do not reset record TTL on reads.
1 - 100 : Reset record TTL on reads when within this percentage of the most recent write TTL.

Default: 0

Definition at line 609 of file as_policy.h.

◆ replica

as_policy_replica as_policy_read::replica

Algorithm used to determine target node.

Definition at line 576 of file as_policy.h.

The documentation for this struct was generated from the following file:

as_policy.h