1
- GeoMesa Cassandra / ScyllaDB Quick Start
2
- ========================================
1
+ GeoMesa Cassandra Quick Start
2
+ =============================
3
3
4
- This tutorial is the fastest and easiest way to get started with GeoMesa using Cassandra / ScyllaDB .
4
+ This tutorial is the fastest and easiest way to get started with GeoMesa using Cassandra.
5
5
It is a good stepping-stone on the path to the other tutorials, that present increasingly
6
6
involved examples of how to use GeoMesa.
7
7
@@ -12,9 +12,9 @@ In the spirit of keeping things simple, the code in this tutorial only
12
12
does a few small things:
13
13
14
14
1. Establishes a new (static) SimpleFeatureType
15
- 2. Prepares the Cassandra / ScyllaDB tables to store this type of data
15
+ 2. Prepares the Cassandra tables to store this type of data
16
16
3. Creates a few thousand example SimpleFeatures
17
- 4. Writes these SimpleFeatures to Cassandra / ScyllaDB
17
+ 4. Writes these SimpleFeatures to Cassandra
18
18
5. Queries for a given geographic rectangle, time range, and attribute
19
19
filter, writing out the entries in the result set
20
20
6. Uses GeoServer to visualize the data (optional)
@@ -27,22 +27,22 @@ Before you begin, you must have the following installed and configured:
27
27
- `Java <https://adoptium.net/temurin/releases/ >`__ JDK 1.8
28
28
- Apache `Maven <https://maven.apache.org/ >`__ |maven_version |
29
29
- a GitHub client
30
- - a Cassandra |cassandra_version | instance or a ScyllaDB | scylladb_version | instance , either standalone or cluster
31
- - a Cassandra / ScyllaDB user that has both create-table and write permissions
30
+ - a Cassandra |cassandra_version | instance, either standalone or cluster
31
+ - a Cassandra user that has both create-table and write permissions
32
32
(not needed for standalone instances)
33
33
34
- Create A Cassandra / ScyllaDB Namespace
35
- ---------------------------------------
34
+ Create A Cassandra Namespace
35
+ ----------------------------
36
36
37
- You will need a namespace in Cassandra / ScyllaDB to contain the tutorial tables. The easiest way to do
37
+ You will need a namespace in Cassandra to contain the tutorial tables. The easiest way to do
38
38
this is with the ``cqlsh `` tool provided with Cassandra distributions. Start ``cqlsh ``, then type:
39
39
40
40
.. code-block :: bash
41
41
42
42
cqlsh> CREATE KEYSPACE geomesa WITH REPLICATION = {' class' : ' SimpleStrategy' , ' replication_factor' : 3};
43
43
44
44
This creates a key space called "geomesa". This is a top-level name
45
- space within Cassandra / ScyllaDB and it will provide a place for GeoMesa to put
45
+ space within Cassandra and it will provide a place for GeoMesa to put
46
46
all of its data, including data for spatial features and associated
47
47
metadata.
48
48
@@ -88,20 +88,20 @@ On the command line, run:
88
88
89
89
where you provide the following arguments:
90
90
91
- - ``<host:port> `` the hostname and port your Cassandra / ScyllaDB instance is
92
- running on. For Cassandra / ScyllaDB standalone this will be ``localhost:9042 ``. More
91
+ - ``<host:port> `` the hostname and port your Cassandra instance is
92
+ running on. For Cassandra standalone this will be ``localhost:9042 ``. More
93
93
information on how to find your connection is available
94
- `here <https://www.geomesa.org/documentation/user/cassandra/install.html#connecting-to-cassandra-/-scylladb >`__.
94
+ `here <https://www.geomesa.org/documentation/user/cassandra/install.html#connecting-to-cassandra >`__.
95
95
- ``<keyspace> `` keyspace your table will be put into. If you followed the instructions above,
96
96
this will be ``geomesa ``. More information on how to setup keyspaces is available
97
- `here <https://www.geomesa.org/documentation/user/cassandra/install.html#connecting-to-cassandra-/-scylladb >`__.
97
+ `here <https://www.geomesa.org/documentation/user/cassandra/install.html#connecting-to-cassandra >`__.
98
98
- ``<table> `` the name of the destination table that will
99
99
accept these test records. This table should either not exist or
100
100
should be empty
101
- - ``<user> `` (optional) the name of a Cassandra / ScyllaDB user that has
101
+ - ``<user> `` (optional) the name of a Cassandra user that has
102
102
permissions to create, read and write tables
103
103
- ``<password> `` (optional) the password for the previously-mentioned
104
- Cassandra / ScyllaDB user
104
+ Cassandra user
105
105
106
106
Optionally, you can also specify that the quick start should delete its data upon completion. Use the
107
107
``--cleanup `` flag when you run to enable this behavior.
@@ -256,7 +256,7 @@ Register the GeoMesa Store with GeoServer
256
256
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
257
257
258
258
Log into GeoServer using your user and password credentials. Click
259
- "Stores" and "Add new Store". Select the ``Cassandra / ScyllaDB (GeoMesa) `` vector data
259
+ "Stores" and "Add new Store". Select the ``Cassandra (GeoMesa) `` vector data
260
260
source, and fill in the required parameters.
261
261
262
262
Basic store info:
@@ -269,7 +269,7 @@ Connection parameters:
269
269
270
270
- these are the same parameter values that you supplied on the
271
271
command line when you ran the tutorial; they describe how to connect
272
- to the Cassandra / ScyllaDB instance where your data reside
272
+ to the Cassandra instance where your data reside
273
273
274
274
Click "Save", and GeoServer will search your Cassandra table for any
275
275
GeoMesa-managed feature types.
0 commit comments