Specifying DSE database and graph settings

Some DSE Graph options are set on a per-graph basis. The settings are modified and read using either System or Schema API calls in the Gremlin console. These option values are stored in DSE tables and are not set in the dse.yaml file. See the DSG reference for a complete list of traversal options. Other settings for DSG are also in the dse.yamlfile.


Most per-graph options are set using the Schema API.

  • Check all non-default values of configuration settings.

    graph.tx_groups.default.write_consistency: ALL
    graph.tx_groups.default.read_consistency: QUORUM

    Default settings are not displayed with this call.

  • Check the values of a specific setting.

  • Set the value of a configuration setting.

  • To retrieve all traversal sources that have been set, use the get() command with the traversal source type option:

  • Set the maximum time to wait for a traversal to evaluate:


    The timeout values can also be entered in seconds or minutes, as appropriate, using set('1500 ms'), for example.

Setting a timeout value greater than 1095 days (maximum integer) can exceed the limit of a graph session. Starting a new session and setting the timeout to a lower value can recover access to a hung session. This caution is applicable for all timeouts: evaluation_timeout, system_evaluation_timeout, analytic_evaluation_timeout, and realtime_evaluation_timeout.




The dse.yaml file has settings realtime_evaluation_timeout_in_seconds and analytic_evaluation_timeout_in_minutes that determine the timeout value used depending on whether the query is an OLTP or OLAP query, respectively. The command shown above using evaluation_timeoutwill override any system level setting for the traversal source g specified. The hierarchy for OLTP traversals is, in order of override: graph.traversal_sources.g.evaluation_timeout > realtime_evaluation_timeout_in_seconds > system_evaluation_timeout_in_seconds. The hierarchy for OLAP traversal timeout overrides is similar to OLTP: graph.traversal_sources.a.evaluation_timeout > analytic_evaluation_timeout_in_minutes > system_evaluation_timeout_in_seconds.

  • Some options must be set using the System API.

  • Settings can also be set while creating a new graph. For instance, replication for graph inherits DSE database defaults, so the replication factor is set to 1 and the class is SimpleStrategy. As with the DSE database, the replication factor for graph should be set before adding data.

        replication("{'class' : 'NetworkTopologyStrategy', 'dc1' : 3 }").
  • Graph also creates a keyspace for storing graph variables in DSE tables. This keyspace holds essential information, so the replication factor should be set to something higher than one replica to ensure no loss.

    gremlin>  system.graph('gizmo').
        replication("{'class' : 'NetworkTopologyStrategy', 'dc1' : 3 }").
        systemReplication("{'class' : 'NetworkTopologyStrategy', 'dc1' : 3 }").
  • Additional schema settings can be configured at graph creation.

      replication("{'class' : 'SimpleStrategy', 'replication_factor' : 1 }").
      systemReplication("{'class' : 'SimpleStrategy', 'replication_factor' : 1 }").

    More information can be found in the Schema API reference.

  • The Graph API is used to set some transaction settings.

  • The allow_scan option can be set at either a single graph level or as shown here, for all actions within a transaction made on a single node. This setting can be useful if a quorum cannot be mustered for writing the option change to the system table.

    graph.tx().config().option("allow_scan", true).open()

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

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