SQLdb Package/es: what changed

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

Old	New		Line
1	1		El paquete SQLdb contiene las Unidades (units) de FPC que permiten el acceso a un gran número de Bases de Datos SQL. En Lazarus encontraremos el paquete sqldblaz.lpk que una vez compilado e instalado nos permitirá el acceso a sus componentes en el LCL dentro de la pestaña "SQLdb".
2	2
3		-	~~<figure>~~
4		-	~~<img src="sqldbcomponents.png‎" title="sqldbcomponents.png‎" />~~
5		-	~~<figcaption>sqldbcomponents.png‎</figcaption>~~
6		-	~~</figure>~~
	3	+	![](/wiki-images/c/c5/Sqldbcomponents.png%E2%80%8E)
7	4
8	5		## Documentación
9	6
10	7		Ver [Documentación sobre SQLDB](http://www.freepascal.org/docs-html/fcl/sqldb/index.html)
11	8
12	9		## Componentes
13	10
14	11		El paquete SQLdb proporciona los siguientes componentes:
15	12
16	13		#### TSQLQuery
17	14
18		-	~~<figure>~~
19		-	~~<img src="SQLdb_TSQLQuery.PNG‎" title="SQLdb_TSQLQuery.PNG‎" />~~
20		-	~~<figcaption>SQLdb_TSQLQuery.PNG‎</figcaption>~~
21		-	~~</figure>~~
	15	+	![](/wiki-images/8/8e/SQLdb_TSQLQuery.PNG%E2%80%8E)
22	16
23	17		Este es un descendiente de TDataset y proporciona los datos (procedentes de la consulta SQL realizada) en forma de Tabla. También puede ser empleado para ejecutar consultas SQL (e.g. procedimientos almacenados, INSER INTO...) que no retornan datos. Ver [[Working With TSQLQuery\|Trabajando con TSQLQuery]] para más detalles.. Documentación: ver [TSQLQuery](http://www.freepascal.org/docs-html/fcl/sqldb/tsqlquery.html)
24	18
25	19		En el inspector de objetos podemos ver:
26	20
27	21		Active: (valor por defecto: False).
28	22
29	23		AutoCalcFields: (valor por defecto: True).
30	24
31	25		Database:
32	26
33	27		DataSource:
34	28
35	29		DeleteSQL: (TStringList).
36	30
37	31		FieldDefs: (valor por defecto: 0 items).
38	32
39	33		FileName:
40	34
41	35		Filter:
42	36
43	37		Filtered:
44	38
45	39		IndexDefs: (valor por defecto: 0 items).
46	40
47	41		IndexFieldNames:
48	42
49	43		InsertSQL: Es un listado de cadenas que especifican la query para realizar el INSERT (TstringList). Caso de no definirse uno nos puede lanzar una excepción similar a esta:
50	44
51		-	~~<figure>~~
52		-	~~<img src="InsertSQLQueryNotExpecified.PNG" title=" center" />~~
53		-	~~<figcaption> center</figcaption>~~
54		-	~~</figure>~~
	45	+	![](/wiki-images/e/ed/InsertSQLQueryNotExpecified.PNG)
55	46
56	47		MaxIndexesCount: (valor por defecto: 2).
57	48
58	49		Name: (valor por defecto SQLQuery1).
59	50
60	51		Options: sqo = standar query option
61	52
62	53		- sqoAutoApplyUpdates: (valor por defecto: True).
63	54
64	55		- sqoAutoCommit: (valor por defecto: True).
65	56
66	57		- sqoCancelUpdatesOnRefresh: (valor por defecto: True).
67	58
68	59		- sqoKeepOpenOnCommit: (valor por defecto: True).
69	60
70	61		- sqoRefreshUsingSelect: (valor por defecto: True).
71	62
72	63		PacketRecords: (valor por defecto: 10).
73	64
74	65		ParamCheck: (valor por defecto: True).
75	66
76	67		Params: (valor por defecto: 0 items).
77	68
78	69		ParseSQL: (valor por defecto: True).
79	70
80	71		ReadOnly: (valor por defecto: True).
81	72
82	73		RefreshSQL: (TStringList).
83	74
84	75		Secuence:
85	76
86	77		ApplyEvent:
87	78
88	79		- saeOnNewRecord
89	80
90	81		- saeOnPost
91	82
92	83		FieldName.
93	84
94	85		IncrementBy: (valor por defecto: 1).
95	86
96	87		SecuenceName:
97	88
98	89		ServerFilter:
99	90
100	91		ServerFiltered: (valor por defecto: True).
101	92
102	93		ServerIndexDefs: (valor por defecto: 0 items).
103	94
104	95		SQL: (TStringList).
105	96
106	97		Tag: (valor por defecto: 0).
107	98
108	99		Transaction:
109	100
110	101		UniDerectional:
111	102
112	103		UpdateMode:
113	104
114	105		UpdateSQL:
115	106
116	107		UsePrimaryKeyAsKey: (valor por defecto: True).
117	108
118	109		#### TXXXConnection
119	110
120	111		Donde XXX es el tipo de Base de Datos a la cual nos vamos a conectar. Cada uno de estos componentes emplea una petición "standar" de los componentes SQLQuery y SQLTransaction, y los traduce a peticiones especificas de cada Base de Datos, permitiendo la abstracción sobre las características especificas de las mismas.
121	112
122	113		Estos objetos de conexión descienden del genérico TSQLConnection; se puede utilizar TSQLConnection para crear programas que utilicen bases de datos de forma que puedan conectar a múltiples bases de datos. (ver [[SQLdb Tutorial3]]).
123	114
124	115		Los componentes TXXXConnection que podremos emplear son:
125	116
126	117		- TIBConnection .............. Permite conexiones a BBDD Borland Interbase/Firebird
127	118		- TMSSQLConnection ...... ([[mssqlconn\|Microsoft SQL Server]], disponible desde la versión 2.6.1 de FPC & Lazarus 1.0.8) - mssqlconn.
128	119		- TMySQL40Connection ... Conexiones a BBDD MySQL 4.0 requiere la librería cliente MySQL 4.0) - mysql40conn
129	120		- TMySQL41Connection ... Conexiones a BBDD MySQL 4.1 requiere la librería cliente MySQL 4.1) - mysql41conn
130	121		- TMySQL50Connection ... Conexiones a BBDD MySQL 5.0requiere la librería cliente MySQL 5.0) - mysql50conn
131	122		- TMySQL51Connection ... Conexiones a BBDD MySQL 5.1requiere la librería cliente MySQL 5.1, disponible desde la versión 2.5.1 de FPC)
132	123		- TMySQL55Connection ... Conexiones a BBDD MySQL 5.5requiere la librería cliente MySQL 5.5 client library, available since FPC version 2.6.1/Lazarus 1.0.8)
133	124		- TMySQL56Connection ... Conexiones a BBDD MySQL 5.6 requiere la librería cliente MySQL 5.6) - mysql56conn
134	125		- TMySQL57Connection ... Conexiones a BBDD MySQL 5.7 requiere la librería cliente MySQL 5.7) - mysql57conn
135	126		- TODBCConnection ......... Para conexiones a BBDD mediante los drivers see [[ODBCConn\|ODBC]] instalados en el PC
136	127		- TOracleConnection ........ ''Para emplear con el motor ([[Lazarus Database Overview\|Oracle]])
137	128		- TPQConnection ............ Para emplear con BBDD ([[postgresql\|PostgreSQL]])
138	129		- TSybaseConnection ...... ''Para emplear con el motor ([[mssqlconn\|Sybase ASE]], disponible desde la versión 2.6.1 de FPC & Lazarus 1.0.8)
139	130		- TSQLite3Connection ..... Para emplear con el motor ([[SQLite]] - a partir de la versión 2.2.2 de FPC.
140	131
141	132		#### TSQLTransaction
142	133
143	134		Documentación: ver [documentación sobre TSQLTransaction](http://www.freepascal.org/docs-html/fcl/sqldb/tsqltransaction.html)
144	135
145	136		Encapsula las transacciones con el servidor de Bases de Datos. Un objeto TXXXConnection siempre necesita al menos otro del tipo TSQLTransaction asociado a el, de manera que las transacciones de las consultas sean gestionadas.
146	137
147	138		Las consultas/acciones en la base de datos necesitan encapsularse en:
148	139
149	140		- Un bloque .StartTransaction/.Commit (o .Rollback).
150	141		- O un simple .StartTransaction al comienzo, seguido por .CommitRetaining o .RollBackretaiing. CommitRetaining y RollbackRetaining mantienen la transacción abierta, por tanto no se necesita otra StartTransaction.
151	142
152	143		Estableciendo .Active a true si previamente estaba como false equivale a .StartTransaction
153	144
154	145		Estableciendo .Active a false si previamente estaba como true equivale a .Rollback
155	146
156	147		## Usando el paquete SQLdb
157	148
158	149		Para utilizar el paquete SQLdb son necesarios los componentes TSQLQuery y TSQLTransaction, además del componente TXXXConnection especifico para la conexión.
159	150
160	151		Aquí tenéis un breve tutorial:
161	152
162	153		- Asegurarse de tener el driver cliente apropiado para la base de datos a la que queremos conectar y que el servidor en el otro extremo esté activo y acepte conexiones (estando la base de datos creada con su(s) correspondientes tabla(s).
163	154		- Ir a la solapa SQLdb en la paleta de componentes.
164	155		- Añadir un componente TXXXConnection (conveniente para el tipo de base de datos que se esté utilizando) al formulario, y rellenar las propiedades necesarias para conectar a la base de datos. Estas variarán dependiendo de la base de datos actual. Hay que asegurarse de que la propiedad "connected" se puede establecer al valor true, caso contrario deberemos revisar los pasos previos también.
165	156		- Añadir un componente TSQLTransaction. Volver al componente Connection y establecer su propiedad "Transaction" a la nueva transacción. Esto debería establecer la propiedad transaction de la base de datos - chequearlo para asegurarse. Deberías ser capaz de establecer su valor a "true".
166	157		- Añadir un componente SQLQuery y establecer sus propiedades "Database" al componente de conexión que hemos añadido.
167	158		- Establecer la propiedad "SQL" de SQLQuery. Para un primer test realizar por ejemplo un "SELECT * FROM \<nombre_tabla\>" que selecciona todo el contenido de la tabla para la base de datos con la que se estableció la conexión.
168	159		- Establecer Active a True. Si funciona, se ha abierto una consulta (query) y el dato está disponible.
169	160
170	161		Desde este punto, añadir controles es igual que para cualquier otra base de datos, de todos modos recapitulemos:
171	162
172	163		- Añadir un componente TDatasource (desde la solapa "Data Access") y establecer su propiedad "dataset" al componente "SQLQuery".
173	164		- Añadir algunos controles desde la solapa "Data Access". Para una comprobación rápida se puede añadir un componente TDBGrid y establecer su "datasource" a la fuente de datos que se ha añadido. Con esto se deberían visualizar datos en el grid de acuerdo al resultado obtenido de la consulta que se haya realizado (por ejemplo: "SELECT * FROM \<nombre_tabla\>").
174	165
175	166		Por supuesto, esto es solamente el comienzo, pero obteniendo algunas datos en la grid suele ser usualmente el primer paso para asegurar que la conexión está funcionando. Se pueden encontrar explicaciones más detalladas en [[Working With TSQLQuery]].
176	167
177	168		Aparte de la GRID podemos añadir componentes de la solapa Data Controls. Una vez que la GRID presenta datos, con estos componentes podemos mostrar valores individuales por ejemplo de uno o varios campos de un registro en modo texto (para ello seleccionamos en el inspector de objetos su fuente de datos y el campo que nos interese, o bien imágenes con un TDBImage (en este caso son valores binarios de tipo blob/bytea que debemos crear previamente a su uso en la tabla que utilicemos). Nos podemos mover de uno a otro registro con un TDBNavigator de forma sencilla que nos permite movernos por el dataset con next,prior...
178	169
179	170		## Notas
180	171
181	172		Se pueden encontrar más detalles en [[SQLdb Programming Reference]]
182	173
183	174		Las páginas relacionadas con el paquete SQLdb fueron inicialmente escritas a partir de observaciones realizadas utilizando TPQConnection, PostgreSQL 8.1 bajo WinXP. Es de esperar resultados similares para otras bases de datos, de modo que si alguien los puede confirmar vendría bien tener aquí unas anotaciones del resultado.
184	175
185	176		Parece funcionar de modo similar en MySQL 5.0.45 bajo Win XP. La propiedad 'active' de TSQLTransaction no puede ser establecida a true, pero los datos obtenidos de la base de datos se pueden visualizar en el componente TDbGrid (se encuentra en la solapa DataControls).
186	177
187	178		Se puede encontrar algo más de información (notas y documentación) en el siguientes enlace:
188	179
189	180		<http://z505.com/cgi-bin/powtils/docs/1.6/idx.cgi?file=fcldbnotes>
190	181
191	182		Para ver el listados de clases disponibles para esta interfaz ir a:
192	183
193	184		<http://z505.com/cgi-bin/powtils/docs/1.6/idx.cgi?file=index-4&unit=sqldb>
194	185
195	186		--Jagluiperd 00:54, 11 September 2010 (CEST)
196	187
197	188		---
198	189		From the Free Pascal wiki, page "SQLdb Package/es", as it stood on 2017-06-19 after a change by Jma sp, 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).
199	190		Category: Castellano
200	191		Category: Español

Back to history