pg_local_cache
Español

Prueba pg_local_cache localmente

Esta demo compila pg_local_cache desde tu copia de trabajo en un servidor PostgreSQL 16 separado. No lo instala en un servidor PostgreSQL existente.

Necesitas Git, Docker y Docker Compose con compatibilidad con up --wait. La imagen se compila desde el código fuente.

Inicia la base de datos

git clone https://github.com/profundium/pg_local_cache.git
cd pg_local_cache
docker compose -f examples/compose.yaml up --build --wait

La demo enlaza PostgreSQL en 127.0.0.1:55432, no tiene listener RESP ni volumen persistente y almacena los datos en tmpfs local del contenedor. Detener el contenedor descarta sus datos. demo-only es para esta demo de loopback; usa tus propias credenciales en producción.

Si el puerto 55432 está ocupado, define PGLC_DEMO_PORT antes de iniciar Compose y mantenlo definido al ejecutar el ejemplo de Node.js:

export PGLC_DEMO_PORT=55433

Lee como un rol de aplicación

La configuración crea 4.096 filas en public.items. Solo esa tabla está asociada a la caché. El rol demo no es superusuario.

docker compose -f examples/compose.yaml exec -T postgres \
  psql -X -v ON_ERROR_STOP=1 -U demo -d pglc_demo <<'SQL'
SELECT unnest(local_cache.mget(
  'public.items'::regclass,
  ARRAY[42, 7, 42, NULL, 999999]::bigint[]
));
SELECT unnest(local_cache.mget(
  'public.items'::regclass,
  ARRAY[42, 7, 42, NULL, 999999]::bigint[]
));
SQL

Ambas llamadas devuelven las mismas filas ordenadas. La primera y tercera posiciones se refieren a la fila 42. Las dos últimas posiciones son NULL SQL: una entrada es nula y la clave 999999 no existe. En psql, los valores nulos SQL aparecen en blanco de forma predeterminada.

La función devuelve text[]. El unnest anterior muestra una entrada del array por línea.

Inspecciona los contadores como administrador de la base de datos:

docker compose -f examples/compose.yaml exec -T postgres \
  psql -X -v ON_ERROR_STOP=1 -U postgres -d pglc_demo \
  -c 'SELECT local_cache.health();' \
  -c 'SELECT local_cache.stats();'

En esta demo recién creada, local_cache.health() debe indicar ready: true, y repetir las lecturas debe aumentar sql_cache_hits. Si los aciertos permanecen en cero, inspecciona sql_cache_misses, sql_cache_fills y sql_cache_bypasses usando la guía de invalidación.

Comprueba el commit y el rollback

Con Node.js 20 o posterior:

npm --prefix examples/node-postgres ci --ignore-scripts
npm --prefix examples/node-postgres run demo

La prueba abre conexiones de lectura y escritura separadas. Comprueba un acierto caliente, el orden de entrada, claves duplicadas y ausentes, una actualización no confirmada, la lectura de los propios cambios, el rollback y una actualización confirmada. Termina con código distinto de cero si falla una aserción.

Consulta el recorrido SQL con dos sesiones o la explicación de la consulta de Node.js.

Conecta tu aplicación

A continuación, compara la misma carga de trabajo SQL y RESP. Para problemas de resultados o configuración, abre un informe de carga de trabajo con tu entorno y el JSON del benchmark o el registro de errores.

Elimina la demo

docker compose -f examples/compose.yaml down

La imagen Docker compilada localmente queda disponible para otra ejecución. No es necesario reiniciar ni restaurar el servicio PostgreSQL del host.

Para una base de datos existente, sigue la guía de instalación. Ese recorrido tiene privilegios, configuración y requisitos de reinicio diferentes.

Actualizado .