Checkpoint Properties

You cannot write data into a checkpoint after it has been created, but ActiveSpaces provides the ability to query or retrieve data contained in a checkpoint.

ActiveSpaces supports the following properties for checkpoints:

TIBDG_SESSION_PROPERTY_STRING_CHECKPOINT_NAME

The property is set so that a named checkpoint is used as the data source for the session's read operations (GET, Iterator, Queries, or Statements). Write operations (PUT, DELETE) do not support this property.

TIBDG_TABLE_PROPERTY_STRING_CHECKPOINT_NAME

Set this property so that a named checkpoint is used as the data source for the read operations (GET or Iterator) of a table. Write operations (PUT and DELETE) do not support this property. If this property is not set, the table uses the checkpoint name specified on the session, if any. If this property is set, it overrides any checkpoint name set on the session.

TIBDG_GRIDMETADATA_PROPERTY_STRING_CHECKPOINT_NAME

The property is set so that a named checkpoint is used when retrieving metadata for the data grid or tables.

TIBDG_STATEMENT_PROPERTY_STRING_CONSISTENCY

Set this property to TIBDG_STATEMENT_CONSISTENCY_SNAPSHOT when using checkpoints for reading data. Since a checkpoint is already globally consistent, you must not use global consistency when reading or querying with checkpoints.

See the API documentation on the following methods:

  • tibdgConnection_CreateSession
  • tibdgConnection_GetGridMetadata
  • tibdgSession_CreateStatement
  • tibdgTable_CreateIterator
  • tibdgTable_Get

TIBDG_SESSION_CHECKPOINT_NAME_LATEST

Use this special checkpoint name with the TIBDG_SESSION_PROPERTY_STRING_CHECKPOINT_NAME property to refer to the latest successful checkpoint known by the proxy. This name is useful for clients that want to read from the latest checkpoint without knowing the checkpoint name, or for grids that are configured to create periodic checkpoints automatically.

TIBDG_TABLE_CHECKPOINT_NAME_LATEST

Use this special checkpoint name with the TIBDG_TABLE_PROPERTY_STRING_CHECKPOINT_NAME property to refer to the latest successful checkpoint known by the proxy. This property is useful for clients that want to read from the latest checkpoint without knowing the checkpoint name, or for grids that are configured to create periodic checkpoints automatically.