Microsoft Azure Cosmos DB (DocumentDB) Reader Parameters

About Database Connections

Database formats include a Database Connection parameter that defines and stores authentication information. For general information about sharing database connections, please see Using Database Connections.

Note that Database Connection parameters differ slightly, depending on context and/or database format.

Connection

From the Connection parameter in a database format, you can do one of the following:

  • Select an existing, previously defined connection. See the section Reusing a Database Connection in Using Database Connections
  • Select Add Database Connection to define a new connection. See database-specific parameters below, as well as the section Adding a Database Connection in a Workspace in Using Database Connections The new connection can be made visible only to the current user, or can be shared among multiple users.

Database Connection

Select an existing Microsoft Azure Cosmos DB (DocumentDB) database connection, or Add Database Connection...

Add Microsoft Azure Cosmos DB (DocumentDB) Database Connection

To define a new connection from the Connection parameter in a DocumentDB format, see the topic Microsoft Azure Cosmos DB (DocumentDB): Add Database Connection

Collections

Collections correspond to Feature Types in FME. This parameter lets you browse and select Collections for which to generate Feature Types.

The names displayed in the list are the ID values of the Collections.

Document Query Options

Cross-Partition Query

This parameter corresponds to the x-ms-documentdb-query-enablecrosspartition header.

If your query is against a partitioned Collection but does not filter on a Partition Key, you must enable this parameter.

Partition Key

This optional parameter corresponds to the x-ms-documentdb-partitionkey header.

The value will be converted to a JSON array with a single string element if it does not already appear to be one. This is the format required for the header.

Advanced

Features Per Request

DocumentDB paginates query results. This parameter specifies the maximum number of Documents (features) that may be returned in each page.

Valid values: 1 to 1000

Default value: 1000

Retries After Throttling

This parameter specifies the maximum number of times to reattempt a request that is rate-limited by DocumentDB. The server performs rate-limiting when the size and frequency of requests exceeds the Collection’s provisioned throughput.

If the request continues to be rate-limited after retrying for the specified number of times, the writer logs a warning and skips the request.

Default: 3

Read Original JSON Document

If this parameter is set to Yes, the complete JSON for each Document is included in the documentdb_json format attribute.

Default: No