postgres/es: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Descripción
2	2
3	3		Se puede utilizar FreePascal/Lazarus para acceder a un servidor de bases de datos (BB.DD). Si estás buscando más información sobre el paquete postgres en FPC,por favor visita el siguiente sitio [[postgres\|postgres#PostgreSQL_package:_the_low_level_units]].
4	4
5	5		Ventajas de PostgreSQL:
6	6
7	7		- Su uso está muy difundido y se puede obtener fácilmente.
8	8
9	9		<https://www.postgresql.org/> <https://www.openscg.com/bigsql/>
10	10
11	11		- Muy estable y contiene un conjunto de características muy completo.
12	12		- Licencia liberal (sin coste) en comparación con otras bases de datos.
13	13
14	14		Desventajas de PostgreSQL:
15	15
16	16		- Algunos hosters puede que no ofrezcan PostgreSQL.
17	17		- No existen versiones embebidas.
18	18
19	19		Win64: por favor mira [[Windows Programming Tips\|aquí]] si existen actualmente advertencias sobre no usar ciertas versiones FPC/Lazarus Win64.
20	20
21	21		ZEOS
22	22
23	23		Zeos soporta PostgreSQL y lo podemos utilizar con FreePascal y con Lazarus. Con Lazarus lo podemos añadir como paquete de forma que lo tengamos disponible en una nueva solapa del IDE. (adicionalmente puede que haya que instalar alguna versión de C++ portable dependiendo de con cual se haya compilado Zeos).
24	24
25	25		Se encuentra disponible para su descarga desde <http://sourceforge.net/projects/zeoslib/> , teniendo adicionalmente su foro en <http://zeoslib.sourceforge.net/>
26	26
27	27		Más información en [[ZeosDBO]]
28	28
29	29		## SQLDB
30	30
31	31		FPC/Lazarus soporta PostgreSQL de base con un componente/clase de conexión PostgreSQL. Si solamnete estás utilizando FPC o necestias añadir soporte para PostgreSQL, añade pqconnection a tu claúsula uses. En cualquer caso, Lazarus aporta un componente:
32	32
33	33		[center\|framed\|200px\|Solapa SQLDB en el IDE de Lazarus con los componentes de conexión a diferentes BB.DD, consulta, transacción, script, conector, cargador de librería ...](/wiki-images/c/c5/Sqldbcomponents.png%E2%80%8E)
34	34
35	35		Nota: El cliente libpq (escrito en lenguaje C) contiene alguna pérdida de memoria (al menos hasta la versión version 9.3 de Postgres, que a fecha de realizar esta traducción va por la 9.4.1) cuando la librería es cargada/descargada reiteradamente.
36	36
37	37		SQLDB carga la librería cuando se realiza la primera conexión, y la descarga cuando se cierra la última conexión. Esto significa que cada vez que la conexión se cierra, se produce una pequeña pérdida de memoria. Para prevenir que esto suceda (y acelerar el funcionamiento de la aplicación) puedes cargar la librería una vez al comienzo del proceso con la llamada InitialisePostgres3.
38	38
39	39		Se utiliza la propiedad charset para la codificación del cliente.
40	40
41	41		El componente TPQConnection no soporta directamente la propiedad Port, pero se puede pasar su valor al componente a través del parámetro Params:
42	42
43	43		``` pascal
44	44		PQConnection.Params.Add('port=' + VariableContainingPort);
45	45		```
46	46
47	47		Mediante la propiedad Params se pueden especificar adicionalmente otros parámetros de la conexión:
48	48
49	49		``` pascal
50	50		PQConnection.Params.Add('application_name=''yourappname''')
51	51		```
52	52
53	53		### Ejemplo
54	54
55	55		Ver [[SQLdb Tutorial1]] para acceder a un tutorial sobre como crear un programa con interface gráfico de usuario con conexión a bases de datos escrito para PostgreSQL/SQLDB, al igual que para SQLite/SQLDB, Firebird/SQLDB, y básicamente que soporte RDBMS SQLDB.
56	56
57	57		### Monitoreo de eventos
58	58
59	59		Si tienes FPC2.6.2+ y una versión reciente de Lazarus, entonces puedes utilizar el componente TPQTEventMonitor para monitorizar eventos provenientes de PostgreSQL.
60	60
61	61		Es un pequeño envoltorio de FPC PQEventMonitor; ver también el programa de ejemplo FPC pqeventstest.pp para más detalles.
62	62
63	63		### Installación y errores
64	64
65	65		Al igual que con todas las unidades sqldb, necesitas añadir una(s) librería(s) drivers (todas las librerias PostgreSQL .dll/ y ficheros de manifiesto .manifest):
66	66
67	67		- a un directorio en la ruta (de búsqueda de librerías) (e.g. c:\windows\system32 para windows)
68	68		- o (en Windows) al directorio de salida del programa (e.g. lib/algo/ donde algo es el directorio donde se encuentra el programa/proyecto que estemos desarrollando)
69	69
70	70		Por ejemplo, puede que pida algunas librerias extra además de libpg.dll:
71	71
72	72		intl.dll libeay32.dll libiconv-2.dll libiconv.dll libintl-8.dll libpq.dll libxml2.dll libxslt.dll ssleay32.dll
73	73
74	74		Es conveniente que obtengamos estas liberias de versión acorde con la de la versión del servidor a que nos conectemos, y en el caso de las que conllevan la seguridad posiblemente actualizadas de algún sitio de confianza o bien descargar sus fuentes y compilarlas.
75	75
76	76		#### Driver de 64 bit bajo
77	77
78	78		Si estás desarrollando aplicaciones de 64 bits entonces debes utilizar las librerías de 64 bit.
79	79
80	80		> Note: FPC 2.6.0 (por lo tanto Lazarus 1.0.4 o inferior) no soporta todavíad PostgreSQL bajo Windows 64 bit (a menos que se parchee y recompile).
81	81
82	82		Resulta bastante difícil de encontrar un driver de 64 bits pero se puede descargar uno desde el siguiente enlace [1](http://www.enterprisedb.com/products-services-training/pgdownload#windows).
83	83
84	84		La librería de driver se puede instalar en c:\windows\system32; las librerías de driver de 32 bit también se pueden instalar en c:\windows\syswow64 cuando tenemos un sistema operativo de 64 bits.
85	85
86	86		#### Error: "Can not load PostgreSQL client library "libpq.dll""
87	87
88	88		Si nos muestra este mensaje de error significa que no puede encontrar los ficheros (drivers)que son necesarios para conectar con PostgreSQL.
89	89
90	90		Ver las instrucciones de como instalar dichos drivers binarios.
91	91
92	92		Un buen ejemplo que demuestra como incluir ficheros librería cuando conectamos Lazarus con PostgreSQL (bajo windows) lo podemos encontrar en: [easyDB](http://paginas.fe.up.pt/~asousa/wiki/doku.php?id=proj:lazarus_projects#easy_db). Tener en cuenta que hay parámetros que es necesario cambiar de forma que se adapte a nuestra conexión local, como usuario, contraseña, si es una conexión local o en red. También que algún parámetro se toma a través de un fichero de configuración de Lazarus, que no viene definido en el código.
93	93
94	94		En Linux/Unix/OSX es necesario asegurarse de que dichas librerias se encuentren en los trayectos definidos de búsquedas, e.g.:
95	95
96	96		- En Linux añade el trayecto hacia el fichero libpq.so dentro de la sección de librerias /etc/fpc.cfg . Por ejemplo: -Fl/usr/local/pgsql/lib
97	97		- Puede que sea necesario crear un enlace simbólico hacia una una librería con una versión específica de forma que sea llamada cuando el programa llame a una librería de nombre genérico:
98	98		``` bash
99	99		ln -s /usr/lib/pqsql.so.5 /usr/lib/pqsql.so
100	100		```
101	101
102	102		Alternativamente, instala el paquete de cliente de PostgreSQL (pero la versión de desarrollo que acaba en -dev utilizando el gestor de paquetes de la distribución que utilices. El enlace simbólico es algo que se utiliza mucho para referenciar el nombre genérico frente a las posibles nuevas versiones que podemos por ejemplo descargar al margen de las disponibles en los repositorios oficiales de cada distro.
103	103
104	104		#### Problemas limpiando parámetros
105	105
106	106		> Note: Verifica esto: is .paramtype realmente necesario?
107	107
108	108		Al menos en FPC \<= 2.6.2: si tu limpias (.Clear) un parámetro (i.e. estableciendolo a NULL), PostgreSQL puede tener dificultades reconociendo el tipo de parámetro.
109	109
110	110		En este caso, se debe especificar esplícitamente el tipo, e.g.:
111	111
112	112		``` pascal
113	113		FWriteQuery.Params.ParamByName('LONGITUDE').ParamType:=ptInput; //requerido para PostgreSQL parameter type Inpunt
114	114		FWriteQuery.Params.ParamByName('LONGITUDE').Clear
115	115		```
116	116
117	117		## COMO HACER
118	118
119	119		### Uso de INSERT RETURNING
120	120
121	121		#### Obtener el último ID insertado
122	122
123	123		Con PostgreSQL no hay necesidad de realizar una segunda consulta para obtener el último ID insertado.
124	124
125	125		Uso de INSERT RETURNING y lectura de valor:
126	126
127	127		``` pascal
128	128		var
129	129		ID: Integer
130	130		..
131	131		Query.SQL.Text:= 'INSERT INTO myschema.films(film_name)' +
132	132		'VALUES(:film_name) RETURNING film_id;';
133	133		Query.Open;
134	134		ID:= Query.FieldByName('film_id').AsInteger;
135	135		```
136	136
137	137		El valor retornado film_id por la consulta SQL lo asignamos a ID (que ya definimos como una variable tipo Integer) y por ello también indicamos el tipo de valor en .AsInteger,
138	138
139	139		#### Obtener multiples campos y expresiones
140	140
141	141		RETURNING en PostgreSQL es más flexible que en la mayoría de los motores de bases de datos. Funciona con sentencias INSERT, UPDATE y DELETE y puede tener cualquier listado de campos, constantes o expresiones que podamos encontrar en un listado de SELECT.
142	142
143	143		``` SQL
144	144		INSERT INTO films (film_name) VALUE 'val' RETURNING film_id; -- Retorna id's para las nuevas filas creadas.
145	145		INSERT INTO films (film_name) VALUE 'val' RETURNING film_id, kind; -- Retorna los campos film_id y kind de las nuevas filas creadas.
146	146		INSERT INTO films (film_name) VALUE 'val' RETURNING *; -- Retorna todos los campos de las filas nuevas creadas.
147	147
148	148		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id; -- Retorna id´s de las filas actualizadas.
149	149		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id, film_name; -- Retorna id y film_name de las filas actualizadas.
150	150		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING *; -- Retorna todos los campos de las filas actualizadas.
151	151
152	152		DELETE FROM films RETURNING film_id; --Retorna los id's de las filas eliminadas.
153	153		DELETE FROM films RETURNING film_id, film_name; --Retorna id's y nombres de películas de las filas eliminadas.
154	154		DELETE FROM films RETURNING *; -- Retorna todos los campos de las filas eliminadas.
155	155		```
156	156
157	157		RETURNING utilizando campos, constante y expresiones:
158	158
159	159		``` SQL
160	160		INSERT INTO films (filmname) VALUE 'val' RETURNING id, 'a' AS a, id*2 AS doubled_id, CASE WHEN id > 100 THEN 'a' ELSE 'b' END AS foo;
161	161		```
162	162
163	163		.
164	164
165	165		## Paquete PostgreSQL package: las unidades de bajo nivel
166	166
167	167		Al igual que con el resto de bases de datos, el código SQLDB depende de una unidad PostgreSQL de bajo nivel que encapsula sobre la librería del driver de PostgreSQL (.so/.dll/.dylib). Normalmente, deberías utilizar el código de alto nivel de SQLDB ya que permite permite codificar más rápida y facilmente, cambiar de bases de datos facilmente, etc.
168	168
169	169		Su uso es bastante fácil, todo lo que necesitas es compilar algunas unidades y utilizarlas en tu programa. Necesitas especificar, eso si, el lugar en que se encuentra la librería cliente de PostgreSQL (libpq) para compilarlo y ya está, eso es todo.
170	170
171	171		La unidad principal se llama postgres, normalmente es la única unidad que debes incluir en la claúsula uses.
172	172
173	173		## Requerimientos
174	174
175	175		Se necesita al menos la versión 0.99.5 de FreePascal. Las cabeceras (headers) han sido portadas de la versión 6.3.1 de PostGreSQL. El uso de una versión anterior probablemente no funcione.
176	176
177	177		### Instalación
178	178
179	179		La unit postgres viene con los paquetes de FreePascal, y se distribuye junto con el compilador. Este contiene un directorio postgres con las units, un programa de test y un fichero make (makefile). En dicho directorio se puede editar el fichero makefile para establecer las variables que contiene adaptándolas al sistema que estemos utilizando. A priori solo debes adaptar una cosa:
180	180
181	181		- El directorio donde reside la librería libpq que habitualmente se encuentra en /usr/local/pgsql/lib
182	182
183	183		## Lo que se debe teclear
184	184
185	185		En primer lugar el mandato make que compilará las units y el programa:
186	186
187		-	~~`make`~~
	187	+	```text
	188	+	make
	189	+	```
188	190
189	191		Si la compilación se realiza con éxito, entonces podemos instalar el programa con el mandato:
190	192
191		-	~~`make install`~~
	193	+	```text
	194	+	make install
	195	+	```
192	196
193	197		(Recordar establecer el valor correcto del directorio donde las units deben ser instaladas)
194	198
195	199		A continuación es interesante realizar un test del programa con el mandato:
196	200
197		-	~~`make test`~~
	201	+	```text
	202	+	make test
	203	+	```
198	204
199	205		Esto realizará lo siguiente:
200	206
201	207		- Ejecutar el programa de test testpg, el cual se ha portado del programa de ejemplo de la guía de programadores de PostGreSQL.
202	208
203	209		- Ejecutar un script para crear una tabla dentro de la base de datos y rellenarla con datos. (el programa psql debería encontrarse en el PATH para que todo funcione bien). La base de datos que se utiliza por defecto es testdb.
204	210
205	211		- Ejecutar el programa de testeo testemail.
206	212
207	213		- Ejecutar el script en el shell de nuevo para eliminar la tabla creada una vez que tenemos verificado el funcionamiento.
208	214
209	215		Con todo esto obtenemos un montón de mensajes en pantalla que nos aportarán mucha información y resultados. En caso de que algo vaya mal, el mandato make nos informará convenientemente.
210	216
211	217		Planes futuros:
212	218
213	219		El interface de PostGreSQL es una pura traducción de los ficheros de cabecera en C que tiene PostGreSQL. Esto significa que las funciones utilizadas están poco pascalizadas. Sería interesante tener un interface OOP al estilo de Delphi por lo que ya se está trabajando en ello.
214	220
215	221		## Ver además
216	222
217	223		- [[TPSQL]] - Un conjunto diferente de componentes dataset/database de PostgreSQL.
218	224		- [[Lazarus DB Faq]] - Más acerca de programación de bases de datos.
219	225		- [[Lazarus Database Tutorial]] - Haciendo que Lazarus funcione con varias bases de datos.
220	226
221	227		Volver a [[Package List\|Packages List]]
222	228
223	229		---
224	230		From the Free Pascal wiki, page "postgres/es", as it stood on 2020-02-23 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
225	231		Category: Castellano
226	232		Category: Español

Back to history