IBM Cloudant Reader/Writer
Licensing options for this format begin with FME Professional Edition.
Overview
FME provides read and write access to accounts on Cloudant Servers. FME treats each database in a Cloudant account as a feature type. Within a database, each document is treated as a feature, and each field in a document is treated as an attribute.
Cloudant is a DBaaS (Database as a Service) hosted by IBM Cloudant. Cloudant databases are schema-less, NoSQL document stores that support GeoJSON geometry.
More information about Cloudant can be found at www.cloudant.com.
Format Usage Notes
- Reader: Cloudant is schema-less, so the reader uses the fields from the first feature to establish a schema.
-
Writer: Each Cloudant document has a unique Object ID. This ID can be specified on a feature with an attribute selected in the Writer Feature Type Parameters. If a document with that ID already exists, then the translation will fail.
Reader Overview
The Cloudant reader supports reading multiple databases from the same Cloudant server. Because of this, a separate reader must be created for each Cloudant server.
The databases must be defined in the workspace before they can be read.
Writer Overview
The Cloudant writer stores documents into a database associated with a Cloudant server. The Cloudant writer provides the following capabilities:
Database Creation
The Cloudant writer uses the information within the FME workspace to automatically create Cloudant databases as required. A database will be created when the first input feature is processed. If no features are sent to a feature type, then the corresponding database will not be created.
Database Overwrite
If the Table Handling Format Parameter for a feature type is set to Drop and Create, then the writer will drop and re-create the database before writing any features to it.
Databases will be overwritten when the first input feature is processed. If no features are sent to a feature type, then the corresponding database will not be overwritten.
Format Resources
Cloudant Quick Facts
Cloudant Reader Parameters
Cloudant Writer Parameters
Feature Representation