maxpert/marmot

¿Qué es?

Funciones clave

• 01Cualquier nodo acepta escrituras, sin elección de líder ni pasos de conmutación por fallo.
• 02Usa el protocolo de conexión de MySQL, por lo que funcionan los clientes y drivers estándar de MySQL.
• 03Replica cambios a nivel de fila mediante un commit en dos fases y una consistencia configurable.
• 04Replica DDL con bloqueo para todo el clúster y reescritura automática para que las sentencias sean idempotentes.
• 05Publica eventos de cambios en Kafka o NATS en un formato compatible con Debezium.
• 06Incluye búsqueda vectorial con funciones SQL para consultas de similitud con filtros.

Casos de uso

• Ejecutar un sitio de WordPress en varias regiones con una base de datos replicada.
• Mantener en el edge réplicas de lectura regionales con datos de configuración o catálogos de productos.
• Crear un pequeño almacén RAG que combine embeddings con filtros SQL convencionales.
• Transmitir cambios de la base de datos a Kafka o NATS para usarlos en pipelines posteriores.

Inicio rápido

1. 1

   Inicia un clúster de un solo nodo

   ./marmot-v2
2. 2

   Conéctate con un cliente MySQL

   mysql -h localhost -P 3306 -u root

Antes de usarlo

• !Ofrece consistencia eventual, no serializabilidad estricta.
• !Cada nodo conserva una copia completa de todos los datos, por lo que es adecuado para conjuntos de datos pequeños, no para conjuntos muy grandes (más de 100 GB).
• !No se admite ejecutar DDL simultáneamente en la misma base de datos desde varios nodos, y ALTER TABLE es menos seguro de volver a ejecutar.
• !Los archivos multimedia, como las cargas, no se replican y requieren almacenamiento compartido por separado.

Temas

Preguntas frecuentes

¿Qué es marmot?

Servidor de replicación distribuida de SQLite sin líder, que acepta escrituras en cualquier nodo y usa el protocolo de conexión de MySQL. Marmot es un servidor distribuido de SQLite escrito en Go. Cualquier nodo del clúster puede aceptar escrituras, por lo que no hay un primario único al que haya que conmutar en caso de fallo. Los nodos intercambian cambios mediante un protocolo gossip y cada escritura se coordina con un commit en dos fases y un nivel de consistencia configurable (ONE, QUORUM o ALL). Los conflictos en una misma fila se resuelven dando prioridad a la última escritura según una marca de tiempo de reloj lógico híbrido.

¿marmot es gratuito? ¿Qué licencia tiene?

marmot es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿marmot sigue mantenido?

Mantenimiento activo. El último commit de marmot fue el 30 sept 2026.

¿Para qué puedo usar marmot?

Ejecutar un sitio de WordPress en varias regiones con una base de datos replicada. Mantener en el edge réplicas de lectura regionales con datos de configuración o catálogos de productos. Crear un pequeño almacén RAG que combine embeddings con filtros SQL convencionales. Transmitir cambios de la base de datos a Kafka o NATS para usarlos en pipelines posteriores.

¿Cómo se instala marmot?

Inicia un clúster de un solo nodo: ./marmot-v2 Conéctate con un cliente MySQL: mysql -h localhost -P 3306 -u root

¿Dónde consigo marmot?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/maxpert/marmot