mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-24 23:17:38 +00:00
bdfe3270e2
* docs: jira * docs: formatting + Client Credentials grant type * docs: connection string pgsql * docs: parameterized queries mysql * docs: parameterized queries in PostgreSQL * docs: update mysql example * docs: TJDB sql editor * docs: add metadata to REST API * docs: add, update postgresql media * docs: add metadata to graphql * docs: update parameterized queries * docs: add parameterized queries for mssql * docs: add SSL Cert to mysql * docs: TJDB SQL restricted commands * docs: update JIRA token location * docs: update delete issue example * docs: update find user by query example * docs: remove session id from get assignable users * docs: use correct image for get issues for board * docs: update create issue example * docs: update delete issue media * docs: update assignable users media * docs: update examples * docs: update key desc * docs: v2.68.0-Beta
90 lines
3.2 KiB
Markdown
90 lines
3.2 KiB
Markdown
---
|
|
id: cosmosdb
|
|
title: CosmosDB
|
|
---
|
|
|
|
# Cosmosdb
|
|
|
|
ToolJet can connect to CosmosDB databases to read and write data.
|
|
|
|
## Connection
|
|
|
|
To establish a connection with the CosmosDB data source, you can either click on the `+Add new data source` button located on the query panel or navigate to the **[Data Sources](/docs/data-sources/overview)** page through the ToolJet dashboard.
|
|
|
|
ToolJet requires the following to connect to your Cosmos DB.
|
|
|
|
- **Cosmos DB Account End point**
|
|
- **Cosmos DB Account Key**
|
|
|
|
:::info
|
|
**Azure Cosmos DB End point** is the URL of the Cosmos DB service.
|
|
**Azure Cosmos DB Key** is the key that is used to access the Cosmos DB service.
|
|
You can find the endpoint and key in the **[Azure Portal](https://portal.azure.com/)**.
|
|
:::
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
## Supported Queries:
|
|
|
|
- [Listing databases](#listing-databases)
|
|
- [Listing containers](#listing-containers)
|
|
- [Inserting item(s)](#inserting-items)
|
|
- [Retrieving an item](#retrieving-an-item)
|
|
- [Deleting an item](#deleting-an-item)
|
|
- [Querying documents](#querying-documents)
|
|
|
|
### Listing Databases
|
|
|
|
This query lists all the databases in a Cosmos DB.
|
|
|
|
### Listing Containers
|
|
|
|
This query lists all the containers of a database in a Cosmos DB.
|
|
|
|
| Fields | Description |
|
|
| -------- | ------------------ |
|
|
| database | id of the database |
|
|
|
|
### Inserting Item(s)
|
|
|
|
This query inserts one or more items in a container of a database in a Cosmos DB.
|
|
|
|
| Fields | Description |
|
|
| --------- | ---------------------------------------------------------------------------------- |
|
|
| database | id of the database |
|
|
| container | id of the container |
|
|
| items | items to be inserted. Example: `{{[{name: "one", val: 1}, {name:"two", val: 2}]}}` |
|
|
|
|
### Retrieving An Item
|
|
|
|
To read a single item from a container of a database in a Cosmos DB, use the following query.
|
|
|
|
| Fields | Description |
|
|
| --------- | ------------------- |
|
|
| database | id of the database |
|
|
| container | id of the container |
|
|
| item | id of the item |
|
|
|
|
### Deleting An Item
|
|
|
|
To delete an item from a container of a database in a Cosmos DB, use the following query.
|
|
|
|
| Fields | Description |
|
|
| --------- | ------------------- |
|
|
| database | id of the database |
|
|
| container | id of the container |
|
|
| item | id of the item |
|
|
|
|
### Querying Documents
|
|
|
|
To query documents from a container of a database in a Cosmos DB using SQL-like syntax, use the following query.
|
|
|
|
| Fields | Description |
|
|
| --------- | --------------------------------------------------------------------------------- |
|
|
| database | id of the database |
|
|
| container | id of the container |
|
|
| query | query to be executed. Example: `SELECT * FROM c WHERE c.age > 20 AND c.age <= 30` |
|