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.

FME Knowledge Center

Search Cloudant