ToolJet/docs/versioned_docs/version-3.5.0-LTS/data-sources/mariadb.md

---
id: mariadb
title: MariaDB
---

ToolJet can connect to both self-hosted and cloud-based MariaDB servers to read and write data.

<div style={{paddingTop:'24px'}}>

## Connection

To establish a connection with the MariaDB global datasource, you can either click on the **+ Add new global datasource** button located on the query panel or navigate to the **[Global Datasources](/docs/data-sources/overview)** page through the ToolJet dashboard.

**ToolJet requires the following connection details to connect to MariaDB:**

- **Host:** The hostname or IP address of the MariaDB server.
- **Username:** The username for the MariaDB account.
- **Password:** The password for the MariaDB account.
- **Connection Limit:** The maximum number of concurrent connections allowed to the MariaDB server.
- **Port:** The port number of the MariaDB server.
- **Database:** The name of the database that you want to connect to.
- **SSL:** Whether or not to use SSL to connect to the MariaDB server.
- **SSL Certificate:** There are three options for the SSL Certificate connection detail:
  - **CA Certificate:** This option allows you to use a certificate issued by a Certificate Authority (CA). This is the most secure option, as it ensures that the identity of the MariaDB server has been verified by a trusted third party.
  - **Self-Signed Certificate:** This option allows you to use a self-signed certificate. This is less secure than using a CA certificate, as it does not ensure the identity of the MariaDB server has been verified by a trusted third party. However, it is a good option if you do not have access to a CA certificate.
  - **None:** This option does not use SSL. This is the least secure option, as it allows anyone to intercept your communications with the MariaDB server.

<img className="screenshot-full" src="/img/datasource-reference/mariadb/connections.png" alt="MariaDB" />

</div>

<div style={{paddingTop:'24px'}}>

## Querying MariaDB

Once you have connected to the MariaDB datasource, follow these steps to write queries and interact with a MariaDB database from the ToolJet application:

1. Click the **+ Add** button to open the list of available datasources.
2. Select **MariaDB** from the global datasource section.
3. Enter the SQL query in the editor.
4. Click **Preview** to view the data returned from the query or click **Run** to execute the query.

:::tip
Query results can be transformed using Transformation. For more information on transformations, please refer to our documentation at **[link](/docs/tutorial/transformations)**.
:::

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/querycreate-v2.png" alt="MariaDB query" />

</div>

</div>

<div style={{paddingTop:'24px'}}>

## CRUD Queries

Suppose there exists a MariaDB database named _customers_. We can create an example table called _users_ with the following columns:

- **id** (integer, auto-increment)
- **name** (varchar)
- **age** (integer)
- **email** (varchar)

```sql
CREATE TABLE user(
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(50),
  age INT,
  email VARCHAR(100)
);
```

The above command will create the _users_ table within the _customers_ database. Now, let's explore the CRUD commands for this table in MariaDB:

### Create (Insert)

#### To Insert a Single User:

```sql
INSERT INTO user (name, age, email)
VALUES ('John Doe', 25, 'john@example.com');
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/insertUser.png" alt="MariaDB query" style={{marginBottom:'15px'}} />

</div>

#### To Insert Multiple Users:

```sql
INSERT INTO user (name, age, email)
VALUES
    ('John Doe', 25, 'john@example.com'),
    ('Jane Smith', 30, 'jane@example.com'),
    ('Bob Johnson', 35, 'bob@example.com');
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/insertUsers.png" alt="MariaDB query" style={{marginBottom:'15px'}} />

</div>

### Read (Select)

#### To Retrieve All Users:

```sql
SELECT * FROM user;
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/readall-v2.png" alt="MariaDB query" style={{marginBottom:'15px'}} />

</div>

#### To Retrieve Specific Columns From Users:

```sql
SELECT name, age, email FROM user;
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/readcolumn-v2.png" alt="MariaDB query" style={{marginBottom:'15px'}}/>

</div>

#### To Add Conditions and Filters to the Selection:

```sql
SELECT name, age, email
FROM user
WHERE age > 25;
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/readfilter-v2.png" alt="MariaDB query" style={{marginBottom:'15px'}}/>

</div>

### Update

#### To Update the Age of a User:

```sql
UPDATE user
SET age = 26
WHERE id = 1;
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/updateuser-v2.png" alt="MariaDB query" style={{marginBottom:'15px'}}/>

</div>

### Delete

#### To Delete a User:

```sql
DELETE FROM user WHERE id = 1;
```

<div style={{textAlign: 'center'}}>

<img className="screenshot-full" src="/img/datasource-reference/mariadb/deleteuser-v2.png" alt="MariaDB query" style={{marginBottom:'15px'}}/>

</div>

Remember to adjust the values and conditions based on your specific needs. These commands will allow you to create the table, insert data, retrieve data, update data, and delete data in the _users_ table in MariaDB.

</div>

<div style={{paddingTop:'24px'}}>

## Troubleshooting Tips

If you are having trouble connecting a MariaDB data source to ToolJet, try the following:

- Make sure that your MariaDB server is running and accessible from the ToolJet server.
- Check the spelling and capitalization of your credentials.
- Try restarting the ToolJet server.

If you are still having trouble, please contact [ToolJet support](mailto:hello@tooljet.com) or ask on [slack](https://join.slack.com/t/tooljet/shared_invite/zt-2rk4w42t0-ZV_KJcWU9VL1BBEjnSHLCA) for assistance.

</div>