21.3. FileSystem Data Store Parameters¶

Use the following parameters for a FileSystem data store (required parameters are marked with *):

Parameter	Type	Description
`fs.path *`	String	The root path to write and read data from (e.g. `s3a://mybucket/datastores/testds`)
`fs.catalog.type`	String	A convenience method for specifying the Iceberg catalog `type`. See FileSystem Metadata for details
`fs.config.properties`	String	Storage configuration properties, in Java properties format. See FileSystem DataStore Configuration and FileSystem Metadata for available properties. Environment variables in property values will be interpolated using `${...}` syntax
`fs.config.file`	String	The name of a file containing storage configuration properties, in Java properties format. See FileSystem DataStore Configuration and FileSystem Metadata for available properties. Environment variables in property values will be interpolated using `${...}` syntax
`fs.writer.partitions.max.open`	Int	When writing to multiple partitions at once, this restricts the maximum number of partition files to hold open at one time, per writer, defaults to `32`
`geomesa.query.threads`	Int	The number of threads used for each query, defaults to `4`
`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.security.auths`	String	Comma-delimited superset of authorizations that will be used for queries. See Reading Visibility Labels for details
`geomesa.security.auth-provider`	String	Class name for an `AuthorizationsProvider` implementation

21.3.1. Programmatic Access¶

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

Map<String, String> parameters = Map.of(
  "fs.path", "hdfs://localhost:9000/fs-root/",
  "fs.catalog.type", "rest"
);
org.geotools.api.data.DataStore dataStore =
    org.geotools.api.data.DataStoreFinder.getDataStore(parameters);

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