Skip to main content

Setting up CosmosDB

1. Add integration

Select CosmosDB from the integrations page.

2. Configure settings

Fill out the form with the following settings:
SettingRequiredDescription
NameName that will be displayed to users when selecting this integration in Superblocks
HostHostname or IP address to connect to
PortPort to use when connecting to CosmosDB
Database IDID of database to connect to
Master KeyThe Master Key to access the database

3. Test and save

Click Test Connection to check that Superblocks can connect to the data source.

If you’re using Superblocks Cloud, you may need to allowlist Superblocks IP addresses to connect to your database. Learn more about Superblocks IP addresses (not necessary when self-hosting the data plane).

After connecting successfully, click Create to save the integration.

4. Set profiles

Optionally, configure different profiles for separate development environments.
CosmosDB connected!
You can now use Clark to build with CosmosDB.

Creating CosmosDB steps

When using CosmosDB steps, there are 2 options:
  1. SQL queries
  2. Single object actions

SQL queries

Write SQL queries to interact with your CosmosDB instance directly.

Single object actions

Use single object actions to perform CRUD actions on a single object. Pass in an object of data in the Item Body. Actions supported include:
  • Create a single object
  • Read a single object
  • Upsert a single object
  • Replace a single object
  • Delete a single object

Troubleshooting

Check out our guide on common errors across database integrations, in addition to common CosmosDB connection issues. If you are encountering an error that you don’t see in the guide, or the provided steps are insufficient to resolve the error, please contact us at help@superblocks.com.