mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-23 22:47:28 +00:00
9f2ff94a12
* whtie label revamp * minor changes * updated beta info in copilot docs * renamed gds to ds in overview doc of v2.15 onwards * updated multienv: renamed gds to ds, updated screenshot * updated multienv: app state description * updated superadmin wrt new licensing updates * licensing update: free trial * updates in licensing * changes after review * [docs]updated restapi with bearer auth * Update kubernetes-aks.md * Update openshift.md * Update ecs.md * Update ecs.md * Update kubernetes-gke.md * Update kubernetes.md * Update docker.md * Update docker.md * Update ecs.md * Update google-cloud-run.md * Update kubernetes-aks.md * Update kubernetes-gke.md * Update kubernetes.md * Update openshift.md * Update kubernetes-gke.md * Update kubernetes-aks.md * fixed ecs, removed heroku from 2.15 onwards * updated digitalocean doc * licensing doc changes and location * Update digitalocean.md * Update digitalocean.md * added v2.18.0 --------- Co-authored-by: Adish M <44204658+adishM98@users.noreply.github.com>
96 lines
No EOL
3.4 KiB
Markdown
96 lines
No EOL
3.4 KiB
Markdown
---
|
|
id: mysql
|
|
title: MySQL
|
|
---
|
|
|
|
ToolJet can connect to MySQL databases to read and write data.
|
|
|
|
## Connection
|
|
|
|
To establish a connection with the MySQL datasource, you can either click on the `+Add New` button located on the query panel or navigate to the **[Global Datasources](/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 datasource"/>
|
|
|
|
</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:**
|
|
|
|
| Parameter | Description |
|
|
|:--- |:--- |
|
|
| Username | Username of the MySQL database |
|
|
| Password | Password of the MySQL database |
|
|
| Database name | Name of the MySQL database |
|
|
| Connection type | Connection type of the MySQL database: either **Hostname** or **Socket**. |
|
|
|
|
If you are using **Hostname** as the connection type, you will need to provide the following information:
|
|
|
|
| Parameter | Description |
|
|
|:--- |:--- |
|
|
| Host/IP | Hostname or IP address of the MySQL database |
|
|
| Port | Port number of the MySQL database |
|
|
| SSL | Enable SSL connection to the MySQL database |
|
|
|
|
If you are using **Socket** as the connection type, you will need to provide the following information:
|
|
|
|
| Parameter | Description |
|
|
|:--- |:--- |
|
|
| Socket path | Path of the socket file |
|
|
|
|
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.png" alt="mysql"/>
|
|
|
|
</div>
|
|
|
|
Click on **Test connection** to verify the correctness of the provided credentials and the accessibility of the database to the ToolJet server. Finally, click the **Save** button to save the data source configuration.
|
|
|
|
## Querying MySQL
|
|
|
|
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#add)** located at the bottom panel of the app builder.
|
|
|
|
1. **[SQL mode](/docs/data-sources/mysql#sql-mode)**
|
|
2. **[GUI mode](/docs/data-sources/mysql#gui-mode)**
|
|
|
|
### SQL mode
|
|
|
|
SQL mode can be used to query MySQL database using SQL queries. Select SQL mode from the dropdown and then enter the SQL query in the editor.
|
|
|
|
**Example:**
|
|
```sql
|
|
SELECT * FROM users
|
|
```
|
|
|
|
<div style={{textAlign: 'center'}}>
|
|
|
|
<img className="screenshot-full" src="/img/datasource-reference/mysql/sqlmode.png" alt="mysql"/>
|
|
|
|
</div>
|
|
|
|
### GUI mode
|
|
|
|
GUI mode can be used to query MySQL database without writing queries. Select GUI mode from the dropdown and then choose the operation **Bulk update using primary key**. Enter the **Table** name and **Primary key column** name. Now, in the editor enter the records in the form of an array of objects. Each object should contain the primary key column and the columns to be updated.
|
|
|
|
**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).
|
|
::: |