17.2. Using the Bigtable Data Store Programmatically¶

17.2.1. Creating a Data Store¶

An instance of a Bigtable data store can be obtained through the normal GeoTools discovery methods, assuming that the GeoMesa code is on the classpath. The Bigtable data store also requires that an hbase-site.xml be located on the classpath; the connection parameters for the Bigtable data store are obtained from this file. For more information, see Connecting to Cloud Bigtable.

Map<String, Serializable> parameters = new HashMap<>;
parameters.put("bigtable.catalog", "geomesa");
org.geotools.data.DataStore dataStore =
    org.geotools.data.DataStoreFinder.getDataStore(parameters);

17.2.2. Bigtable Data Store Parameters¶

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

Parameter	Type	Description
`bigtable.catalog *`	String	The name of the GeoMesa catalog table (previously `bigtable.table.name`)
`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.