Databases/es: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		Trabajo en curso...
2	2
3	3		## Introducción
4	4
5	5		Esta página será una introducción al tema "Lazarus y las bases de datos. La tabla que sigue proporciona una visión general sobre las bases de datos soportadas. Es necesario actualizarla en breve, ya que se basa en el momento en que FPC 1.9.7 fue liberado. Advertencia: Sólo debe instalar los componentes de base de datos para los que ha instalado las librerías cliente, si la base de datos necesita de ellas; de lo contrario Lazarus podría no iniciarse debido a que faltan archivos. A continuación, no tendrías más remedio que volver a instalar Lazarus, porque desinstalar el componente no es posible. (En realidad no es tan grave, hay una alternativa: borrar el nombre del paquete o paquetes del archivo staticpackages.inc -en las últimas versiones este archivo se crea a partir del contenido de miscellaneousoptions.xml, y es este el archivo que hay que editar- y compilar el IDE desde la línea de órdenes con lazbuild --build-ide=)
6	6
7	7		### Bases de Datos soportadas
8	8
9	9		<thead>
10	10
11	11		de Datos</strong></th>
12	12
13	13		Paquete</strong></th>
14	14
15	15		librerías?</strong></th>
16	16
17	17		servidor?</strong></th>
18	18
19	19		compatibles</strong></th>
20	20
21	21		compatibles</strong></th>
22	22
23	23		</thead>
24	24		<tbody>
25	25
26	26		</tbody>
27	27
28	28		[[Databases/es\|Nota (1)]] Se puede utilizar una versión embebida de Firebird en Windows y Linux(posiblemente en macOS también), o puede conectarse a un servidor Firebird que corre en Windows/Unix/macOS/FreeBSD/y otras plataformas soportadas por Firebird.
29	29
30	30		[[Databases/es\|Nota (2)]] Estos conectores utilizan la librería FreeTDS como driver. La documentación FreeTDS indica que debería contruir en al menos estas plataformas.
31	31
32	32		[[Databases/es\|Nota (3)]] Este número de versión se refiere al estándar ODBC, no al número de versión de un controlador o un gestor de controladores. Hay controladores ODBC 3.x para la mayoría de los DBMS.
33	33
34	34		## Los enlaces con los clientes de base de datos
35	35
36	36		Si deseas utilizar alguna de las bases de datos que requieren de librerías cliente entonces dichas librerias tienen tienen que estar instaladas,no sólo en el equipo en que se programa, sino también en los equipos en que sen ejecutará la aplicación. Ten en cuenta que algunas bases de datos (MySQL, en particular) sólo funcionará si los vínculos usados al compilar la aplicación son de la misma versión que los de las librerías instaladas. Puedes averiguar cómo instalar las librerías (archivos .so en sistemas nix, y .dll en windows) en la página web de los desarrolladores de la base de datos. Las unidades de enlace se pueden encontrar en los directorios base de los paquetes base en el fuente FPC. Básicamente consisten en llamadas al API* de cliente como mysql_connect_database, que son completamente diferentes para cada base de datos. Es posible escribir aplicaciones de base de datos utilizando estas unidades, pero por lo general implica mucho más trabajo y se hace propenso a errores que la opción de utilizar los componentes de la unidad DB de Lazarus.
37	37
38	38		La mayoría de estos paquetes de enlace están muy vinculadas a la librería clientes. Esto implica que si la aplicación se compila con una de estas unidades, toda la aplicación no podrá enlazarse si las librerías cliente no están disponibles en el equipo.Esto significa que tu programa ejecutable no se generará si no tienes instalado - por ejemplo - un cliente MySQL en tu ordenador y en cambio estás utilizando la unidad mysql14.pp.
39	39
40	40		Si tienes éxito al compilar el programa en un equipo que tiene instaladas las librerias cliente de MySQL, ni siquiera se iniciará en otra máquina sin las librerías MySQL adecuadas. En otras palabras: para estas bases de datos, es necesario instalar las librerías de cliente en el equipo de desarrollo, y es necesario instalar estas bibliotecas de cliente con tu aplicación para que también funcione en otros equipos.
41	41
42	42		Para evitar estos problemas algunos de los paquetes también son capaces de enlazar dinámicamente las librerías. Antes de hacer cualquier llamada a la librería, la unidad debe ser 'iniciada' (initialized). Este inicio falla si la base de datos de cliente no está instalada en el equipo. Al terminar de utilizar las librerías cliente la correspondiente unidad tiene que ser 'liberada' (released).
43	43
44	44		## Conjuntos de datos (Datasets)
45	45
46	46		La utilización de bases de datos en Lazarus (o FreePascal) se basa fundamentalmente en la clase *TDataset*. Esta representa una tabla o consulta de tu aplicación. Sin embargo, al igual que con muchas otras clases fundamentales, no se utiliza la clase TDataset en sí, sino una descendiente de ella. Hay muchas de este tipo, que proporcionan acceso a los diferentes tipos de bases de datos, como archivos locales dBase o de texto, o en servidores tales como bases de datos PostgreSQL, Firebird, MySQL, etc. Algunos descendientes de DataSet enlazan directamente a tablas de la base de datos, mientras que otros utilizan componentes o bibliotecas adicionales para establecer el enlace.
47	47
48	48		Los descendientes de TDataSet, del tipo componentes no visuales forman parte (usualmente) de la Librería de Componentes Libre (FCL: Free Component Library) en lugar de la Librería de Componentes de Lazarus (LCL: Lazarus Component Library).
49	49
50	50		Los conjuntos de datos (DataSet) se pueden utilizar tanto mediante programación directa como utilizando los controles visuales. En una aplicación típica de base de datos de Lazarus a menudo se utilizan ambos métodos. En cualquier caso, el primer paso es crear el descendiente TDataset, a continuación iniciarlo para conectar a la tabla, y abrirlo para realizar la consulta deseada. Esto se puede hacer tanto mediante código, en tiempo de ejecución, como situando un componente en el formulario y configurando sus propiedades en tiempo de diseño. Los detalles de este proceso varían considerablemente con cada diferente descendiente del TDataset, por tanto debes consultar las distintas guías disponibles para cada Base de Datos concreta.
51	51
52	52		Cuando se abre (opened) el DataSet se crea un conjunto de componentes de campo (field), uno para cada campo o columna de la tabla o consulta que se abrió. Cada componente de campo es un descendiente de *TField*, apropiado para el [[Database field type\|tipo de datos en particular del campo]] como por ejemplo TStringField para una cadena, pero hay más.
53	53
54	54		### Utilizando conjuntos de datos mediante código
55	55
56	56		Se explicará en mas detalle en [[Using Dataset and Field components]], pero haciendo una simple descripción: Programmatic access will be explained in more detail in but as a very simple overview:
57	57
58	58		- Utilizar el descenciente de TDataset para abrir la tabla o consulta (query), filtrar las filas que se necesitan y mover fila a fila.
59	59		- Utilizar los descendientes de TField para:
60	60		- Acceso general de información de los campos.
61	61		- Acceso a los valores específicos de la fila actual. (utilizar las propiedades de As..., tales como AsString, AsInteger, etc.)
62	62		- Acceder a los campos de un descendiente TDataset utilizando ambos:
63	63		- Las propiedades del campo, eg Fields\[0\] es el primer campo,
64	64		- El método FieldByName , eg FieldByName('EDAD') retorna el campo asociado con el campo de tabla de la base de datosasociado con el campo llamado 'EDAD'. (Cuidado con el uso de mayúsculas/minúsculas en los nombres de campo, ante la duda o fallos probar a poner el nombre en minúsculas, por ejemplo en PostgreSQL).
65	65
66	66		Ver [[Database field type]] para un listado de tipos de campo.
67	67
68	68		### Utilizando los controles visuales (data-aware)
69	69
70	70		Para utilizar las bases de datos en un estilo simple de Lazarus "RAD: Rapid Application Deployment" se configura el descendiente de dataset en tiempo de diseño y se utilizan los controles data-aware. Para hacer esto:
71	71
72	72		- Añadir el descendiente dataset para la base de datos elegida, junto con cualquier componente de soporte, al formulario. Asignarle la conexión y establecer la consulta SQL, luego abrirlo (establecer la propiedad 'Active' a True).
73	73
74	74		- Añadir un componente TDataSource(desde la solapa "Data Access") al formulario, y "enlazarlo" al dataset (establecer para ello la propiedad DataSet).
75	75
76	76		- Añadir controles data-aware desde la solapa "Data Controls" al formulario, y enlazar cada uno de los componentes DataSource (fuente de los datos), pero no el dataset.
77	77
78	78		Conector--\>DataSet--\>DataSource\<--Data Controls
79	79
80	80		- La mayor parte de los controles enlazan un simple campo, por lo tanto necesitas establecer además el campo (field) para cada solapa.
81	81
82	82		Ver #Data Controls más abajo para más detalles sobre los controles.
83	83
84	84		### Estado de un Dataset
85	85
86	86		Los Datasets puede encontrarse en varios estados. Mientras tanto aqui tenemos unos pocos(buscar por TDataSetState en la fuente), los principales que podemos encontrar inicialmente son:
87	87
88	88		\| Estado \| Función \|
89	89		\|----\|----\|
90	90		\| dsInactive \| dataset status Inactive indica que el dataset está cerrado \|
91	91		\| dsBrowse \| dataset status dsBrowse indica que el usuario puede moverse por el dataset, buscando valores \|
92	92		\| dsInsert \| dataset status Insert indica que e ha insertado una nueva fila (registro), y el usuario puede establecer valores. El campo no se salva hasta que no se realiza el post \|
93	93
94	94		Los otros estados son claramente transitorios, y son manejados "automaticamente". Se utilizan internamente y en código más complejo. Si tu base de datos solo ve datos y abres el dataset en tiempo de ejecución entonces puedes ignorar ampliamente el estado, ya que se encontrará primordialmente como dsBrowse. Sin embargo, muchas aplicaciones necesitarán cambiar el dato a algún estado. Si estás utilizando controles data-aware, entonces ellos mismos manejarán la mayor parte de esto automáticamente. Si cambias el texto en un control DBEdit, por ejemplo, esto pondrá el dataset en estado dsEdit - al menos que ya se esté en estado dsEdit o dsInsert (ds=data state). Si te desplazas "scroll" a un campo diferente mientras el estado actual se encuentra en dsEdit o dsInsert, entonces este campo será posteado "posted" y el dataset se revierte a dsBrowse. A pesar de ello, si estás accediendo el dataset desde código, obtendrás un cambio de estado en código también. El control dbNavigator (ver más abajo) permite al usuario cambiar el estado explícitamente.
95	95
96	96		### Envío (Post) y Cancelación (Cancel)
97	97
98	98		Si has editado o insertado un campo entonces los valored se mantienen almacenados en un buffer, por lo que están preparados para realizar una acción sobre ellos tales como Post o Cancel.
99	99
100	100		- Llamando al método "cancel" del dataset remueve el nuevo campo (si hemos realizado un "insert") o revierte los valores a sus valores previos (si hemos realizado un "edit")
101	101		- Llamando al método "post" del dataset salva los valores (si hemos realizado un "edit") o campos (si hemos realizado un "insert"). En algunos descendientes del dataset deben grabarse en la base de datos inmediatamente, mientras que en otros se almacenan en una lista hasta que se realiza una llamada posterior que produce el salvado de todos los cambios a la base de datos. Finalmente, incluso cuando son escritos a la base de datos, todavía habría que realizar una llamada al método "commit" para que la que la escritura se realice de forma permanente. Todo esto varía considerablemente con cada descendiente del dataset por lo que se hace necesario revisar los detalles para cada uno que se utiliza.
102	102
103	103		### Insertando un nuevo registro (record)
104	104
105	105		Para insertar un nuervo registro dentro de un descendiente de TDataset se debe utilizar el método [Insert](http://www.freepascal.org/docs-html/fcl/db/tdataset.insert.html). Después de esto, ya se pueden establecer los valores del campo y finalmente llamar a Post para realizar el commit (acometer) del nuevo registro, tal como muestra el siguiente ejemplo:
106	106
107	107		``` pascal
108	108		MyDataset.Insert;
109	109		MyDataset.Fields[0].AsInteger := 4;
110	110		MyDataset.Fields[1].AsString := 'Nombre';
111	111		MyDataset.Post;
112	112		```
113	113
114	114		### Como saltar rápidamente a un registro de la tabla en particular
115	115
116	116		#### Después de seleccionar todos los registros de la tabla
117	117
118	118		Si utilizas SELECT * FROM tabla para seleccionar todos los registros de la tabla y entonces deseas saltar rápidamente entre ellos, entonces tienes que construir un índice y buscar en el mismo. Es mucho más eficiente seleccionar únicamente el registro que necesitas que la totalidad.
119	119
120	120		#### Selecionando únicamente el registro deseado
121	121
122	122		Una solución rápida para saltar a un registro en particular es simplemente "seleccioarlo en exclusiva", lo cual se puede realizar acotando con la cosulta de SQL, tal como se puede observar en el siguiente ejemplo:
123	123
124	124		``` pascal
125	125		var
126	126		MyDataset: TSQLQuery;
127	127		begin
128	128		//...
129	129		MyDataset.FieldDefs.Add('SessionId', ftLargeint); {0} {ft = fieldtype}
130	130		MyDataset.FieldDefs.Add('GameEvent', ftLargeint); {1}
131	131		MyDataset.FieldDefs.Add('TableId', ftInteger); {2}
132	132		MyDataset.FieldDefs.Add('LoggedIn', ftBoolean); {3}
133	133		MyDataset.FieldDefs.Add('PlayerId', ftInteger); {4 <=== este es el que queremos obtener}
134	134		MyDataset.Active := False;
135	135		SQLText := Format('select * from "GameSession" WHERE "SessionId"=%d', [ASessionId]);
136	136		MyDataset.SQL.Text := SQLText;
137	137		try
138	138		MyDataset.Active := True; { Probamos a activar el dataset dentro de un bloque de intercepción de errores de forma que }
139	139		{si no logra conectar podamos obtener retornado un tipo de error bien sea uno genérico (por defecto) u otro más especí-}
140	140		{fico de la base de datos en particular pero eso lo tenemos que especificar.........}
141	141		except
142	142		//...
143	143		end;
144	144		```
145	145
146	146		Entonces ya se puede leer información utilizando algo como lo siguiente:
147	147
148	148		``` pascal
149	149		lPlayerId := MyDataset.Fields[4].AsInteger;
150	150		```
151	151
152	152		### Utilizando TSQLQuery
153	153
154	154		Para más información sobre TSQLQuery ver [[Working With TSQLQuery/es]]
155	155
156	156		## Controles de datos
157	157
158	158		Para utilizar cualquiera de estos controles, hay que añadir cualquiera de estos controles al formulario (form) y establecer al menos la propiedad datasource para indicarle la fuente de datos con que se asocia. Adicionalmente van a requerir establecer otras propiedades para su correcto funcionamiento.
159	159
160	160		Tomando como referencia la información contenida en
161	161
162	162		<http://lazarus-ccr.sourceforge.net/docs/lcl/dbctrls/howtousedataawarecontrols.html> la descripción de los mismos sería:
163	163
164	164		Como utilizar controles DataAware - Sugerencias para el acceso a bases de datos.
165	165
166	166		Se aporta un conjunto de componentes Data-Aware, para hacer más fácil el acceso a la información contenida en bases de datos.
167	167
168	168		Antes de utilizar los componentes Data-Aware, es necesario establecer una conexión con una base de datos, lo cual debería realizarse utilizando bien a través del componente TSQLConnection o del TDBf, dependiendo del tipo de base de datos que se esté utilizando. En cualquier caso, los componentes para la conexión con la base de datos necesitan estar ubicados en \$Lazdir/components/sqldb/, \$Lazdir/components/tdbf/ o en cualquier otro lugar que actue como fuente de forma apropiada. Necesitan ser añadidos utilizando el menú de elementos del IDE, además de estar previamente compilados. Una vez añadidos el IDE necesita reconstruirse para incluir los nuevos componentes.
169	169
170	170		Para realizar la conexión con la base de datos, primeramente emplaza una conexión a la base de datos en el formulario (invisible en tiempo de ejecución (run-time), ponlo por tanto en cualquier lugar que creas conveniente); establece sus propiedades para conectar el usuario (con su nombre y contraseña) al servidor, base de datos y tabla adecuados (el componente de conexión debería lidiar con todos los asuntos de autentificación de usuario, abriendo y cerrando la base de datos, etc). A continuación añadimos un TDataSource desde la solapa Data Access de la paleta de componentes, y tal vez elementos tales como TSQLTransaction y TSQLQuery, dependiendo de la base de datos en particular que se esté utilizando. Los variados componentes de bases de datos necesitan enlazarse entre ellos, por ejemplo estableciendo la propiedad Transaction de un conector de la base de datos al componente de transacción apropiado, y enlazando la propiedad DataBase del componente Transaction al conector de la base de datos; enlaza la propiedad DataSet del DataSource al SQLQuery u otro conjunto de datos, y su propiedad Transaction al componente transaction.
171	171
172	172		Cada control Data-Aware (en la solapa Data Controls de la paleta de componentes) tiene el conjunto de propiedades habitual para determinar su shape y tamaño, posición, color, fuente, etc. Pero además tiene propiedades especiales para definir el dato a mostrar o modificar. Estas incluyen la propiedad DataSource que debe establecerse para enlazar con el conjunto de datos definido, y a menudo un componente Field para determinar la columna de la base de datos se mostrará.
173	173
174	174		La mayor parte de los componentes operan con una simple fila (Row) o campo (record) de la base de datos, (en cambio TDBGrid es capaz de mostrar y operar con múltiples filas y columnas, ver más abajo), permitiendo mostrar contenido incluso en tiempo de diseño, a condición de que varios componentes estén habilitados o establecidos activos; esto permite al diseñador asegurarse de que todas las conexiones a la base de datos se han realizado correctamente.
175	175
176	176		La manera en que funciona la programación con bases de datos es la siguiente:
177	177
178	178		- Se abre una base de datos para el acceso por parte del usuario (DataBase Connection).
179	179		- Se realiza un mandato (e.g mediante TSQLQuery) para seleccionar o extraer alguno o todos los campos, los cuales se almacenan localmente es el DataSet
180	180		- El contenido del DataSet es utilizado por los componentes Data-Aware, mostrando una fila (Row) o campos a un tiempo desde las columnas seleccionadas, o por otro lado el DataSet completo si se utiliza un DBGrid, editando, insertando o borrando campos, o utilizando datos para realizarun test estadístico o cálculos.
181	181		- A intervalos normalmente determinados por el usuario (algunas veces después de cada cambio, otras después de una serie de cambios completos), se envía el contenido del DataSet local a la base de datos, causando una actualización de su contenido. Esto es referido como un 'Commit' o 'Post' o a menudo como 'Update'.
182	182
183	183		El programador puede determinar que eventos estan asociados con una acción Commit utiliando manejadores de eventos apropiados para OnClick, OnChange, OnFinishedEdit etc.
184	184
185	185		### Controles de un solo campo
186	186
187	187		En el caso de todos estos controles se vincula únicamente a un campo. Al igual que datasource hay que establecer el nombre de campo:
188	188
189	189		- [[doc:lcl/dbctrls/tdbtext.html\|DBText control]] Muestra un campo de texto (solo lectura, sin borde).
190	190		- [[doc:lcl/dbctrls/tdbedit.html\|DBEdit control]] Muestra / edita un campo de texto como en un edit box.
191	191		- [[doc:lcl/dbctrls/tdbmemo.html\|DBMemo control]] Muestra / edita un campo de texto en una caja de edición multilínea.
192	192		- [[doc:lcl/dbctrls/tdbimage.html\|DBImage control]] Muestra una imagen almacenada en una base de datos como BLOB.
193	193		- [[doc:lcl/dbctrls/tdblistbox.html\|DBListBox control]] y [[doc:lcl/dbctrls/tdbcombobox.html\|DBComboBox Control]] Permite al usuario insertar valores en los campos de una base de datos desde un listado de valores en la propiedad Items (elementos) de los controles.
194	194		- [[doc:lcl/dbctrls/tdblookuplistbox.html\|DBLookupListBox control]] y [[doc:lcl/dbctrls/tdblookupcombobox.html\|DBLookupComboBox control]], ver además [[dblookupcombobox]] Permite al usuario insertar valores dentro de un campo de la base de datos mostrando el contenido de un campo lookup en otra tabla. Aunque estos controles almacenan su resultado en un solo campo, se necesita otro campo para los valores lookup. Nota: al menos para DBLookupComboBox, hay un error con FPC 2.6.0 que requiere que listfield esté presente en el datasource pero se puede saltar esto declarando un campo con el mismo nombre de listfield en el dataset del datasource que no hace nada.
195	195		- [[doc:lcl/dbctrls/tdbcheckbox.html\|DBCheckBox control]] Muestra/ edita un campo booleano mediante el marcado(checking)/(desmarcado (clearing) de un check box.
196	196		- [[doc:lcl/dbctrls/tdbradiogroup.html\|DBRadioGroup control]] Muestra los elementos tal como en un radio group, leyendo/estableciendo el valor del campo desde un listado de valores de correspondencia (matching values list).
197	197		- [[doc:lcl/dbctrls/tdbcalendar.html\|DBCalendar control]] Muestra / edita un campo fecha utilizando un panel tipo calendario.
198	198		- [[doc:lcl/dbctrls/tdbgroupbox.html\|DBGroupBox control]]
199	199
200	200		La siguiente tabla muestra la correspondencia aproximada entre las clases de controles convencionales y las data-aware:
201	201
202	202		\| Control Estandar \| Control de Datos \| Comentario \|
203	203		\|----\|----\|----\|
204	204		\| TCalendar \| TDBCalendar \| Selecciona una fecha desde un calendario emergente \|
205	205		\| TCheckBox \| TDBCheckBox \| Check una casilla para mostrar la opción que se ha seleccionado \|
206	206		\| TComboBox \| TDBComboBox \| Selecciona una opción desde un listado y lo retorna (o algún texto personalizado) en el casillero de edición principal \|
207	207		\| TEdit \| TDBEdit \| Casillero de edición de texto de línea simple \|
208	208		\| TGroupBox \| TDBGroupBox \| Contenedor para varios controles relacionados \|
209	209		\| TImage \| TDBImage \| Una imagen \|
210	210		\| TListBox \| TDBListBox \| Una lista de elementos cadena \|
211	211		\| TMemo \| TDBMemo \| Casillero de edición de texto multi-línea \|
212	212		\| TRadioGroup \| TDBRadioGroup \| Un grupo de Radio Buttons mutuamente exclusivos; solamente se puede tener checked y seleccionado uno al mismo tiempo. Ten en cuenta que no hay equivalente en data-aware a un solo TRadioButton \|
213	213		\| TText \| TDBText \| Una simple cadena de texto, usualmente de solo lectura \|
214	214
215	215		Los controles estandar pueden, por supuesto, utilizarse para mostrar información de la base de datos, pero carecen de la vinculación directa con el DataSet y sus ayudas a la navegación por el mismo, de forma que el programador debe en este caso escribir código explícitamente para extraer datos desde el DataSet y ponerlos en el control estandar.
216	216
217	217		### [[doc:lcl/dbgrids/tdbgrid.html\|Control DBGrid]]
218	218
219	219		Este control muestra n número de campos en una disposición de fila (registro) / columna (campo)- de hecho por defecto muestra todos. This control can show a number of fields in a row/column layout - in fact by default it shows them all. Sin embargo, se pueden poner entradas dentro de [[doc:lcl/dbgrids/tdbgrid.columns.html\|columns collection]] para restringirlos a unos campos específicos y establecer la anchura y títulos de cada columna.
220	220
221	221		Su equivalencia con el control convencional es:
222	222
223	223		\| Control Estandar \| Control de Datos \| Comentario \|
224	224		\|----\|----\|----\|
225	225		\| TStringGrid \| TdbGrid \| Una rejilla para mostrar información en formato filas y columnas \|
226	226
227	227		### [Navigator Control](http://lazarus-ccr.sourceforge.net/docs/lcl/dbctrls/tdbnavigator.html)
228	228
229	229		![](/wiki-images/7/76/Dbnavigator.PNG)
230	230
231	231		Este control consistente en una barra de botones de utilidad ofrece al usuario algo de control directo sobre el DataSet, permitiendo al usuario:
232	232
233	233		- Mover al registro siguiente (next) y previo (prior), así como al principio (first) y final (last).
234	234		- Añadir un registro nuevo (equivalente a la llamada a un método dataset.insert).
235	235		- Poner el dataset en modo edición (edit), necesario cuando ya existe dicho registro y deseamos modificarlo.
236	236		- Borrar un registro (delete) el registro actual.
237	237		- Envíar (post) o Cancelar (cancel) los cambios actuales del DataSet a la base de datos.
238	238		- Refresca (refresh) los datos (útil en aplicaciones de bases de datos multiusuario) desde la base de datos.
239	239
240	240		El programador puede determinar, en tiempo de diseño, que botones quiere dejar visibles o no, ajustando algunas de sus propiedades en el inspector de objetos:
241	241
242	242		- VisibleButtons: Permite controlar lo que puede hacer el usuario. Por ejemplo, si los borrados (delete) no están permitidos se oculta este pulsador. Si se tiene un DBGrid anexado a un dataset puede decidirse que no se necesitan los pulsadores previo (prior) y siguiente (next).
243	243
244	244		Los botones que posee esta barra son del tipo [tdbnavbuttonset](http://lazarus-ccr.sourceforge.net/docs/lcl/dbctrls/tdbnavbuttonset.html) admitiendo los siguientes:
245	245
246	246		- Comienzan por nb de navigator button:
247	247		- nbFirst: navigator button First (mueve al primer registro).
248	248		- nbPrior: navigator buttor Prior (mueve al registro previo).
249	249		- nbNext: navigator button Next (mueve al registro siguiente).
250	250		- nbLast: navigator button Last (muesve al último registro).
251	251		- nbInsert: navigator button Insert (inserta un nuevo registro).
252	252		- nbDelete: navigator button Delete (borra el registro actual).
253	253		- nbEdit: navigator button Edit (edita un registro existente).
254	254		- nbPost: navigator button Post (envía el DataSet a la base de datos).
255	255		- nbCancel: navigator button Cancel (cancela los cambios realizados).
256	256		- nbRefresh navigator button Refresh (refresca el contenido del DataSet desde la base de datos).
257	257
258	258		Por ejemplo para un control de este tipo y su dataset asociado, vinculado a una fuente de datos: dbnavigator1.DataSource.DataSet.First; nos situaría en el primer registro.
259	259
260	260		- Width: Si no se muestran todos los pulsadores, posiblemente se necesite establecer la anchura al valor alturanúmero de pulsadores visibles( heightnumber_of_visible_buttons).
261	261
262	262		Para su funcionamiento se debe especificar el conjunto de datos al que se asocia mediante su propiedad DataSource.
263	263
264	264		Si se utiliza en conjunción con otros controles de datos (data-aware) tales como TDBGrid o TDBMemo entonces controla que registros se mostrarán, la posición del cursor de selección de registro y la iniciación de cambios del dataset y en última instancia de la base de datos.
265	265
266	266		Por otro lado cabe indicar que la mayor parte de la funcionalidad de esta barra se encuentra ya implementada, pero en el caso de que el programador necesite especificar acciones asociadas a un pulsadores individuales, hay un procedimiento [tdbcustomnavigator.btnclick](http://lazarus-ccr.sourceforge.net/docs/lcl/dbctrls/tdbcustomnavigator.btnclick.html) al cual se puede enviar un argumentocon el valor de índice del botón pulsado, y el procedimiento escoge que acción llamar dependiendo del indice del botón.
267	267
268	268		## Corriendo los test de bases de datos de FPC
269	269
270	270		Los componentes de bases de datos FreePascal incluyen un framework de prueba que se puede utilizar para probar la funcionalidad. Ver el directorio source\packages\fcl-db\tests\\ en el árbol de directorios de instalación de FPC.
271	271
272	272		Lo incluido es un framework de prueba que se puede arrancar en varios componentes de bases de datos, así como en otros test (e.g. test de exportacion de bases de datos en XMLXSDExportTest.lpr).
273	273
274	274		Para arrancar el framework de prueba para una cierta base de datos hacer lo siguiente:
275	275
276	276		1\. Salvar "source\packages\fcl-db\tests\database.ini.txt" como "source\packages\fcl-db\tests\database.ini"
277	277
278	278		2\. Modificar source\packages\fcl-db\tests\database.ini para escoger el tipo de base de datos a utilizar.
279	279
280	280		`Example: utilizar Interbase o Firebird: [Database] type=interbase`
281	281
282	282		3\. En el mismo fichero, configurar los valores para la base de datos a utilizar. E.g. si se escogió interbase anteriormente:
283	283
284		-	~~`01 [interbase]`\~~
285		-	~~`02 connector=sql`\~~
286		-	~~`03 connectorparams=interbase`\~~
287		-	~~`04 ; esto es un comentario, ya que comienza por ; los números de inicio de línea se han puesto para más claridad.`\~~
288		-	~~`05 ;nombre de la base de datos. obviamente cambiar por el de la base de datos a utilizar.`\~~
289		-	~~`06 name=testdb`\~~
290		-	~~`07 user=sysdba`\~~
291		-	~~`08 password=masterkey`\~~
292		-	~~`09 ; tu hostname o nombre de equipo puede diferir del utilizado en este ejemplo (lógico).`\~~
293		-	~~`10 hostname=192.168.0.42`~~
	284	+	```text
	285	+	01 [interbase]
	286	+	02 connector=sql
	287	+	03 connectorparams=interbase
	288	+	04 ; esto es un comentario, ya que comienza por ; los números de inicio de línea se han puesto para más claridad.
	289	+	05 ;nombre de la base de datos. obviamente cambiar por el de la base de datos a utilizar.
	290	+	06 name=testdb
	291	+	07 user=sysdba
	292	+	08 password=masterkey
	293	+	09 ; tu hostname o nombre de equipo puede diferir del utilizado en este ejemplo (lógico).
	294	+	10 hostname=192.168.0.42
	295	+	```
294	296
295	297		4\. Compila y arranca "source\packages\fcl-db\tests\dbtestframework.pas"
296	298
297	299		La salida se obtendrá en formato XML.
298	300
299	301		Para más detalles leer el fichero "source\packages\fcl-db\tests\README.txt"
300	302
301	303		## Paquetes de Bases de Datos suministrados con Lazarus
302	304
303	305		### sqldblaz.lpk
304	306
305	307		Este paquete provee acceso a diferentes bases de datos. Incluye:
306	308
307	309		- Interbase/Firebird
308	310		- MySQL (Versiones: 4.0/4.1/5.0/5.1/5.5 en Lazarus 1.0.4).
309	311		- Oracle
310	312		- PostgreSQL (Versiones: hasta la 8.x en Lazarus 1.0.4)
311	313		- SQLite (Versión: 3 en Lazarus 1.0.4)(con soporte para la extensión [[Spatialite]])
312	314		- Cualquier base de datos que tenga un driver ODBC.
313	315
314	316		Los componentes (TSQLQuery, TSQLTransaction, TIBConnection, TODBCConnection, TOracleConnection, TMySQL40Connection, TMySQL41Connection, TMySQL50Connection, TPQConnection) se encuentran en la pestaña 'SQLdb' en la paleta de componentes.
315	317
316	318		- [[SQLdb Package/es\|Paquete SQLdb]]
317	319
318	320		### dbflaz.lpk
319	321
320	322		Este paquete provee acceso a las bases de datos dBase y FoxPro.Puedes obtener más información en la [[Lazarus Tdbf Tutorial\|Tutoría de Lazarus Tdbf]]. El componente TDbf se localiza en la pestaña 'Data Access' en la paleta de componentes.
321	323
322	324		### sqlitelaz.lpk
323	325
324	326		Este paquete provee acceso a las bases de datos SQLite. Puedes obtener más información en la [[Lazarus Database Tutorial/es\|Tutoría de Bases de Datos Lazarus]].
325	327
326	328		### sdflaz.lpk
327	329
328	330		El componente TSdfDataSet se encuentran en la pestaña 'Data Access' en la paleta de componentes.
329	331
330	332		### lazreport.lpk
331	333
332	334		La página principal del generador de informes es [<http://lazreport.sourceforge.net/>](http://lazreport.sourceforge.net/). Más información y enlaces adicionales se encuentran en [[Projects using Lazarus/es\|aquí]]. LazReport depende del paquete Printer4Lazarus. Con la revisión 11950 LazReport fué incluido el repositorio SVN de Lazarus.
333	335
334	336		## Paquetes y librerías externas
335	337
336	338		### Zeos DataBase Objects
337	339
338	340		Los componentes de este paquete proveen acceso a diferentes bases de datos. Puedes obtener más información [[ZeosDBO\|aquí]]. Este wiki contiene una [[Zeos tutorial/es\|tutoría Zeos]].
339	341
340	342		### Pascal Data Objects
341	343
342	344		Ahora hay una alternativa.
343	345
344	346		Soporta:
345	347
346	348		- MySQL 4.1 y 5.0
347	349		- sqlite-2 y sqlite-3
348	350		- pgsql-8.1
349	351		- interbase-5, interbase-6, firebird-1.0, firebird-1.5, firebird-1.5E, firebird-2.0, firebird-2.0E
350	352		- mssql (librería Microsoft) y sybase (librería FreeTDS)
351	353		- oracle
352	354
353	355		- así como sentencias preparadas, enlace, y procedimientos almacenados son soportados por la API de base de datos llamada Pascal Data Objects, que se inspira en PHP Data Objects. Todo el código y la documentación necesaria para utilizar esta nueva API está disponible en [aquí](http://pdo.sourceforge.net) en Sourceforge:
354	356
355	357		### TPSQL
356	358
357	359		Los componentes de este paquete proveen acceso vía TCP/IP a bases de datos PostgreSQL. Puedes obtener más información en [[TPSQL/es\|esta página]].
358	360
359	361		### FIBL
360	362
361	363		Los componentes de este paquete proveen acceso a bases de datos Interbase y Firebird. La página principal está [aquí](http://sourceforge.net/projects/fibl).
362	364
363	365		### FBLib Firebird, librería
364	366
365	367		[FBLib](http://fblib.altervista.org/) es una librería de fuente abierta sin componentes ligados a datos (No Data Aware) para acceso directo a bases de datos relacionales Firebird desde Borland Delphi/Kylix, Free Pascal y Lazarus.
366	368
367	369		Las características actuales incluyen:
368	370
369	371		- Acceso directo a to Firebird 1.0.x, 1.5.x y 2.x Classic o SuperServer
370	372		- Multiplataforma \[Win32,Gnu/Linux,FreeBSD)
371	373		- Selección automática de la librería cliente 'fbclient' o 'gds32'
372	374		- Consultas con parámetros
373	375		- Soporte del dialecto SQL 1/3
374	376		- Acuerdo de Licencia LGPL
375	377		- Extracción de Metadata
376	378		- Analizador simple de secuencias de comandos
377	379		- Únicamente añade 100-150 KB al EXE final
378	380		- Soporta campos BLOB
379	381		- Exporta datos a HTML SQL Script
380	382		- Administrador de servicios (copia de seguridad, restauración,gfix...)
381	383		- Eventos de alerta
382	384
383	385		Puedes descargar la documentación desde el [sitio web FBLib's](http://fblib.altervista.org/).
384	386
385	387		### Unified Interbase
386	388
387	389		UIB provee acceso a bases de datos Interbase, Firebird y YAFFIL. TLa página principal es [www.progdigy.com](http://www.progdigy.com). Un repositorio SVN está disponible [aquí](https://uib.svn.sourceforge.net/svnroot/uib) .
388	390
389	391		### TechInsite Object Persistence Framework (tiOPF)
390	392
391	393		Más información acerca de tiOPF se puede encontrar en esta [[tiOPF\|página]].
392	394
393	395		---
394	396		From the Free Pascal wiki, page "Databases/es", as it stood on 2020-02-16 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).

Back to history