Ridge Solución de problemas

Diagnostique desde el límite más externo hacia adentro: servicio, transporte, sesión, catálogo, SQL, transacción y luego almacenamiento. Conserve el primer error estructurado y SQLSTATE.

El servicio no está disponible

systemctl status ridged.service
pg_isready -h 127.0.0.1 -p 7898 -d ridge

Confirme el puerto configurado, el prefijo de datos, los permisos, las bibliotecas de tiempo de ejecución, los archivos TLS y que el oyente permanezca en bucle invertido. Ejecute ridged --check antes de iniciar un binario empaquetado.

El inicio o la negociación TLS fallan

Verifique que tanto el certificado como la clave estén configurados, sean legibles solo por la identidad del servicio y coincidan. La autenticación de contraseña Ridge se acepta solo dentro de su ruta TLS configurada. Verifique el modo del cliente TLS y evite asumir PostgreSQL SCRAM o asignación de certificado-usuario.

SQL es rechazado

Utilice el mensaje estructurado y SQLSTATE. Comprobar:

• una declaración limitada o modo de ejecución admitido;
• identificadores en minúsculas sin comillas;
• las formas exactas de SQL en grove/libs/ridge_sql/README.md;
• Ridge SHOW introspección en lugar de PostgreSQL catálogos;
• tipos de parámetros y límites de resultados;
• estado de la transacción después de un error anterior.

Una respuesta explícita y no respaldada no es evidencia de corrupción en el almacenamiento.

Una escritura desconectada

No lo repitas. Es posible que el servidor se haya confirmado antes de que se perdiera la respuesta. Vuelva a conectarse, inspeccione el objetivo mediante su clave primaria o de idempotencia y decida la siguiente acción desde el estado observado. Ridge Admin etiqueta este resultado como uncertain.

Conflicto de bloqueo o serialización

SQLSTATE 55P03 indica contención de bloqueo acotado. Los conflictos de transacciones también pueden surgir de la validación del encabezado esperado o de la clave única. Revierta la transacción fallida, actualice el estado y vuelva a intentarlo solo cuando la operación de la aplicación sea segura y limitada.

Ridge Admin no tiene local Ridge

Confirme que el binario del contrato 3 actual se esté ejecutando, que se pueda escribir en su almacén de perfiles con el modo 0600 y que ridged acepte conexiones en 127.0.0.1:7898. Reinicie Ridge Admin después de reemplazar el binario; Los tokens de lanzamiento y las sesiones se invalidan intencionalmente al reiniciar.

Posibles daños durante el almacenamiento

Detenga las mutaciones, conserve los registros y las rutas exactas, verifique el espacio disponible en el disco y ejecute la verificación integrity/backup compatible. Restaure a un nuevo destino y valídelo antes de la transición. Nunca repare archivos B+Tree, WAL, catálogo, índice o versión con un editor de archivos general.