config

Synopsis

config().option(<arg>).[ set(value) | unset(value) | get() | exists() | describe() ]

Description

Schema configuration is only available for Classic Graph, and is deprecated in DataStax Graph 6.8.

Schema can be configured per graph using the config().option(<arg>) command. An option and value can be set() or unset(). An option’s value can be retrieved with the get() command. Whether or not the option is configured can be discovered with the exists() command. The describe() command returns a value if the option has been set manually.

Examples

Set the current graph to use the Development schema_mode:

schema.config().option('graph.schema_mode').set('Development')

Set the current graph to allow full graph scans in the currently aliased graph:

schema.config().option('graph.allow_scan').set('TRUE')

To set restrict_lambda to false in order to test lambda functions (only appropriate for non-production systems):

schema.config().option('graph.traversal_sources.g.restrict_lambda').set('FALSE')

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

schema.config().option('graph.traversal_sources.*.type').get()

resulting in a list of values for the option that have been manually set:

REAL_TIME

indicating that a real-time evaluation timeout is set.

To verify that user-defined vertex ids exist during data loading, set the external_vertex_verify() option:

schema.config().option('graph.tx_groups.default.external_vertex_verify').set('TRUE')

If this setting is true, then a vertex will not be returned if it doesn’t exist. However, if external_vertex_verify() is set to false, then a vertex will be returned even if the vertex does not exist given an id. Applications should ensure that vertices exist using the exists() method for expected behavior. The internal_vertex_verify() setting is similarly used for auto-generated vertex ids.

Set the default write consistency for all transactions to ALL in the currently aliased graph:

schema.config().option('graph.tx_groups.default.write_consistency').set('ALL')

Get the current write consistency for all transactions in the currently aliased graph:

schema.config().option('graph.tx_groups.default.write_consistency').get()

To confirm that an option setting has been set manually, use the exists() command:

schema.config().option('graph.tx_groups.default.write_consistency').exists()

This command will return:

true

if the setting has been set to a value, otherwise it returns false.

To enable CQL tracing during traversal query profiling, set the deep_profiling() option:

schema.config().option('graph.tx_groups.default.deep_profiling').set('TRUE')

To retrieve a list of configuration options that have been set, use the describe() command:

schema.config().describe()

resulting in a list of all options that have been manually set:

==>graph.schema_mode: Development
graph.allow_scan: true
graph.tx_groups.*.write_consistency: ALL
graph.default_property_key_cardinality: Multiple

If any options have been set in the dse.yaml file , use the schema.getEffective* commands instead of the describe command.

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