Conexión Destino MySQL

Requisitos previos

Antes de configurar la conexión de destino MySQL en Crestone, asegúrese de cumplir con los siguientes requisitos:

Requisito principal: Una instancia activa y accesible de MySQL, versión 5.7 o superior, con un usuario que posea privilegios de escritura en la base de datos de destino. Las siguientes versiones están completamente soportadas:

Nota: Crestone utiliza mysql-connector-python en modo Python puro. No se requieren librerías de cliente adicionales ni controladores nativos en el servidor donde se ejecuta Crestone.

Información requerida:

Nota: A diferencia de Oracle, en MySQL los conceptos de esquema y base de datos son idénticos. Cuando Crestone carga datos en un esquema que aún no existe, intentará crearlo automáticamente mediante CREATE SCHEMA IF NOT EXISTS. El usuario configurado debe contar con el privilegio CREATE para que esta operación funcione.

Consejo: Si se conecta a una instancia local de MySQL para pruebas, utilice los siguientes valores:

• Server: localhost
• Port: 3306
• Database: crestone_test
• Username / Password: crestone / crestone123

Paso de verificación previa

Antes de configurar la conexión en Crestone, recomendamos verificar sus credenciales utilizando cualquier cliente MySQL de su preferencia (ej. DBeaver, MySQL Workbench, TablePlus o la CLI mysql). Esto garantiza que las credenciales sean correctas y que el servidor sea accesible antes de proceder.

Consejo para DBeaver: Si recibe el error Public Key Retrieval is not allowed al conectarse con DBeaver a MySQL 8.x, acceda a Propiedades del controlador y configure allowPublicKeyRetrieval en true y useSSL en false. Esta es una restricción del controlador JDBC y no afecta la conexión de Crestone.

Pasos de configuración

Siga estos pasos para crear una nueva conexión de destino MySQL en Crestone:

1. Diríjase a Connections en la barra de navegación superior.

2. Seleccione la pestaña Destination.

3. Haga clic en el botón + para crear una nueva conexión.

4. Complete el campo Connection Name con un nombre descriptivo (ej. Mi Base de Datos MySQL).

5. En el menú desplegable Destination Type, seleccione MySQL.

6. Complete el formulario de credenciales con los campos requeridos:

   • Server — host o dirección IP de su instancia de MySQL
   • Port — predeterminado 3306
   • Database — nombre de la base de datos MySQL a la que conectarse
   • Username — usuario de base de datos
   • Password — contraseña del usuario

7. Haga clic en Test Connection para validar que Crestone pueda comunicarse con la base de datos exitosamente.

8. Una vez aprobada la prueba, haga clic en Create Destination para guardar la conexión.

Edición de una conexión existente

Para actualizar las credenciales de una conexión de destino MySQL existente:

1. Diríjase a Connections y localice su destino MySQL.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

Uso de MySQL como destino en un nodo de extracción

Una vez creada la conexión, puede utilizarla como destino en un nodo de extracción (Extraction Node):

1. Abra o cree un Extraction Node y diríjase a la pestaña Destination.
2. En Select Destinations, elija su conexión MySQL.
3. En Select Schema, elija un esquema existente de la lista, o seleccione Create new schema para que Crestone lo cree automáticamente.
4. En Select Table, elija una tabla existente o seleccione Create new table para que Crestone la cree automáticamente según la estructura de datos de origen.
5. Opcionalmente, habilite Prefers to delete existing data and then insert new data si desea truncar la tabla antes de cada carga.
6. Continúe a la pestaña Settings y guarde el nodo.

Nota: Al seleccionar Create new table, Crestone infiere automáticamente los tipos de columna a partir de los datos de origen y crea la tabla en MySQL antes de insertar registros. El mapeo de tipos aplicado es:

Tipo de origen	Tipo MySQL
Int8 / Int16	SMALLINT
Int32	INT
Int64	BIGINT
Float32	FLOAT
Float64	DOUBLE
Boolean	TINYINT(1)
String	TEXT
Date	DATE
Datetime	DATETIME
Otros	TEXT

Nota: A diferencia de Oracle, los esquemas de MySQL se pueden crear de forma automática. Si el usuario configurado cuenta con el privilegio CREATE, Crestone creará el esquema si este no existe antes de cargar los datos.

Problemas comunes

Permisos requeridos

El usuario de base de datos configurado en Crestone requiere como mínimo los siguientes privilegios:

-- Otorgar acceso a una base de datos existente específica
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER
  ON my_database.*
  TO 'crestone'@'%';

-- Si desea que Crestone cree nuevos esquemas automáticamente:
GRANT CREATE ON *.* TO 'crestone'@'%';

FLUSH PRIVILEGES;

Consejo: Para entornos de prueba o cuando el usuario de MySQL es propietario de la base de datos destino, otorgar ALL PRIVILEGES ON my_database.* es el enfoque más simple y cubre todas las operaciones que Crestone pueda requerir.

-- Permiso simplificado para una base de datos dedicada (entornos de prueba):
GRANT ALL PRIVILEGES ON my_database.* TO 'crestone'@'%';
FLUSH PRIVILEGES;