mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-25 23:47:17 +00:00
ff1d000d99
* instance profile support for dynomodb * updated setup machine script for ec2 * s3 * use EC2/ECS Instance Metadata Service * using @aws-sdk/credential-providers * s3 connection from ec2 instance sucess 🚀 * fixes: aws ses email service * ses connection from ec2 instance sucess 🚀 * athena connection from ec2 instance sucess 🚀 * reverting athena changes * select IAM auth option from the dropdown * added docs * Update setup_machine.sh * clean up
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
---
|
|
id: dynamodb
|
|
title: DynamoDB
|
|
---
|
|
|
|
# DynamoDB
|
|
|
|
ToolJet can connect to DynamoDB to read and write data.
|
|
|
|
## Connection
|
|
|
|
To add a new DynamoDB, click on the `+` button on data sources panel at the left-bottom corner of the app editor. Select DynamoDB from the modal that pops up.
|
|
|
|
ToolJet supports connecting to DynamoDB using **IAM credentials** or **AWS Instance Profile**. If you are using *IAM credentials*, you will need to provide the following details:
|
|
|
|
ToolJet requires the following to connect to your DynamoDB.
|
|
|
|
- **Region**
|
|
- **Access key**
|
|
- **Secret key**
|
|
|
|
It is recommended to create a new IAM user for the database so that you can control the access levels of ToolJet.
|
|
|
|
To connect to DynamoDB using *AWS Instance Profile*, select the **Use AWS Instance Profile**. This will use the IAM role attached to the EC2 instance where ToolJet is running.
|
|
To access the metadata service of an ECS container and the EC2 instance, we use the WebIdentityToken parameter which is obtained from a successful login with an identity provider.
|
|
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/dynamo-connect.png" alt="ToolJet - Dynamo connection" height="250"/>
|
|
|
|
|
|
Click on 'Test connection' button to verify if the credentials are correct and that the database is accessible to ToolJet server. Click on 'Save' button to save the data source.
|
|
|
|
## Querying DynamoDB
|
|
|
|
Click on `+` button of the query manager at the bottom panel of the editor and select the database added in the previous step as the data source. Select the operation that you want to perform and click 'Save' to save the query.
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/dynamo-query.png" alt="ToolJet - Dynamo query" height="250"/>
|
|
|
|
|
|
Click on the 'run' button to run the query. NOTE: Query should be saved before running.
|
|
|
|
:::tip
|
|
Query results can be transformed using transformations. Read our transformations documentation to see how: [link](/docs/tutorial/transformations)
|
|
:::
|