ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs Scylla C/C++ Driver API Documentation CassTimestampGen

CassTimestampGen¶

struct CassTimestampGen¶

Policies that defined the behavior of a request when a server-side read/write timeout or unavailable error occurs.

Generators of client-side, microsecond-precision timestamps.

Requires Apache Cassandra: 2.1+

Public Functions

CassTimestampGen *cass_timestamp_gen_server_side_new()¶

Creates a new server-side timestamp generator. This generator allows Cassandra to assign timestamps server-side.

Note: This is the default timestamp generator.

Requires Apache Cassandra: 2.1+

See also

cass_timestamp_gen_free()

Returns:

Returns a timestamp generator that must be freed.

CassTimestampGen *cass_timestamp_gen_monotonic_new()¶

Creates a new monotonically increasing timestamp generator with microsecond precision.

This implementation guarantees a monotonically increasing timestamp. If the timestamp generation rate exceeds one per microsecond or if the clock skews into the past the generator will artificially increment the previously generated timestamp until the request rate decreases or the clock skew is corrected.

By default, this timestamp generator will generate warnings if more than 1 second of clock skew is detected. It will print an error every second until the clock skew is resolved. These settings can be changed by using cass_timestamp_gen_monotonic_new_with_settings() to create the generator instance.

Note: This generator is thread-safe and can be shared by multiple sessions.

Requires Apache Cassandra: 2.1+

See also

cass_timestamp_gen_monotonic_new_with_settings();

See also

cass_timestamp_gen_free()

Returns:

Returns a timestamp generator that must be freed.

void cass_timestamp_gen_free(CassTimestampGen *timestamp_gen)¶

Frees a timestamp generator instance.

Requires Apache Cassandra: 2.1+

Parameters:

timestamp_gen – [in]

Was this page helpful?

PREVIOUS
CassTableMeta
NEXT
CassTuple
  • Create an issue
  • Edit this page

On this page

  • CassTimestampGen
    • CassTimestampGen
      • CassTimestampGen::cass_timestamp_gen_server_side_new()
      • CassTimestampGen::cass_timestamp_gen_monotonic_new()
      • CassTimestampGen::cass_timestamp_gen_free()
Scylla C/C++ Driver
  • master
    • master
  • C/C++ Driver for ScyllaDB
  • API Documentation
    • CassAggregateMeta
    • CassAuthenticator
    • CassAuthenticatorCallbacks
    • CassBatch
    • CassCluster
    • CassCollection
    • CassColumnMeta
    • CassCustomPayload
    • CassDataType
    • CassErrorResult
    • CassExecProfile
    • CassFunctionMeta
    • CassFuture
    • CassIndexMeta
    • CassInet
    • CassIterator
    • CassKeyspaceMeta
    • CassLogMessage
    • CassMaterializedViewMeta
    • CassMetrics
    • CassNode
    • CassPrepared
    • CassResult
    • CassRetryPolicy
    • CassRow
    • CassSchemaMeta
    • CassSession
    • CassSpeculativeExecutionMetrics
    • CassSsl
    • CassStatement
    • CassTableMeta
    • CassTimestampGen
    • CassTuple
    • CassUserType
    • CassUuid
    • CassUuidGen
    • CassValue
    • CassVersion
    • DseDateRange
    • DseDateRangeBound
    • DseLineString
    • DseLineStringIterator
    • DsePolygon
    • DsePolygonIterator
  • Features
    • Basics
      • Batches
      • Binding Parameters
      • Client-side timestamps
      • Consistency
      • Data Types
      • The date and time Types
      • Futures
      • Handling Results
      • Keyspaces
      • Prepared Statements
      • Schema Metadata
      • Tuples
      • User-Defined Types (UDTs)
      • UUIDs
    • Building
    • Client Configuration
    • Cloud
    • Configuration
      • Retry policies
    • Execution Profiles
    • FAQ
    • Installation
    • Logging
    • Metrics
    • Scylla Specific Features
    • Security
      • SSL
    • Testing
      • Cassandra Cluster Manager (CCM)
    • Tracing
  • DSE Features
    • Authentication
    • Geospatial types
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 28 April 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6