Compilar PostgreSQL 9.2.4 con soporte para pldebugger en Debian 6

# adduser postgres

Cuando se nos pregunte la contraseña le podremos la que deseemos, pero deberemos recordarla, ya que se nos pedirá en un futuro.

9.3 Crear e inicializar el directorio de datos

El siguiente paso será crear e inicializar el directorio de datos, donde PostgreSQL guardará la información:

# mkdir /usr/local/pgsql/data

Hacemos propietario de este directorio al usuario postgres:

# chown postgres /usr/local/pgsql/data

A continuación asumimos la identidad del usuario postgres para inicializar el directorio de datos:

# su - postgres

y finalmente inicializamos el directorio de datos:

$ initdb -D /usr/local/pgsql/data

Llegados a este punto, y si todo ha ido bien, el deberemos ver en nuestra terminal algo parecido a esto

Success. You can now start the database server using:

    postgres -D /usr/local/pgsql/data
or
    pg_ctl -D /usr/local/pgsql/data -l logfile start

En este momento, tal y como indica el sistema podremos arrancar la base de datos en primer plano con:

#  postgres -D /usr/local/pgsql/data

y detenerla simplemente pulsando la combinación de teclas Ctr-C

Si deseamos arrancar la base de datos en segundo plano, lo haremos usando la segunda opción:

#   pg_ctl -D /usr/local/pgsql/data -l logfile start

y la detendremos con el siguiente comando:

$  pg_ctl -D /var/pgsql/data stop -m fast

9.4 Configurar contraseña de acceso a la base de datos para el usuario postgres

Para configurar la contraseña de acceso del usuario postgres a la base de datos, lo primero que habrá que hacer lógicamente es iniciar el servidor:

#   pg_ctl -D /usr/local/pgsql/data -l logfile start

Una vez iniciado el servidor, y manteniendo en el sistema la identidad del usuario postgres, accederemos al interprete de ordenes de PostgreSQL:

$psql

Una vez dentro, escribiremos:

postgres=# alter user postgres with password ‘passwd’;

donde passwd es la nueva contraseña que deseamos poner.El sistema debe responder con un:

ALTER ROLE
postgres=#

Salimos del cliente de linea de ordenes con la orden:

postgres=#\q 

Y salimos de la cuenta en el sistema del usuario postgres con un simple:

$exit 

9.5 Crear script de arranque automático

Para hacer que PostgreSQL se ejecute automáticamente al iniciar el sistema, debemos copiar desde el directorio /contrib/start-scripts del arbol del código fuente de postgreSQL, el fichero denominado linux al directorio /etc/init.d. En este punto de la instalación, deberíamos estar en el directorio ./postgresql-9.2.4/contrib/pldebugger, por lo que ejecutaremos el siguiente comando:

#  cp ../start-scripts/linux /etc/init.d/postgresql

Una vez copiado el script, debemos editarlo para añadirle las etiquetas LSB. Para ello, añadiremos al comienzo del fichero /etc/init.d/posgresql, justo debajo de #! /bin/sh las siguientes líneas:

### BEGIN INIT INFO
# Provides:          PostgreSQL
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start Postgresql at boot time
# Description:       Enable service provided by daemon.
### END INIT INFO

Además, debemos dar permisos de ejecución al script, con el siguiente comando:

#  chmod 755 /etc/init.d/postgresql

Con ello, podremos arrancar y parar postgresql con el tipico comando:

#  /etc/init.d/postgresql accion

donde accion representa alguna de las siguientes posibles acciones:

• start Arranca el servidor de bases de datos.
• stop Detiene el servidor de bases de datos.
• restart Detiene el servidor de bases de datos, y lo vuelve a arrancar.
• reload Recarga la configuración del servidor de bases de datos.
• status Informa si el servidor de bases de datos se esta ejecutando o no.

Por último, debemos añadir el script de inicio de PostgreSQL a los scripts de arranque del sistema, para lo cual ejecutaremos el siguiente comando:

#  update-rc.d postgresql defaults

Si por alguna razón deseamos eliminar el script de la secuencia de arranque, deberemos ejecutar el comando:

#  update-rc.d -f postgresql remove

9.6 Editar el fichero postgresql.conf

El siguiente paso es editar el fichero /usr/local/pgsql/data/postgresql.conf para, por un lado permitir que el servidor escuche por todas las interfaces de red, y por otro lado, indicarle que cargue el plugin pldebugger.

Para permitir que el servidor escuche por todas las interfaces de red, buscaremos la línea:

#listen-addresses = 'localhost' 

(suele ser la línea 59), la copiamos debajo, la descomentamos, y la modificamos quedando :

listen-addresses = '*' 

Si se quisera que PostgreSQL escuchase sólo las peticiones de determinadas IPs, bastaría con poner estas IPs separadas por comas, y todo el conjunto entre comillas simples. Por ejemplo:

listen-addresses = '192.168.0.2,192.168.0.3'

Nota: por custiones de seguridad no se recomienda permitir el acceso desde cualquier máquina.

Para indicarle a PostgreSQL que cargue el plugin pldebugger al arrancar, buscaremos la línea:

#shared_preload_libraries = ''          # (change requires restart)

(suele ser la línea 127), la copiamos debajo, la descomentamos, y la modificamos quedando :

shared_pbeload_libraries = '$libdir/plugin_debugger' # (change requires restart)

9.7 Configurar permisos de acceso

9.7.1 Configurar permisos de acceso local:

Al compilar desde las fuentes, PostgreSQL es muy poco restrictivo a la hora de gestionar permisos, ya que por defecto, permite a todos los usuarios del sistema el acceso sin contraseña. Por ello deberemos restringir ciertos permisos locales.

Para ello debemos editar el fichero /usr/local/pgsql/data/pg_hba.conf
Buscaremos la línea cuyo contenido es:

local all all trust

y la modificamos de forma que quede:

local all all md5

Con ello permitimos el acceso a cualquier cuenta de usuario desde la maquina local siempre que se especifique una contraseña encriptada mediante md5. Ello implica que al reinicar el servidor podremos acceder al cliente de linea de ordenes de PostgreSQL desde cualquier cuenta de usuario con la cuenta de postgres, escribiendo:

$psql -U postgres -W 

9.7.2 Configurar permisos de acceso remoto:

Por último, debemos configurar los permisos de acceso remoto. Se trata de responder a las siguientes preguntas:

• ¿Que usuarios tienen permisos para conectarse?
• ¿Desde que IPs se pueden conectar?
• ¿A que bases de datos?
• ¿Y.. que método de auteticación tienen que usar?

En este post, daremos permisos a todos los usuarios de la base de datos, para conectarse a todas las bases de datos, desde cualquier IP, usando una contraseña encriptada con MD5.

Esto lo lograremos editando de nuevo el fichero /usr/local/pgsql/data/pg_hba.conf y localizando la línea:

host all all 127.0.0.1/32 trust

y la modificandola forma que quede:

host all all 0.0.0.0 0.0.0.0 md5

Una explicación sencilla de esta regla de permisos del fichero /etc/postgresql/9.2/main/pg_hba.conf seria:

• host: Indica que la regla se refiere a conexiones remotas
• all: Responde a la pregunta ¿Que usuarios tienen permiso para conectarse?. En este caso todos.Si quisieramos especificar un usuario determinado, bastaría con sustituir “all” por el nombre del usuario deseado. Si queremos aplicar la misma regla a varios usuarios, tendremos que copiar y pegar la regla, cambiando el nombre de usuario.
• all: Responde a la pregunta ¿A que bases de datos?. En este caso a todas .Si quisieramos especificar una base de datos determinada, bastaría con sustituir “all” por el nombre de la base de datos deseada. Si queremos aplicar la misma regla a varios bases de datos, tendremos que copiar y pegar la regla, cambiando el nombre de la base de datos.
• 0.0.0.0 0.0.0.0: Responde a la pregunta ¿Desde que IPs se pueden conectar?. En este caso desde todas. el primer grupo de 4 digitos especifca la IP, mientras que el segundo es la mascara de red. Los valores 0.0.0.0 son valores comodin, cuyo significado es “cualquier IP” y “cualquier mascara” respectivamente.
• md5: Responde a la pregunta ¿Que método de auteticación tienen que usar?. En este caso una contraseña encriptada con MD5. Otros posibles valores son : “passowrd” para una contraseña sin encriptar o “trust” para permitir un acceso sin contraseña

Para una mayor información sobre como funciona el fichero /etc/postgresql/9.2/main/pg_hba.conf se puede consultar la documentación oficial en castellano en la dirección: http://www.postgresql.org/docs/9.2/interactive/auth-pg-hba-conf.html

Finalmente inhabilitaremos las conexiones locales a través de IP6, para lo cual, localizaremos la línea:

host all all ::1/128 trust

y la comentaremos de forma que quede:

#host all all ::1/128 trust

10.- Reiniciar el servidor

Para comprobar que todo ha ido bien, que el script de autoarranque esta correctamente instalado, y que las configuraciones definidas en la base de datos son correctas, Debemos reiniciar la máquina servidora. Para ello, ejecutaremos las siguiente instrucción:

# reboot

11.- Probar el depurador

Para probar el depuraror, lo primero que hemos de hacer es crear una base de datos de prueba,con una tabla de prueba, y con un procedimiento almacenado de prueba que podamos depurar.

11.1.- Acceder al interprete de PostgreSQL

Accedemos al interprete de comandos de PostgresSQL con la siguiente instrucción:

$ psql -U postgres -W

11.2.- Crear base de datos de prueba

Una vez dentro del interprete de comandos de PostgresSQL creamos la base de datos con el siguiente comando:

postgres=# CREATE DATABASE prueba_debugger WITH ENCODING='UTF8';

11.3.- Crear tabla de pruebas

Nos conectamos a la base de datos que acabamos de crear:

postgres=# \c prueba_debugger

y el sistema responde con:

You are now connected to database "prueba_debugger".

A continuación creamos la la tabla de pruebas

prueba_debugger=# CREATE TABLE tabla_prueba (
	               Id BIGSERIAL PRIMARY KEY ,
	               Valor VARCHAR (255) default ''
                  );

y el sistema responde con:

NOTICE:  CREATE TABLE will create implicit sequence "tabla_prueba_id_seq" for serial column "tabla_prueba.id"
NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "tabla_prueba_pkey" for table "tabla_prueba"
CREATE TABLE

11.4.- Crear procedimiento almacenado de prueba

Seguimos creando objetos en la base de datos de prueba. En este punto crearemos un procedimiento almacenado:

+

prueba_debugger=#
CREATE OR REPLACE FUNCTION tabla_prueba_trigger() RETURNS TRIGGER AS $tabla_prueba_trigger$
  DECLARE
	sValor VARCHAR (255):= NEW.Valor;
	iId INTEGER:= NEW.Id;
	iCalculo INTEGER:= 0;
  BEGIN
   RAISE NOTICE '---------- INICIO prueba_debugger.tabla_prueba_trigger() ----------';
   RAISE NOTICE '---------- => El nuevo registro tiene un Id: %',iId;
   RAISE NOTICE '---------- => El nuevo registro tiene un Valor: %',sValor;
   iCalculo=iId +5;
   RAISE NOTICE '---------- => El Id del nuevo registro +5 es igual a: %',iCalculo;
   RAISE NOTICE '---------- FIN prueba_debugger.tabla_prueba_trigger() -------------';
   NEW.Id= iCalculo;
   RETURN NEW;
  END;

Nota: para introducir el procedimiento almacenado desde la consola de PostgreSQL copiaremos todo el procedimiento almacenado y pulsaremos la tecla Enter.
A continuación le indicamos a PostgreSQL el lenguaje en el que está escrito el procedimiento almacenado:

prueba_debugger=# $tabla_prueba_trigger$ LANGUAGE plpgsql;

Despues de introducir el comando anterior y pulsar la tecla Enter, el sistema debe responder con:

 CREATE FUNCTION

11.5.- Crear disparador para lanzar el procedimiento almacenado de prueba

Crearemos un disparador que lanzará el procedimiento almacenado después de cada inserción:

prueba_debugger=# CREATE TRIGGER update_tabla_prueba AFTER INSERT
                  ON tabla_prueba FOR EACH ROW EXECUTE PROCEDURE  tabla_prueba_trigger();

y el sistema responde con:

 CREATE TRIGGER

11.6.- Ejecutar el script de preparacion para la depuración

Para poder depurar los procedimientos almacenados, es necesario que antes hayamos ejecutado en la base de datos donde queremos hacer la depuración el siguiente comando:

prueba_debugger=# CREATE EXTENSION pldbgapi;

el sistema responderá con:

CREATE EXTENSION

Una vez ejecutado el comando, ya podemos conectarnos a la base de datos desde pgAdminIII y usar la función de depuración.

Nota: Debemos ejecutar este comando en cada base de datos donde deseemos usar la funcionalidad de depuración.

&ld;/p>

11.7.- Probar el depurador

Finalmente, obtendremos la recompensa a nuestro esfuerzo, al abrir pgAdminIII, abrir la base de datos de prueba que hemos creado, abrir el esquema public, abrir la tabla tabla_prueba desplegar la sección Trigger-Functions, y sobre nuestra función, hacer click con el boton derecho, y seleccionar la opción “Set breakpoint”

Estableciendo punto de ruptura con pgAdminIII

En la siguiente captura podemos ver el depurador en acción:

Depurador pgAdminIII en acción

Esta entrada está también disponible en English.