16.2. Using the Cassandra DataStore Programmatically

16.2.1. Creating a Data Store

An instance of a Cassandra data store can be obtained through the normal GeoTools discovery methods, assuming that the GeoMesa code is on the classpath.

Map<String, Serializable> parameters = new HashMap<>();
parameters.put("cassandra.contact.point", "127.0.0.1:9142");
parameters.put("cassandra.keyspace", "geomesa");
parameters.put("cassandra.catalog", "mycatalog");
org.geotools.data.DataStore dataStore =
    org.geotools.data.DataStoreFinder.getDataStore(parameters);

16.2.2. Cassandra Data Store Parameters

The data store takes several parameters (required parameters are marked with *):

Parameter	Type	Description
cassandra.catalog *	String	The name of the GeoMesa catalog table (previously geomesa.cassandra.catalog.table)
cassandra.contact.point *	String	The connection point for Cassandra, in the form <host>:<port> - for a default local installation this will be localhost:9042
cassandra.keyspace *	String	The Cassandra keyspace to use (must exist already)
cassandra.username	String	Cassandra user
cassandra.password	String	Cassandra password
geomesa.query.audit	Boolean	Audit queries being run. Queries will be written to a log file
geomesa.query.timeout	String	The max time a query will be allowed to run before being killed. The timeout is specified as a duration, e.g. 1 minute or 60 seconds
geomesa.query.threads	Integer	The number of threads to use per query
geomesa.query.loose-bounding-box	Boolean	Use loose bounding boxes - queries will be faster but may return extraneous results
geomesa.stats.generate	Boolean	Toggle collection of statistics (currently not implemented)
geomesa.query.caching	Boolean	Toggle caching of results

More information on using GeoTools can be found in the GeoTools user guide.