Cosmos DB Connector

The Azure Cosmos DB connector can be used to connect your Digital Twin instances to a Cosmos database in Microsoft Azure. This enables digital twin instances (both real-time and simulation) to persist and retrieve state properties from corresponding CosmosDB JSON documents.

To connect to a Cosmos DB database, supply a set of credentials for an Azure Cosmos DB account that has permissions to create/access/modify tables and create/read/update/delete items. The Azure credentials are provided through the UI when you create a new Cosmos DB connector and consist of:

• Account URI: the URI to the Azure Cosmos DB account where the containers will be added.

• Primary key: the primary Read-Write key for the Cosmos DB account.

Values for these properties can be found in the Keys section of the Cosmos DB account:

To configure the connection to Cosmos DB, open the ScaleOut Digital Twins™ UI in your web browser and create a new connection:

In addition to the Azure credentials, you can supply the following parameters for the connection:

• Update Interval: The minimum period in seconds between successive updates to a persisted instance after updates to its corresponding digital twins instance. This parameter allows digital twin deployments with high message rates and/or many data sources to coalesce their database updates avoid hitting its resource limits.

• Retrieve State on Create: Specifies whether to retrieve properties from DynamoDB when creating a digital twin instance.

The connector can be deployed immediately upon creation, or it can be deployed later. The connector authenticates with Azure and the Cosmos DB table when deployed.

Note

Instances are persisted in a table named DigitalTwinInstances in a ScaleOutSoftware container. This table will be created when the connector is deployed.