Execution profiles

Execution profiles allows a single session to run different types of query workloads, each with its own settings.

An execution profile encapsulates a group of settings that you can associate with individual queries. This provides a convenient way to group queries based on the settings such as the following:

  • Request timeout

  • Consistency level

  • Load balancing policy

  • Retry policy

  • Speculative execution policy

The full list of settings depends on your driver implementation.

Use execution profiles

Create, configure, and register an execution profile object by name using the cluster or session objects, depending on the driver.

Then, associate the named execution profile object with a query by providing the name to the query execution method or setting it on a statement object. The method of associating the profile name with the query execution depends on your driver.

For more information, see the following driver documentation on execution policies:

The OSS PHP driver doesn’t support execution profiles.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2025 DataStax | Privacy policy | Terms of use | Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com