> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Permet de se connecter à des bases de données sur un serveur MySQL distant et d'exécuter des requêtes `INSERT` et `SELECT` afin d'échanger des données entre ClickHouse et MySQL.
# MySQL
export const CloudNotSupportedBadge = () => {
return
Non pris en charge par ClickHouse Cloud
;
};
# Moteur de base de données MySQL
Permet de se connecter à des bases de données hébergées sur un serveur MySQL distant et d’exécuter des requêtes `INSERT` et `SELECT` pour échanger des données entre ClickHouse et MySQL.
Le moteur de base de données `MySQL` traduit les requêtes pour le serveur MySQL, ce qui vous permet d’effectuer des opérations telles que `SHOW TABLES` ou `SHOW CREATE TABLE`.
Vous ne pouvez pas exécuter les requêtes suivantes :
* `RENAME`
* `CREATE TABLE`
* `ALTER`
## Création d’une base de données
```sql theme={null}
CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster]
ENGINE = MySQL('host:port', ['database' | database], 'user', 'password')
[SETTINGS enable_compression=0]
```
**Paramètres du moteur**
* `host:port` — Adresse du serveur MySQL.
* `database` — Nom de la base de données distante.
* `user` — Utilisateur MySQL.
* `password` — Mot de passe de l’utilisateur.
**Réglages**
### `enable_compression`
Active la compression zlib pour la connexion via le protocole MySQL. Lorsqu’elle est définie sur `1`, ClickHouse demande au serveur MySQL une compression au niveau du protocole.
Valeur par défaut : `0`.
Exemple :
```sql theme={null}
CREATE DATABASE mysql_db
ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password')
SETTINGS enable_compression = 1;
```
## Prise en charge des types de données
| MySQL | ClickHouse |
| -------------------------------- | --------------------------------------------------- |
| UNSIGNED TINYINT | [UInt8](/fr/reference/data-types/int-uint) |
| TINYINT | [Int8](/fr/reference/data-types/int-uint) |
| UNSIGNED SMALLINT | [UInt16](/fr/reference/data-types/int-uint) |
| SMALLINT | [Int16](/fr/reference/data-types/int-uint) |
| UNSIGNED INT, UNSIGNED MEDIUMINT | [UInt32](/fr/reference/data-types/int-uint) |
| INT, MEDIUMINT | [Int32](/fr/reference/data-types/int-uint) |
| UNSIGNED BIGINT | [UInt64](/fr/reference/data-types/int-uint) |
| BIGINT | [Int64](/fr/reference/data-types/int-uint) |
| FLOAT | [Float32](/fr/reference/data-types/float) |
| DOUBLE | [Float64](/fr/reference/data-types/float) |
| DATE | [Date](/fr/reference/data-types/date) |
| DATETIME, TIMESTAMP | [DateTime](/fr/reference/data-types/datetime) |
| BINARY | [FixedString](/fr/reference/data-types/fixedstring) |
Tous les autres types de données MySQL sont convertis en [String](/fr/reference/data-types/string).
[Nullable](/fr/reference/data-types/nullable) est pris en charge.
## Prise en charge des variables globales
Pour une meilleure compatibilité, vous pouvez référencer les variables globales dans le style MySQL, sous la forme `@@identifier`.
Ces variables sont prises en charge :
* `version`
* `max_allowed_packet`
À ce jour, ces variables sont des stubs et ne correspondent à rien.
Exemple :
```sql theme={null}
SELECT @@version;
```
## Exemples d’utilisation
Table dans MySQL :
```text theme={null}
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)
```
Base de données ClickHouse échangeant des données avec le serveur MySQL :
```sql theme={null}
CREATE DATABASE mysql_db ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password') SETTINGS read_write_timeout=10000, connect_timeout=100;
```
```sql theme={null}
SHOW DATABASES
```
```text theme={null}
┌─name─────┐
│ default │
│ mysql_db │
│ system │
└──────────┘
```
```sql theme={null}
SHOW TABLES FROM mysql_db
```
```text theme={null}
┌─name─────────┐
│ mysql_table │
└──────────────┘
```
```sql theme={null}
SELECT * FROM mysql_db.mysql_table
```
```text theme={null}
┌─int_id─┬─value─┐
│ 1 │ 2 │
└────────┴───────┘
```
```sql theme={null}
INSERT INTO mysql_db.mysql_table VALUES (3,4)
```
```sql theme={null}
SELECT * FROM mysql_db.mysql_table
```
```text theme={null}
┌─int_id─┬─value─┐
│ 1 │ 2 │
│ 3 │ 4 │
└────────┴───────┘
```