# MySQL

Permite realizar consultas SELECT e INSERT en datos almacenados en un servidor remoto de MySQL.

# Sintaxis

mysql('host:port', 'database', 'table', 'user', 'password'[, replace_query, 'on_duplicate_clause'])

Argumentos

host:port — Dirección del servidor de MySQL.
database — Nombre de la base de datos remota.
table — Nombre de la tabla remota.
user — Usuario de MySQL.
password — Contraseña del usuario.
replace_query — Bandera que convierte las consultas INSERT INTO en REPLACE INTO. Valores posibles:
- 0 - La consulta se ejecuta como INSERT INTO.
- 1 - La consulta se ejecuta como REPLACE INTO.
on_duplicate_clause — La expresión ON DUPLICATE KEY que se agrega a la consulta INSERT. Solo se puede especificar con replace_query = 0 (si se pasa simultáneamente replace_query = 1 y on_duplicate_clause, MyScale genera una excepción).

Ejemplo: INSERT INTO t (c1, c2) VALUES ('a', 2) ON DUPLICATE KEY UPDATE c2 = c2 + 1;

Aquí, on_duplicate_clause es UPDATE c2 = c2 + 1. Consulta la documentación de MySQL para encontrar qué on_duplicate_clause se puede usar con la cláusula ON DUPLICATE KEY.
Las cláusulas WHERE simples como =, !=, >, >=, <, <= se ejecutan actualmente en el servidor de MySQL.
El resto de las condiciones y la restricción de muestreo LIMIT se ejecutan en MyScale solo después de que la consulta a MySQL finaliza.

Admite múltiples réplicas que deben ser listadas por |. Por ejemplo:

SELECT name FROM mysql(`mysql_host{1|2|3}:3306`, '[mysql_database]', '[mysql_table]', '[mysql_user]', '[mysql_password]');

SELECT name FROM mysql(`mysql_host1:3306|mysql_host2:3306|mysql_host3:3306`, '[mysql_database]', '[mysql_table]', '[mysql_user]', '[mysql_password]');

# Valor Devuelto

Un objeto de tabla con las mismas columnas que la tabla original de MySQL.

# Ejemplos

# Tabla en MySQL

# CREATE DATABASE
mysql> CREATE DATABASE test;
Query OK, 1 row affected (0.00 sec)
# CREATE TABLE
mysql> CREATE TABLE `test`.`test` (
    ->  `int_id` INT NOT NULL AUTO_INCREMENT,
    ->  `float` FLOAT NOT NULL,
    ->  PRIMARY KEY (`int_id`));
Query OK, 0 rows affected (0.01 sec)
# INSERT
mysql> INSERT INTO test.test (`int_id`, `float`) VALUES (1,2);
Query OK, 1 row affected (0.00 sec)
# SELECT
mysql> SELECT * FROM test.test;
+--------+-------+
| int_id | float |
+--------+-------+
|      1 |     2 |
+--------+-------+
1 row in set (0.00 sec)

# Seleccionar datos de MySQL

SELECT * FROM mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]');

┌─int_id─┬─float─┐
│      1 │     2 │
└────────┴───────┘

# Reemplazar e Insertar

# INSERT
INSERT INTO FUNCTION mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]') (int_id, float) VALUES (2, 3);
# REPLACE
INSERT INTO TABLE FUNCTION mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]', 0, 'UPDATE int_id = int_id + 1') (int_id, float) VALUES (2, 4);
# SELECT
SELECT * FROM mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]');

┌─int_id─┬─float─┐
│      1 │     3 │
│      3 │     3 │
└────────┴───────┘

# Copiar datos de una tabla de MySQL a una tabla de MyScale

# CREATE TABLE
CREATE TABLE mysql_copy
(
  `id` UInt64 NOT NULL,
  `score` FLOAT NOT NULL,
)
ENGINE = MergeTree
ORDER BY (id);
# INSERT
INSERT INTO mysql_copy
SELECT * FROM mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]');
# SELECT
SELECT * from mysql_copy;

┌─int_id─┬─float─┐
│      1 │     2 │
│      3 │     3 │
└────────┴───────┘

# Copiar solo un lote incremental de MySQL basado en el id máximo actual

# INSERT
INSERT INTO mysql_copy
SELECT * FROM mysql('[host:port]', 'test', 'test', '[mysql_user]', '[mysql_password]');
WHERE int_id > (SELECT max(id) from mysql_copy);
# SELECT
SELECT * FROM mysql_copy;

┌─int_id─┬─float─┐
│      1 │     2 │
│      3 │     3 │
└────────┴───────┘