ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Deployments
    • Cloud
    • Server
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
    • Supported Driver Versions
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Install
Search Ask AI
ScyllaDB Docs ScyllaDB Node.js Driver API Reference Classes ExecutionOptions

ExecutionOptions¶

ExecutionOptions()

A base class that represents a wrapper around the user provided query options with getter methods and proper default values.

Note that getter methods might return undefined when not set on the query options or default Client options.

Constructor¶

new ExecutionOptions()

Creates a new instance of ExecutionOptions.

Source

execution-options.js, line 19

Methods¶

(abstract) getCaptureStackTrace() → {Boolean}

Determines if the stack trace before the query execution should be maintained.

Source

execution-options.js, line 65

Returns:
Type
Boolean

(abstract) getConsistency() → {Number}

Gets the Consistency level to be used for the execution.

Source

execution-options.js, line 72

Returns:
Type
Number

(abstract) getCustomPayload() → {Object}

Key-value payload to be passed to the server. On the server side, implementations of QueryHandler can use this data.

Source

execution-options.js, line 80

Returns:
Type
Object

(abstract) getFetchSize() → {Number}

Gets the amount of rows to retrieve per page.

Source

execution-options.js, line 87

Returns:
Type
Number

getFixedHost() → {Host}

When a fixed host is set on the query options and the query plan for the load-balancing policy is not used, it gets the host that should handle the query.

Source

execution-options.js, line 94

Returns:
Type
Host

(abstract) getHints() → {Array|Array:.<Array:>}

Gets the type hints for parameters given in the query, ordered as for the parameters.

Source

execution-options.js, line 101

Returns:
Type
Array | Array:.<Array:>

(abstract) getKeyspace() → {String}

Gets the keyspace for the query when set at query options level.

Note that this method will return undefined when the keyspace is not set at query options level. It will only return the keyspace name when the user provided a different keyspace than the current Client keyspace.

Source

execution-options.js, line 159

Returns:
Type
String

getLoadBalancingPolicy() → {LoadBalancingPolicy}

Gets the load balancing policy used for this execution.

Source

execution-options.js, line 165

Returns:

A LoadBalancingPolicy instance, it can't be undefined.

Type
LoadBalancingPolicy

(abstract) getPageState() → {Buffer}

Gets the Buffer representing the paging state.

Source

execution-options.js, line 179

Returns:
Type
Buffer

getRawQueryOptions() → {QueryOptions}

Gets the query options as provided to the execution method without setting the default values.

Source

execution-options.js, line 192

Returns:
Type
QueryOptions

(abstract) getReadTimeout() → {Number}

Gets the timeout in milliseconds to be used for the execution per coordinator.

A value of 0 disables client side read timeout for the execution. Default: undefined.

Source

execution-options.js, line 201

Returns:
Type
Number

(abstract) getRetryPolicy() → {RetryPolicy}

Gets the retry policy to be used.

Source

execution-options.js, line 208

Returns:

A RetryPolicy instance, it can't be undefined.

Type
RetryPolicy

(abstract) getRoutingKey() → {Buffer|Array:.<Buffer:>}

Gets the partition key(s) to determine which coordinator should be used for the query.

Source

execution-options.js, line 237

Returns:
Type
Buffer | Array:.<Buffer:>

(package) getRustOptions() → {_rust.QueryOptionsWrapper}

Get this options as rust wrapper.

Source

execution-options.js, line 46

Returns:
Type
_rust.QueryOptionsWrapper

(abstract) getSerialConsistency() → {Number}

Gets the the consistency level to be used for the serial phase of conditional updates.

Source

execution-options.js, line 252

Returns:
Type
Number

(abstract) getTimestamp() → {Number|Long|undefined|null}

Gets the provided timestamp for the execution in microseconds from the unix epoch (00:00:00, January 1st, 1970).

When a timestamp generator is used, this method returns undefined.

Source

execution-options.js, line 261

Returns:
Type
Number | Long | undefined | null

(abstract) isAutoPage() → {Boolean}

Determines whether the driver must retrieve the following result pages automatically.

This setting is only considered by the Client#eachRow() method.

Source

execution-options.js, line 110

Returns:
Type
Boolean

(abstract) isBatchCounter() → {Boolean}

Determines whether its a counter batch. Only valid for Client#batch(), it will be ignored by other methods.

Source

execution-options.js, line 118

Returns:

A Boolean value, it can't be undefined.

Type
Boolean

(abstract) isBatchLogged() → {Boolean}

Determines whether the batch should be written to the batchlog. Only valid for Client#batch(), it will be ignored by other methods.

Source

execution-options.js, line 126

Returns:

A Boolean value, it can't be undefined.

Type
Boolean

(abstract) isIdempotent() → {Boolean}

Determines whether the query can be applied multiple times without changing the result beyond the initial application.

Source

execution-options.js, line 134

Returns:
Type
Boolean

(abstract) isPaged() → {boolean}

Determines if the query should be paged.

Source

execution-options.js, line 172

Returns:
Type
boolean

(abstract) isPrepared() → {Boolean}

Determines whether the query must be prepared beforehand.

Source

execution-options.js, line 141

Returns:

A Boolean value, it can't be undefined.

Type
Boolean

(abstract) isQueryTracing() → {Boolean}

Determines whether query tracing is enabled for the execution.

Source

execution-options.js, line 148

Returns:
Type
Boolean

(package) wrapOptionsIfNotWrappedYet()

Creates rust options wrapper for this execution options unless it already exists. Goal of this function is to avoid wrapping the same options multiple times.

Source

execution-options.js, line 35

Was this page helpful?

PREVIOUS
EncoderMembers
NEXT
ExecutionProfile
  • Create an issue
  • Edit this page

On this page

  • ExecutionOptions
    • Constructor
    • Methods
ScyllaDB Node.js Driver
Search Ask AI
  • main
    • main
  • API Reference
    • Modules
      • auth
        • AuthProvider
        • Authenticator
        • PlainTextAuthProvider
      • concurrent
      • datastax
      • errors
        • ArgumentError
        • AuthenticationError
        • BusyConnectionError
        • DriverInternalError
        • NoHostAvailableError
        • NotSupportedError
        • OperationTimedOutError
        • ResponseError
      • geometry
      • mapping
        • DefaultTableMappings
        • Mapper
        • ModelBatchItem
        • ModelMapper
        • Result
        • UnderscoreCqlToCamelCaseMappings
        • TableMappings
      • metadata
        • Aggregate
        • ClientState
        • ColumnMetadata
        • Index
        • KeyspaceMetadata
        • MaterializedView
        • Metadata
        • SchemaFunction
        • Strategy
        • TableMetadata
        • UdtField
        • UserDefinedType
      • metrics
        • DefaultMetrics
        • ClientMetrics
      • policies
        • addressResolution
          • AddressTranslator
          • EC2MultiRegionTranslator
          • MappingAddressTranslator
        • loadBalancing
          • AllowListPolicy
          • DCAwareRoundRobinPolicy
          • DefaultLoadBalancingPolicy
          • LegacyDefaultLoadBalancingPolicy
          • LoadBalancingConfig
          • LoadBalancingPolicy
          • RoundRobinPolicy
          • TokenAwarePolicy
        • reconnection
          • ConstantReconnectionPolicy
          • ExponentialReconnectionPolicy
          • ReconnectionPolicy
        • retry
          • FallthroughRetryPolicy
          • RetryPolicy
        • speculativeExecution
          • ConstantSpeculativeExecutionPolicy
          • NoSpeculativeExecutionPolicy
          • SpeculativeExecutionPolicy
        • timestampGeneration
          • MonotonicTimestampGenerator
          • TimestampGenerator
      • tracker
        • RequestLogger
        • RequestTracker
      • types
        • Duration
        • InetAddress
        • Integer
        • LocalDate
        • Long
        • ResultSet
        • ResultStream
        • Row
        • TimeUuid
        • Vector
    • Classes
      • AddressResolver
      • ByteOrderedToken
      • Client
      • Encoder
      • EncoderMembers
      • ExecutionOptions
      • ExecutionProfile
      • FrameReader
      • HashSet
      • Host
      • HostMap
      • LineString
      • Murmur3Token
      • Point
      • Polygon
      • PreparedInfo
      • RandomToken
      • SslOptions
      • Token
      • TokenRange
    • Interfaces
    • Events
    • Global Functions and Constants
Docs Tutorials University Contact Us About Us
© 2026 ScyllaDB | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 14 May 2026.
Powered by Sphinx 9.1.0 & ScyllaDB Theme 1.9.2