libpq C++ Binding

libpq++ es la API C++ API para Postgres. libpq++ es un conjunto de clases que permiten a los programas cliente conectarse al servidor de Postgres. Estas conexiones vienen de dos formas: una Clase de Base de Datos, y una clase de Objetos Grandes.

La Clase de Base de datos est� pensada para manipular una base de datos. Puede usted enviar toda suerte de consultas SQL al servidor Postgres, y recibir las repuestas del servidor.

La Clase de Objetos Grandes est� pensada para manipular los objetos grandes en la base de datos. Aunque una instancia de Objetos Grandes puede enviar consultas normales al servidor de Postgres, s�lo est� pensado para consultas sencillas que no devuelven ning�n dato. Un objeto grande se deber�a ver como una cadena de un fichero. En el futuro, deber�a comportarse de forma muy pr�xima a las cadenas de fichero de C++ cin, cout y cerr.

Este cap�tulo est� basado en la documentaci�n para la librer�a C libpq. Al final de esta secci�n se listan tres programas cortos como ejemplo de programaci�n con libpq++ (aunque no necesariamente de una buena programaci�n). Hay muchos tipos de aplicaciones libpq++ en src/libpq++/examples, incluyendo el c�digo fuente de los tres ejemplos expuestos en este cap�tulo.

Control e Inicializaci�n

Variables de Entorno.

Las siguientes variables de entorno se pueden utilizar para fijar variables de defecto para un entorno, y para evitar codificar nombres de la base de datos en un programa de aplicaci�n:

Nota

Dir�jase a libpq para conseguir una lista completa de opciones de conexi�n.

Las siguientes variables de entorno se pueden utilizar para seleccionar valores de par�metros de conexi�n de defecto, que ser�n utilizados por PQconnectdb o PQsetdbLogin si no se ha especificado directamente ning�n otro valor por parte del c�digo que realiza la llamada. Son utilizables para impedir la codificaci�n de nombres de base de datos en programas de aplicaci�n sencillos.

Nota

libpq++ utiliza s�lo variables de entorno o cadenas del tipo conninfo de PQconnectdb.

  • PGHOST fija el nombre del ordenador servidor de defecto. Si se especifica una cadena de longitud distinta de 0, se utiliza comunicaci�n TCP/IP. Sin un nombre de host, libpq conectar� utilizando una conexi�n (un socket) del dominio Unix local.

  • PGPORT fija el puerto de defecto o la extensi�n del fichero de conexi�n del dominio Unix local para la comunicaci�n con el servidor Postgres.

  • PGDATABASE fija el nomber de la base de datos Postgres de defecto.

  • PGUSER fija el nombre de usuario utilizado para conectarse a la base de datos y para la autenticaci�n.

  • PGPASSWORD fija la palabra de paso utilizada si el servidor solicita autenticaci�n de la palabra de paso.

  • PGREALM fija el reino Kerberos a utilizar con Postgres, si es diferente del reino local. Si se fija PGREALM, las aplicaciones Postgres intentar�n la autenticaci�n con los servidores de este reino, y utilizar�n ficheros de ticket separados, para impedir conflictos con los ficheros de ticket locales. Esta variable de entorno s�lo se utiliza si el servidor selecciona la autenticaci�n Kerberos.

  • PGOPTIONS fija opciones de tiempo de ejecuci�n adicionales para el servidor de Postgres.

  • PGTTY fija el fichero o tty al cual el servidor enviar� los mensajes de seguimiento de la ejecuci�n.

Las siguientes variables de entorno se pueden utilizar para especificar el comportamiento de defecto para los usuarios para cada sesi�n de Postgres:

  • PGDATESTYLE fija el estilo de defecto de la representaci�n de fecha/hora.

  • PGTZ fija la zona horaria de defecto.

Las siguientes variables de entorno se pueden utilizar para especificar el comportamiento interno de defecto para cada sesion de Postgres:

  • PGGEQO fija el modo de defecto para el optimizador gen�rico.

Encontrar� informaci�n sobre los valores correctos de estas variables de entorno en el comando SET de SQL.