Interface IExecutionProfile

An execution profile. See the documentation of WithExecutionProfiles(Action<IExecutionProfileOptions>) for an explanation on how to create these profiles and add them to the cluster.

You can use these profiles via their name (that is set when adding them to the cluster through WithExecutionProfiles(Action<IExecutionProfileOptions>)) with the multiple driver APIs that execute requests (LINQ, Mapper and Session). Example with ExecuteAsync(IStatement, string):

var rowSet = await session.ExecuteAsync(new SimpleStatement("SELECT * FROM keyspace.table"), "profile1").ConfigureAwait(false);

Namespace: Cassandra

Assembly: Cassandra.dll

Syntax

public interface IExecutionProfile

Properties

ConsistencyLevel

Retrieves the ConsistencyLevel set on this profile. It's

null

if not set.

See ConsistencyLevel for additional context on this setting.

Declaration

ConsistencyLevel? ConsistencyLevel { get; }

Property Value

Type	Description
ConsistencyLevel?

GraphOptions

Retrieves the DSE Graph options set on this profile.

See GraphOptions for additional information on the settings within the GraphOptions class.

Declaration

GraphOptions GraphOptions { get; }

Property Value

Type	Description
GraphOptions

LoadBalancingPolicy

Retrieves the LoadBalancingPolicy set on this profile. It's

null

if not set.

See ILoadBalancingPolicy for additional context on this setting.

Declaration

ILoadBalancingPolicy LoadBalancingPolicy { get; }

Property Value

Type	Description
ILoadBalancingPolicy

ReadTimeoutMillis

The per-host read timeout in milliseconds.

This defines how long the driver will wait for a given Cassandra node to answer a query.

Please note that this is not the maximum time a call to Execute(string) may block; this is the maximum time that call will wait for one particular Cassandra host, but other hosts will be tried if one of them timeout. In other words, a Execute(string) call may theoretically wait up to ReadTimeoutMillis * {number_of_cassandra_hosts} (though the total number of hosts tried for a given query also depends on the LoadBalancingPolicy in use). Also note that for efficiency reasons, this read timeout is approximate, it may fire up to late. It is not meant to be used for precise timeout, but rather as a protection against misbehaving Cassandra nodes.

Declaration

int? ReadTimeoutMillis { get; }

Property Value

Type	Description
int?

RetryPolicy

Retrieves the RetryPolicy set on this profile. It's

null

if not set.

See RetryPolicy for additional context on this setting.

Declaration

IExtendedRetryPolicy RetryPolicy { get; }

Property Value

Type	Description
IExtendedRetryPolicy

SerialConsistencyLevel

Retrieves the SerialConsistencyLevel set on this profile. It's

null

if not set.

See ConsistencyLevel for additional context on this setting.

Declaration

ConsistencyLevel? SerialConsistencyLevel { get; }

Property Value

Type	Description
ConsistencyLevel?

SpeculativeExecutionPolicy

Retrieves the SpeculativeExecutionPolicy set on this profile. It's

null

if not set.

See ISpeculativeExecutionPolicy for additional context on this setting.

Declaration

ISpeculativeExecutionPolicy SpeculativeExecutionPolicy { get; }

Property Value

Type	Description
ISpeculativeExecutionPolicy