mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-22 22:17:55 +00:00
137 lines
4.2 KiB
Markdown
137 lines
4.2 KiB
Markdown
---
|
|
id: mysql
|
|
title: MySQL
|
|
---
|
|
|
|
ToolJet can connect to MySQL databases to read and write data.
|
|
|
|
<div style={{paddingTop:'24px'}}>
|
|
|
|
## Connection
|
|
|
|
To establish a connection with the MySQL 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.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/mysql/addmysql.gif" alt="MySQL data source"/>
|
|
|
|
</div>
|
|
<br/>
|
|
|
|
:::info
|
|
Please make sure the **Host/IP** of the database is accessible from your VPC if you have self-hosted ToolJet. If you are using ToolJet cloud, please **whitelist** our IP.
|
|
:::
|
|
|
|
**ToolJet requires the following to connect to your MySQL database:**
|
|
|
|
- **Username**
|
|
- **Password**
|
|
- **Database Name**
|
|
- **Connection Type**
|
|
|
|
If you are using **Hostname** as the connection type, you will need to provide the following information:
|
|
|
|
- **Host/IP**
|
|
- **Port**
|
|
- **SSL**
|
|
- **SSL Certificate**:
|
|
- **CA Certificate**
|
|
- **Self-signed Certificate**
|
|
- **None**
|
|
|
|
If you are using **Socket** as the connection type, you will need to provide the following information:
|
|
|
|
- **Socket Path**
|
|
|
|
**Note:** It is recommended to create a new MySQL database user so that you can control the access levels of ToolJet.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/mysql/mysqlconnect-v2.png" alt="mysql"/>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div style={{paddingTop:'24px'}}>
|
|
|
|
## Querying MySQL
|
|
|
|
1. Click on **+ Add** button of the query manager at the bottom panel of the editor.
|
|
2. Select the database added in the previous step as the data source.
|
|
|
|
Once the MySQL data source is added, you can create queries to read and write data to the database. You can create queries from the **[Query Panel](/docs/app-builder/query-panel#query-manager)** located at the bottom panel of the app builder.
|
|
|
|
### SQL Mode
|
|
|
|
SQL mode can be used to query MySQL database using SQL queries.
|
|
|
|
1. Select **SQL mode** from the dropdown.
|
|
2. Enter the SQL query in the editor.
|
|
3. Click on the **Run** button to run the query.
|
|
|
|
**Example:**
|
|
|
|
```sql
|
|
SELECT * FROM users
|
|
```
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/mysql/sqlmode.png" alt="mysql" style={{marginBottom:'15px'}}/>
|
|
|
|
</div>
|
|
|
|
#### Parameterized queries:
|
|
|
|
ToolJet offers support for parameterized SQL queries, which enhance security by preventing SQL injection and allow for dynamic query construction. To implement parameterized queries:
|
|
|
|
1. Use `:parameter_name` as placeholders in your SQL query where you want to insert parameters.
|
|
2. In the **Parameters** section below the query editor, add key-value pairs for each parameter.
|
|
3. The keys should match the parameter names used in the query (without the colon).
|
|
4. The values can be static values or dynamic values using the `{{ }}` notation.
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/datasource-reference/mysql/parameterized-query.png" alt="mysql"/>
|
|
</div>
|
|
|
|
##### Example:
|
|
|
|
```yaml
|
|
Query: SELECT * FROM users WHERE username = :username
|
|
SQL Parameters:
|
|
Key: username
|
|
Value: oliver // or {{ components.username.value }}
|
|
```
|
|
|
|
#### Query Timeout
|
|
|
|
You can set the timeout duration for SQL queries by adding the `PLUGINS_SQL_DB_STATEMENT_TIMEOUT` variable to the environment configuration file. By default, it is set to 120,000 ms.
|
|
|
|
### GUI Mode
|
|
|
|
GUI mode can be used to query MySQL database without writing queries.
|
|
|
|
1. Select **GUI mode** from the dropdown.
|
|
2. Choose the operation **Bulk update using primary key**.
|
|
3. Enter the **Table** name and **Primary key column** name.
|
|
4. In the editor enter the records in the form of an array of objects.
|
|
5. Click on the **Run** button to run the query.
|
|
|
|
**Example:**
|
|
|
|
```json
|
|
{{ [ {id: 1, channel: 33}, {id:2, channel:24} ] }}
|
|
```
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/mysql/guinew.png" alt="mysql"/>
|
|
|
|
</div>
|
|
|
|
:::tip
|
|
Query results can be transformed using transformations. Learn more about transformations [here](/docs/tutorial/transformations).
|
|
:::
|
|
|
|
</div>
|