ElectricSQL

La sincronización es el ingrediente mágico detrás del software moderno y rápido. Desde apps como Figma y Linear hasta agentes de IA que operan con datos locales en vivo.

Electric es un motor de sincronización para Postgres. Resuelve por ti los problemas difíciles de la sincronización, incluyendo la replicación parcial, el fan-out y la entrega de datos. Así puedes crear software increíble sin tener que construir tu propia solución de sync.

En concreto, Electric es un motor de sincronización del camino de lectura (read-path) para Postgres. Sincroniza datos desde Postgres hacia... cualquier cosa que quieras. El protocolo base de sincronización se apoya en una API HTTP de bajo nivel. Esto se integra con CDNs para una entrega de datos altamente escalable.

La replicación parcial se gestiona mediante Shapes. La sincronización puede consumirse directamente o mediante librerías de cliente e integraciones con frameworks.

Más información →

Despliegue

Debes tener una instancia de PostgreSQL en ejecución. Despliega una aquí.

También necesitas añadir wal_level = 'logical' a tu archivo postgresql.conf. Puedes encontrarlo en la página del Editor de Configuración de tu PostgreSQL.

Una vez que tengas una instancia de PostgreSQL, puedes desplegar Electric haciendo clic en el botón "Deploy". Esta plantilla de despliegue con un solo clic se asociará automáticamente con la primera instancia de PostgreSQL de tu proyecto.

Ten en cuenta que esta API está protegida con un token de API. Puedes encontrar el token por defecto en la sección "Instructions" del servicio electric. Si quieres rotar tu token, puedes cambiar la variable de entorno PASSWORD por un valor personalizado.

También hemos configurado un proxy de caché en el servicio Electric. Se recomienda usar nuestro proxy para acceder al servicio Electric: es el dominio que vinculaste al desplegar el servicio. Puedes encontrar el dominio del proxy en la sección "Instructions" del servicio electricproxy.

En producción, quizá también necesites configurar un proxy de autenticación para evitar accesos no autorizados. Puedes usar el BFF (p. ej., rutas API) que proporcionan Next.js o TanStack Start para hacer de proxy.

Uso

Una vez que hayas desplegado el servicio Electric, puedes usar la siguiente API para solicitar un Shape que contenga todas las filas de la tabla scores:

curl https://your-domain.zeabur.app/v1/shape?table=scores&offset=-1&secret=SECRET_FROM_INSTRUCTIONS

Configuración

• DATABASE_URL: La URL de la instancia de PostgreSQL. Es útil si tienes más de una instancia de PostgreSQL en ejecución.
• PASSWORD: El token de API del servicio Electric. También puedes encontrarlo en la sección "Instructions" del servicio electric.