Descripción

postgres es el servidor de base de datos de PostgreSQL. Para que una aplicación cliente acceda a una base de datos, debe conectarse (a través de la red o localmente) a una instancia de postgres en ejecución. La instancia de postgres inicia entonces un proceso de servidor independiente para gestionar la conexión.

Una instancia de postgres siempre gestiona los datos de exactamente un clúster de bases de datos. Un clúster de bases de datos es una colección de bases de datos que se almacena en una ubicación común del sistema de archivos (el “área de datos”). Se puede ejecutar más de una instancia de postgres en un sistema al mismo tiempo, siempre y cuando utilicen diferentes áreas de datos y diferentes puertos de comunicación (véase más abajo). Cuando postgres se inicia, necesita saber la ubicación del área de datos. La ubicación debe especificarse mediante la opción -D o la variable de entorno PGDATA; no hay un valor predeterminado. Típicamente, -D o PGDATA apuntan directamente al directorio del área de datos creado por initdb. Otros diseños de archivos posibles se discuten en Section 19.2.

Por defecto, postgres se inicia en primer plano e imprime los mensajes de registro en el flujo de error estándar. En aplicaciones prácticas, postgres debería iniciarse como un proceso en segundo plano, quizás durante el arranque del sistema.

El comando postgres también se puede invocar en modo monousuario (single-user mode). El uso principal de este modo es durante la inicialización por parte de initdb. A veces se utiliza para la depuración o la recuperación ante desastres; ten en cuenta que ejecutar un servidor en modo monousuario no es realmente adecuado para depurar el servidor, ya que no habrá comunicación entre procesos ni bloqueo realistas. Cuando se invoca en modo monousuario desde la consola (shell), el usuario puede introducir consultas y los resultados se imprimirán en la pantalla, pero en un formato que es más útil para los desarrolladores que para los usuarios finales. En el modo monousuario, el usuario de la sesión se establecerá como el usuario con ID 1, y se conceden poderes implícitos de superusuario a este usuario. Este usuario no tiene que existir realmente, por lo que el modo monousuario se puede utilizar para recuperarse manualmente de ciertos tipos de daños accidentales en los catálogos del sistema.

Opciones

postgres acepta los siguientes argumentos de línea de comandos. Para una discusión detallada de las opciones, consulta Chapter 19. Puedes ahorrarte escribir la mayoría de estas opciones configurando un archivo de configuración. Algunas opciones (seguras) también se pueden establecer desde el cliente que se conecta de una manera dependiente de la aplicación para que se apliquen únicamente a esa sesión. Por ejemplo, si la variable de entorno PGOPTIONS está establecida, los clientes basados en libpq pasarán esa cadena al servidor, el cual la interpretará como opciones de línea de comandos de postgres.

Entorno

Diagnósticos

Un mensaje de fallo que mencione semget o shmget probablemente indica que necesitas configurar tu núcleo (kernel) para proporcionar suficiente memoria compartida y semáforos. Para una discusión más detallada, consulta Section 18.4. Es posible que puedas posponer la reconfiguración de tu núcleo reduciendo shared_buffers para disminuir el consumo de memoria compartida de PostgreSQL, y/o reduciendo max_connections para reducir el consumo de semáforos.

Un mensaje de fallo que sugiera que ya se está ejecutando otro servidor debe comprobarse cuidadosamente, por ejemplo mediante el comando

$ ps ax | grep postgres

o

$ ps -ef | grep postgres

dependiendo de tu sistema. Si tienes la certeza de que no hay ningún servidor en conflicto ejecutándose, puedes eliminar el archivo de bloqueo (lock file) mencionado en el mensaje e intentarlo de nuevo.

Un mensaje de fallo que indique la imposibilidad de enlazarse a un puerto podría indicar que ese puerto ya está en uso por algún proceso que no es de PostgreSQL. También podrías obtener este error si terminas postgres e inmediatamente lo reinicias utilizando el mismo puerto; en este caso, simplemente debes esperar unos segundos hasta que el sistema operativo cierre el puerto antes de intentarlo de nuevo. Finalmente, podrías obtener este error si especificas un número de puerto que tu sistema operativo considera que está reservado. Por ejemplo, muchas versiones de Unix consideran que los números de puerto inferiores a 1024 son “confiables” y solo permiten que el superusuario de Unix acceda a ellos.

Notas

El comando de utilidad pg_ctl se puede utilizar para iniciar y detener el servidor postgres de forma segura y cómoda.

Si es posible, no utilices SIGKILL para matar el servidor postgres principal. Hacerlo evitará que postgres libere los recursos del sistema (por ejemplo, memoria compartida y semáforos) que posee antes de terminar. Esto podría causar problemas para iniciar una nueva ejecución de postgres.

Para terminar el servidor postgres normalmente, se pueden utilizar las señales SIGTERM, SIGINT o SIGQUIT. La primera esperará a que todos los clientes terminen antes de salir, la segunda desconectará a todos los clientes por la fuerza y la tercera saldrá inmediatamente sin un apagado adecuado, lo que resultará en una ejecución de recuperación durante el reinicio.

La señal SIGHUP volverá a cargar los archivos de configuración del servidor. También es posible enviar SIGHUP a un proceso de servidor individual, pero eso no suele ser sensato.

Para cancelar una consulta en ejecución, envía la señal SIGINT al proceso que ejecuta ese comando. Para terminar un proceso backend de forma limpia, envía SIGTERM a ese proceso. Consulta también pg_cancel_backend y pg_terminate_backend en Section 9.28.2 para los equivalentes ejecutables en SQL de estas dos acciones.

El servidor postgres utiliza SIGQUIT para indicar a los procesos de servidor subordinados que terminen sin una limpieza normal. Esta señal no debe ser utilizada por los usuarios. También es imprudente enviar SIGKILL a un proceso de servidor — el proceso principal postgres interpretará esto como una caída y forzará a todos los procesos hermanos a salir como parte de su procedimiento estándar de recuperación de caídas.

Errores (Bugs)

Las opciones -- no funcionarán en FreeBSD o OpenBSD. Utiliza -c en su lugar. Este es un error en los sistemas operativos afectados; una versión futura de PostgreSQL proporcionará una solución alternativa si esto no se soluciona.

Modo monousuario

Para iniciar un servidor en modo monousuario, utiliza un comando como

postgres --single -D /usr/local/pgsql/data other-options my_database

Proporciona la ruta correcta al directorio de la base de datos con -D, o asegúrate de que la variable de entorno PGDATA esté establecida. Especifica también el nombre de la base de datos en particular en la que deseas trabajar.

Normalmente, el servidor en modo monousuario trata el salto de línea como el terminador de entrada de comandos; no hay inteligencia sobre los puntos y comas, como la hay en psql. Para continuar un comando en varias líneas, debes escribir una barra invertida (backslash) justo antes de cada salto de línea excepto el último. La barra invertida y el salto de línea adyacente se eliminan de la entrada del comando. Ten en cuenta que esto sucederá incluso cuando esté dentro de una cadena literal o un comentario.

Pero si utilizas el interruptor de línea de comandos -j, un único salto de línea no termina la entrada del comando; en su lugar, lo hace la secuencia punto y coma-salto de línea-salto de línea. Es decir, escribe un punto y coma inmediatamente seguido de una línea completamente vacía. La barra invertida-salto de línea no se trata de forma especial en este modo. De nuevo, no hay inteligencia sobre el hecho de que dicha secuencia aparezca dentro de una cadena literal o comentario.

En cualquier modo de entrada, si escribes un punto y coma que no esté justo antes o que no forme parte de un terminador de entrada de comandos, se considera un separador de comandos. Cuando escribas un terminador de entrada de comandos, las múltiples sentencias que hayas introducido se ejecutarán como una única transacción.

Para salir de la sesión, escribe EOF (Control+D, por lo general). Si has introducido algún texto desde el último terminador de entrada de comandos, entonces EOF se tomará como un terminador de entrada de comandos, y se necesitará otro EOF para salir.

Ten en cuenta que el servidor en modo monousuario no proporciona características sofisticadas de edición de líneas (no hay historial de comandos, por ejemplo). El modo monousuario tampoco realiza ningún procesamiento en segundo plano, como puntos de control (checkpoints) automáticos o replicación.

Ejemplos

Para iniciar postgres en segundo plano utilizando los valores predeterminados, ejecuta:

$ nohup postgres >logfile 2>&1 </dev/null &

Para iniciar postgres con un puerto específico, por ejemplo, 1234:

$ postgres -p 1234

Para conectarse a este servidor utilizando psql, especifica este puerto con la opción -p:

$ psql -p 1234

o establece la variable de entorno PGPORT:

$ export PGPORT=1234
$ psql

Los parámetros de tiempo de ejecución con nombre se pueden establecer en cualquiera de estos estilos:

$ postgres -c work_mem=1234
$ postgres --work-mem=1234

Cualquiera de las dos formas anula cualquier configuración que pueda existir para work_mem en postgresql.conf. Observa que los guiones bajos en los nombres de los parámetros se pueden escribir como guion bajo o guion en la línea de comandos. Excepto para experimentos a corto plazo, es probablemente mejor práctica editar la configuración en postgresql.conf que confiar en un interruptor de línea de comandos para establecer un parámetro.

Véase también

initdb, pg_ctl