> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Permite conectarse a bases de datos en un servidor MySQL remoto y realizar consultas `INSERT` y `SELECT` para intercambiar datos entre ClickHouse y MySQL.

# MySQL

export const CloudNotSupportedBadge = () => {
  return <a href="https://clickhouse.com/docs/products/cloud/guides/cloud-compatibility#list-of-unsupported-features" className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            No es compatible con ClickHouse Cloud
        </a>;
};

<CloudNotSupportedBadge />

Permite conectarse a bases de datos en un servidor MySQL remoto y realizar consultas `INSERT` y `SELECT` para intercambiar datos entre ClickHouse y MySQL.

El motor de base de datos `MySQL` traduce las consultas para el servidor MySQL, por lo que puede realizar operaciones como `SHOW TABLES` o `SHOW CREATE TABLE`.

No se pueden realizar las siguientes consultas:

* `RENAME`
* `CREATE TABLE`
* `ALTER`

<div id="creating-a-database">
  ## Creación de una base de datos
</div>

```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]
```

**Parámetros del motor**

* `host:port` — Dirección del servidor MySQL.
* `database` — Nombre de la base de datos remota.
* `user` — Usuario de MySQL.
* `password` — Contraseña del usuario.

**Configuración**

<div id="enable-compression">
  ### `enable_compression`
</div>

Habilita la compresión zlib para la conexión del protocolo MySQL. Cuando se establece en `1`, ClickHouse solicita al servidor MySQL compresión a nivel de protocolo.

Valor predeterminado: `0`.

Ejemplo:

```sql theme={null}
CREATE DATABASE mysql_db
ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password')
SETTINGS enable_compression = 1;
```

<div id="tls-ssl">
  ## TLS/SSL
</div>

Las credenciales de una conexión cifrada a MySQL se proporcionan como claves de una [colección con nombre](/es/concepts/features/configuration/server-config/named-collections) (o como argumentos de clave-valor):

| Parámetro      | Descripción                                                                               |
| -------------- | ----------------------------------------------------------------------------------------- |
| `ssl_ca_pem`   | Contenido del certificado de CA con el que se verifica el certificado del servidor MySQL. |
| `ssl_cert_pem` | Contenido del certificado de client para la autenticación basada en certificados.         |
| `ssl_key_pem`  | Contenido de la clave privada asociada a `ssl_cert_pem`.                                  |

Los valores corresponden al contenido de los archivos PEM respectivos, que se puede copiar en una colección con nombre o en una consulta. Se enmascaran en los registros y en las consultas `SHOW`, al igual que las contraseñas.

Las mismas credenciales también se pueden proporcionar como rutas de archivos en el servidor, mediante `ssl_ca`, `ssl_cert` y `ssl_key`, pero **solo en una colección con nombre definida en el archivo de configuración del servidor**; dicho valor no se puede sobrescribir en una consulta. El servidor abre esos archivos con sus propios privilegios, por lo que aceptar una ruta desde SQL permitiría a cualquier usuario que pueda definir una fuente MySQL explorar el sistema de archivos local y autenticarse con un certificado y una clave que no tiene permiso de leer.

<a id="data_types-support" />

<div id="data-types-support">
  ## Compatibilidad de tipos de datos
</div>

| MySQL                            | ClickHouse                                                      |
| -------------------------------- | --------------------------------------------------------------- |
| UNSIGNED TINYINT                 | [UInt8](/es/reference/data-types/int-uint)                      |
| TINYINT                          | [Int8](/es/reference/data-types/int-uint)                       |
| UNSIGNED SMALLINT                | [UInt16](/es/reference/data-types/int-uint)                     |
| SMALLINT                         | [Int16](/es/reference/data-types/int-uint)                      |
| UNSIGNED INT, UNSIGNED MEDIUMINT | [UInt32](/es/reference/data-types/int-uint)                     |
| INT, MEDIUMINT                   | [Int32](/es/reference/data-types/int-uint)                      |
| UNSIGNED BIGINT                  | [UInt64](/es/reference/data-types/int-uint)                     |
| BIGINT                           | [Int64](/es/reference/data-types/int-uint)                      |
| FLOAT                            | [Float32](/es/reference/data-types/float)                       |
| DOUBLE                           | [Float64](/es/reference/data-types/float)                       |
| DATE                             | [Date](/es/reference/data-types/date)                           |
| DATETIME, TIMESTAMP              | [DateTime](/es/reference/data-types/datetime)                   |
| BINARY                           | [FixedString](/es/reference/data-types/fixedstring)             |
| POINT                            | [Point](/es/reference/data-types/geo#point)                     |
| LINESTRING                       | [LineString](/es/reference/data-types/geo#linestring)           |
| POLYGON                          | [Polygon](/es/reference/data-types/geo#polygon)                 |
| MULTILINESTRING                  | [MultiLineString](/es/reference/data-types/geo#multilinestring) |
| MULTIPOLYGON                     | [MultiPolygon](/es/reference/data-types/geo#multipolygon)       |
| MULTIPOINT                       | [MultiPoint](/es/reference/data-types/geo#multipoint)           |
| GEOMETRY                         | [Geometry](/es/reference/data-types/geo#geometry)               |

La conversión de los tipos espaciales (excepto `POINT`, que siempre se convierte) se controla mediante el indicador `geometry` de la configuración [`mysql_datatypes_support_level`](/es/reference/settings/session-settings/mysql#mysql_datatypes_support_level), habilitada de forma predeterminada. El tipo de columna genérico `GEOMETRY` se asigna al tipo abarcador [`Geometry`](/es/reference/data-types/geo#geometry) (un `Variant` sobre los tipos geométricos concretos). Dado que dicha columna puede contener un valor de cualquier subtipo, leer un valor cuyo subtipo no tiene equivalente en ClickHouse (`GEOMETRYCOLLECTION`) genera una excepción durante la lectura; esta incompatibilidad se acepta a cambio de disponer de un tipo geométrico adecuado. Las columnas declaradas con el tipo `GEOMETRYCOLLECTION` se convierten a [String](/es/reference/data-types/string), al igual que todos los demás tipos de datos de MySQL.

Se admite [Nullable](/es/reference/data-types/nullable). Una columna espacial se asigna a `String` (`Nullable(String)` si admite valores nulos) en tres casos: se declara como `GEOMETRYCOLLECTION`; el indicador `geometry` está deshabilitado y el tipo no es `POINT`; o la columna admite valores nulos y el tipo no es `POINT`, ya que `Point` es el único tipo geométrico que puede anidarse dentro de `Nullable`. En los tres casos, la cadena contiene el valor exactamente como lo devuelve MySQL: un prefijo SRID de 4 bytes seguido de la carga útil WKB, por lo que debe eliminar esos 4 bytes iniciales antes de pasarlo a un decodificador WKB.

<div id="global-variables-support">
  ## Compatibilidad con las variables globales
</div>

Para mejorar la compatibilidad, puede hacer referencia a las variables globales al estilo de MySQL, como `@@identifier`.

Se admiten estas variables:

* `version`
* `max_allowed_packet`

<Note>
  Por ahora, estas variables son solo marcadores de posición y no corresponden a nada.
</Note>

Ejemplo:

```sql theme={null}
SELECT @@version;
```

<div id="examples-of-use">
  ## Ejemplos de uso
</div>

Tabla en 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 datos de ClickHouse que intercambia datos con el servidor 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 │
└────────┴───────┘
```