title_wip

[Edit this page](https://github.com/ClickHouse/ClickHouse/tree/master/docs/en/engines/database-engines/mysql.md)

Not supported in ClickHouse Cloud

Allows to connect to databases on a remote MySQL server and perform `INSERT` and `SELECT` queries to exchange data between ClickHouse and MySQL.

The `MySQL` database engine translate queries to the MySQL server so you can perform operations such as `SHOW TABLES` or `SHOW CREATE TABLE`.

You cannot perform the following queries:

- `RENAME`
- `CREATE TABLE`
- `ALTER`

## Creating a database[​](#creating-a-database "Direct link to Creating a database")

```
CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster]
ENGINE = MySQL('host:port', ['database' | database], 'user', 'password')
```

**Engine Parameters**

- `host:port` — MySQL server address.
- `database` — Remote database name.
- `user` — MySQL user.
- `password` — User password.

## Data types support[​](#data_types-support "Direct link to Data types support")

|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| MySQL ClickHouse|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | UNSIGNED TINYINT [UInt8](/docs/sql-reference/data-types/int-uint)| TINYINT [Int8](/docs/sql-reference/data-types/int-uint)| UNSIGNED SMALLINT [UInt16](/docs/sql-reference/data-types/int-uint)| SMALLINT [Int16](/docs/sql-reference/data-types/int-uint)| UNSIGNED INT, UNSIGNED MEDIUMINT [UInt32](/docs/sql-reference/data-types/int-uint)| INT, MEDIUMINT [Int32](/docs/sql-reference/data-types/int-uint)| UNSIGNED BIGINT [UInt64](/docs/sql-reference/data-types/int-uint)| BIGINT [Int64](/docs/sql-reference/data-types/int-uint)| FLOAT [Float32](/docs/sql-reference/data-types/float)| DOUBLE [Float64](/docs/sql-reference/data-types/float)| DATE [Date](/docs/sql-reference/data-types/date)| DATETIME, TIMESTAMP [DateTime](/docs/sql-reference/data-types/datetime)| BINARY [FixedString](/docs/sql-reference/data-types/fixedstring) | | | | | | | | | | | | | | | | | | | | | | | | | | | |

All other MySQL data types are converted into [String](/docs/sql-reference/data-types/string).

[Nullable](/docs/sql-reference/data-types/nullable) is supported.

## Global variables support[​](#global-variables-support "Direct link to Global variables support")

For better compatibility you may address global variables in MySQL style, as `@@identifier`.

These variables are supported:

- `version`
- `max_allowed_packet`

Note

By now these variables are stubs and don't correspond to anything.

Example:

```
SELECT @@version;
```

## Examples of use[​](#examples-of-use "Direct link to Examples of use")

Table in MySQL:

```
mysql> USE test;
Database changed

mysql> CREATE TABLE `mysql_table` (
    ->   `int_id` INT NOT NULL AUTO_INCREMENT,
    ->   `float` FLOAT NOT NULL,
    ->   PRIMARY KEY (`int_id`));
Query OK, 0 rows affected (0,09 sec)

mysql> insert into mysql_table (`int_id`, `float`) VALUES (1,2);
Query OK, 1 row affected (0,00 sec)

mysql> select * from mysql_table;
+------+-----+
| int_id | value |
+------+-----+
|      1 |     2 |
+------+-----+
1 row in set (0,00 sec)
```

Database in ClickHouse, exchanging data with the MySQL server:

```
CREATE DATABASE mysql_db ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password') SETTINGS read_write_timeout=10000, connect_timeout=100;
```

```
SHOW DATABASES
```

```
┌─name─────┐
│ default  │
│ mysql_db │
│ system   │
└──────────┘
```

```
SHOW TABLES FROM mysql_db
```

```
┌─name─────────┐
│  mysql_table │
└──────────────┘
```

```
SELECT * FROM mysql_db.mysql_table
```

```
┌─int_id─┬─value─┐
│      1 │     2 │
└────────┴───────┘
```

```
INSERT INTO mysql_db.mysql_table VALUES (3,4)
```

```
SELECT * FROM mysql_db.mysql_table
```

```
┌─int_id─┬─value─┐
│      1 │     2 │
│      3 │     4 │
└────────┴───────┘
```

- [Creating a database](#creating-a-database)- [Data types support](#data_types-support)- [Global variables support](#global-variables-support)- [Examples of use](#examples-of-use)

Was this page helpful?