mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-22 22:17:55 +00:00
2a9c638b9d
* [docs]: Update data-sources guides - Clickhouse, CosmosDB, CouchDB * Added padding before h2 * Updated clickhouse v2 * Updated cosmosdb v2 * Updated CouchDB v2
128 lines
3.7 KiB
Markdown
128 lines
3.7 KiB
Markdown
---
|
|
id: cosmosdb
|
|
title: 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'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/cosmosdb-connect-v2.png" alt="ToolJet - Data source - CosmosDB"/>
|
|
|
|
</div>
|
|
|
|
<div style={{paddingTop:'24px'}}>
|
|
|
|
## Querying CosmoDB
|
|
|
|
1. Click on **+ Add** button of the query manager at the bottom panel of the editor.
|
|
2. Select the **CosmoDB** datasource added in previous step.
|
|
3. Select the operation you want to perform and enter the query.
|
|
4. Click on the **Preview** button to preview the output or Click on the **Run** button to create and trigger the query.
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/operations.png" alt="ToolJet - Data source - CosmosDB"/>
|
|
|
|
</div>
|
|
|
|
<div style={{paddingTop:'24px'}}>
|
|
|
|
## Supported Queries
|
|
|
|
- **[List databases](#list-databases)**
|
|
- **[List containers](#list-containers)**
|
|
- **[Insert items](#insert-items)**
|
|
- **[Read item](#read-item)**
|
|
- **[Delete item](#delete-item)**
|
|
- **[Query database](#query-database)**
|
|
|
|
### List Databases
|
|
|
|
This query lists all the databases in a Cosmos DB.
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/listDatabase.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
### List Containers
|
|
|
|
This query lists all the containers of a database in a Cosmos DB.
|
|
|
|
#### Required Parameter
|
|
- **Database**
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/listContainers.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
### Insert Items
|
|
|
|
This query inserts one or more items in a container of a database in a Cosmos DB.
|
|
|
|
#### Required Parameter
|
|
- **Database**
|
|
- **Container**
|
|
- **Items**
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/insertItems.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
#### Example
|
|
|
|
```yaml
|
|
{
|
|
"id": "123",
|
|
"product": "Laptop",
|
|
"price": 1200,
|
|
"customer_id": "C001"
|
|
}
|
|
```
|
|
|
|
### Read Item
|
|
|
|
To read a single item from a container of a database in a Cosmos DB, use the following query.
|
|
|
|
#### Required Parameter
|
|
- **Database**
|
|
- **Container**
|
|
- **Item ID**
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/readItem.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
### Delete Item
|
|
|
|
To delete an item from a container of a database in a Cosmos DB, use the following query.
|
|
|
|
#### Required Parameter
|
|
- **Database**
|
|
- **Container**
|
|
- **Item ID**
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/deleteItem.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
### Query Database
|
|
|
|
To query documents from a container of a database in a Cosmos DB using SQL-like syntax, use the following query.
|
|
|
|
#### Required Parameter
|
|
- **Database**
|
|
- **Container**
|
|
- **Query**
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/cosmosdb/queryDatabase.png" alt="ToolJet - Data source - CosmosDB" style={{marginBottom:'15px'}}/>
|
|
|
|
#### Example
|
|
```yaml
|
|
SELECT * FROM c WHERE c.age > 20 AND c.age <= 30
|
|
```
|
|
|
|
</div>
|