Template:Bases de datos de infobox
Introducción
Esta página explicará cómo conectarse a un MySQL usando componentes visuales.
![]()
Nota: Esta página fue escrita hace mucho tiempo y puede estar desactualizada. Además, la mayoría de los conceptos descritos aquí no son específicos de MySQL, sino que se aplican a todas las bases de datos SQLDB. Por lo tanto, seguir la serie de tutoriales de SQLdb mencionada a continuación puede ser más fácil
Nota: véanse también estos tutoriales que enseñan controles encadernados por datos, consultas parametrizadas, programación independiente de bases de datos, etc.:
Están escritos para todas las bases de datos que soportan sqldb, incluyendo MySQL.
Si es necesario, consulta también mysql#SQLDB_tutorials_and_example_code para más tutoriales (que también fueron escritos hace mucho tiempo.
Componentes disponibles
Componentes SQLdb
En cualquier versión siquiera vagamente reciente de Lazarus, los componentes SQLDB se instalan por defecto.
En la pestaña de SQLDB encontrarás:
- Varios conectores, incluyendo TMySQL40Connection.. TMySQL56Connection (o quizás versiones más recientes) y el más versátil de todos, TSQLConnector que puede cargar cualquiera de los controladores mysql/oracle/postgres/mssql/interbase/firebird/odbc.
- TSQLQuery
Si falta la pestaña SQLDB, echa un vistazo a Install Packages para un "Install Howto".
Explicación de los componentes utilizados
TMySQLConnection
La TMySQLConnection se utiliza para almacenar parámetros que se conecten al servidor de base de datos. Te permite configurar el host para conectarse, y el usuario y la contraseña para usar en la conexión. Otra propiedad de TMySQLConnection se utiliza para indicar la base de datos que quieres utilizar. El 'LoginPrompt' aún no funciona, así que asegúrate de que junto a Nombre de Host y Nombre de Base de Datos, las propiedades de Nombre de Usuario y Contraseña tengan valores antes de intentar abrir la conexión. Asegúrate de usar también una TSQLTransaction y conectarla a tu MySQLConnection configurando la propiedad Transaction, o no podrás abrir una SQLQuery.
![]()
Nota: Como se indicó antes, existen varios componentes de MySQLConnection que difieren en número de versión. El número de versión debe' coincide con el número de versión de la biblioteca cliente que usas para conectarte a tu servidor. Así que si ejecutas un servidor MySQL 5.1 pero usas un cliente MySQL 5.0, usa TMySQL50Connection.
Deberías consultar la documentación de MySQL para asegurarte de que la combinación entre la versión del cliente y la versión del servidor está soportada; por ejemplo, puede que tengas problemas para conectarte a un servidor 4.0 usando un cliente 5.x.
En todos los casos, pon una copia de libmysql.dll y cualquier otro archivo/DLL requerido
- en tu directorio de Lazarus y en el mismo directorio que tus archivos de proyecto o
- en el directorio del sistema de Windows (si no quieres seguir copiando archivos). Ten en cuenta que en Windows de 64 bits tienes que poner la biblioteca de 32 bits en SysWOW64, mientras que las bibliotecas de 64 bits van en System32.
TSQLTransaction
Se necesita una TSQLTransaction para cierto mantenimiento interno. Una SQLTransaction se activa automáticamente cuando abres un conjunto de datos usándolo. Cerrar una conexión también desactiva la transacción relacionada y cierra todos los conjuntos de datos que la usan.
TSQLQuery
TSQLQuery se utiliza para ejecutar SQLstatements en el servidor. Puedes recuperar datos configurando el SQL a alguna instrucción SELECT y llamando al método Open. O puedes manipular datos emitiendo alguna instrucción INSERT, DELETE o UPDATE. En este último caso, no deberías usar el método Open sino el método ExecSQL.
TDataSource
Un TDataSource proporciona la conexión entre los componentes visibles conscientes de datos como DBEdit, DBGrid y un conjunto de datos. Hace que los datos estén disponibles para que los componentes conscientes de datos los muestren. Una fuente de datos solo puede conectarse a un único conjunto de datos a la vez, pero puede haber varios componentes conscientes de los datos conectados.
TDBGrid
Un TDBGrid puede usarse para presentar los datos recuperados por un conjunto de datos. DBGrid necesita una fuente de datos para conectarse a un conjunto de datos. Cuando se abre el conjunto de datos, la cuadrícula de bases de datos se llenará automáticamente con los datos.
Nuestro programa
Lo básico
Intentaremos crear un programa basado en el único que se hizo aquí (en neerlandés) que se basa en el original (en inglés) de Chris.
La forma principal
Usaremos la misma pantalla principal y construiremos todas las funcionalidades desde cero :) Como verás, hay mucho menos que ocuparse, porque los componentes realmente eliminan todo lo difícil. Así que empecemos haciendo una pantalla que se parezca a esta.
Desde la pestaña SQLdb, coloca un TMySQL56Connection
(u otra versión del cliente mysql), un TSQLTransaction
y un TSQLQuery
en este formulario. No cambies los nombres por defecto que se les dan a estos componentes. Excepto por el componente de conexión. Para que este artículo sea igual para todas las versiones de MySQL, nombra tu componente TMySQL##Connection: MySQLConnection1. Tenemos que enlazar estos componentes para que puedan hacer su trabajo. Por tanto, las siguientes propiedades deben establecerse:
| Componente | Propiedad' | Valor |
| MySQLConnection1 | Transacción | SQLTransaction1 |
| SQLTransaction1 | Base de datos | MySQLConnection1 |
| SQLQuery1 | Transacción | SQLTransaction1 |
| SQLQuery1 | Base de datos | MySQLConnection1 |
La propiedad de transacción de SQLQuery1 se activará automáticamente si has establecido primero la propiedad de transacción de MySQLConnection1. Cuando configuras esto, notarás que SQLTransaction1.Database está configurado como MySQLConnection1.
Como se dijo antes: asegúrate de usar el componente Connection correcto para tu versión de MySQL Server.
El código
Como puedes ver en el volcado de pantalla, los únicos botones disponibles al iniciar el programa son "Conectar al servidor" y "Salir". Para que los otros botones funcionen, necesitamos más información para que estén deshabilitados. También podríamos decidir desactivar "Conectar al servidor" hasta que se haya dado la información del anfitrión, el nombre de usuario y la contraseña. Decidí no hacerlo porque nuestro usuario podría pensar: "Nada parece posible, así que pulsemos salir." :)
Antes de empezar a darte cualquier código, me gustaría recalcar que debería haber más gestión de excepciones en el código. Las secciones críticas deben colocarse en
prueba ... por fin
o
prueba ... excepto
construcciones.
Conectarse a un servidor
Lo primero que tenemos que hacer es conectarnos a nuestro servidor. Como al conectarnos no sabemos qué bases de datos hay disponibles en el servidor, pediremos una lista de bases de datos al conectarnos. Sin embargo, hay una condición: para hacer la conexión tenemos que introducir un Nombre de Base de Datos válido en las propiedades de MySQLConnection. Verás en el código que estoy usando la base de datos "mysql". Esta base de datos la usa mysql para tareas de limpieza, así que siempre estará ahí.
procedimiento TFormTryMySQL.ConnectButtonClick(Sender: TObject);
Comienzo
Comprueba si tenemos una conexión activa. Si es asÃ, cerrémoslo.
si MySQLConnection1.Connected entonces CloseConnection(Sender);
Establece los parámetros de conexión.
MySQLConnection1.HostName := HostEdit.Text;
MySQLConnection1.UserName := UserEdit.Text;
MySQLConnection1.Password := PasswdEdit.Text;
MySQLConnection1.DatabaseName := 'mysql'; ¡MySQL siempre está ahÃ!
ShowString('Abriendo una conexión al servidor: ' + HostEdit.Text);
MySQLConnection1.Open;
Primero, vamos a obtener una lista de las bases de datos disponibles.
si MySQLConnection1.Connected entonces comienza
ShowString('Conectado al servidor: ' + HostEdit.Text);
ShowString ('Recuperación de la lista de bases de datos disponibles.');
SQLQuery1.SQL.Texto := 'mostrar bases de datos';
SQLQuery1.Open;
aunque no empiezan SQLQuery1.EOF
DatabaseComboBox.Items.Add(SQLQuery1.Fields[0]. AsString);
SQLQuery1.Next;
fin;
SQLQuery1.Close;
ShowString ('¡Lista de bases de datos recibidas!');
fin;
fin;
Lo primero que hacemos es comprobar si estamos conectados a un servidor; si es así, llamamos a un método privado "CloseConnection". En este método se realiza algo más de tareas domésticas. Como desactivar botones y borrar comboboxes y listcas. Luego establecemos los parámetros necesarios para conectarnos al servidor.
A lo largo de nuestro programa puede que veas llamadas a ShowString. Este método añade una línea al memorándum en nuestro formulario que actúa como una especie de registro.
Con los parámetros establecidos, podemos conectarnos al servidor. Esto se hace llamando
MySQLConnection1.Open;
En una aplicación adecuada, se colocaría esto en una construcción de manejo de excepciones para presentar un mensaje amistoso al usuario si la conexión falla. Cuando estamos conectados, queremos obtener una lista de bases de datos del servidor. Para obtener datos del servidor se utiliza un TSQLQuery. La propiedad SQL se utiliza para almacenar la instrucción SQL enviada al servidor. MySQL conoce el comando "MOSTRAR BASES de DATOS" para obtener la lista de bases de datos. Así que, después de establecer el texto SQL, llamamos
SQLQuery1.Open;
En MySQL5 configura esto para corregir errores con sintaxis SQL:
SQLQuery1.ParseSQL := False;
SQLQuery1.ReadOnly := True;
El conjunto de resultados de un SQLQuery puede examinarse mediante la propiedad de campos. Como puedes ver, iteramos entre los registros llamando
SQLQuery1.Next;
Cuando hemos añadido todas las bases de datos disponibles a nuestro combobox, cerramos de nuevo SQLQuery.
Selección de una base de datos
Si el usuario selecciona una base de datos en la DatabaseComboBox, activamos el botón "Seleccionar base de datos". En el evento OnClick de este botón, establecemos el Nombre de la Base de Datos de MySQLConnection1 y solicitamos una lista de tablas. La última instrucción de este procedimiento permite el botón "Abrir consulta", de modo que el usuario puede introducir una consulta en el cuadro de edición "Comando" y enviarla al servidor.
procedimiento TFormTryMySQL.SelectDBButtonClick(Sender: TObject);
Comienzo
Se ha seleccionado una base de datos, asà que vamos a poner las tablas en ella.
Conexión Cercana (Remitente);
si DatabaseComboBox.ItemIndex <> -1, entonces comienza
con DatabaseComboBox hacer
MySQLConnection1.DatabaseName := Items[ItemIndex];
ShowString ('Lista de tablas de recuperación');
SQLQuery1.SQL.Texto := 'mostrar tablas';
SQLQuery1.Open;
aunque no empiezan SQLQuery1.EOF
TableComboBox.Items.Add(SQLQuery1.Fields[0]. AsString);
SQLQuery1.Next;
fin;
SQLQuery1.Close;
ShowString ('Lista de tablas recibidas');
fin;
OpenQueryButton.Enabled := True;
fin;
MySQL tiene un comando especial para obtener una lista de tablas, comparable a obtener la lista de bases de datos, "mostrar tablas". El resultado de esta consulta se gestiona de la misma manera que la lista de bases de datos y todas las tablas se añaden a la TableComboBox. ¿Quizá te preguntes por qué no volvemos a abrir la conexión antes de abrir la consulta? Bueno, esto se hace automáticamente (si es necesario) cuando activamos SQLQuery.
Campos en una tabla
En MySQL puedes volver a usar una forma de "SHOW" para obtener los campos en una tabla. En este caso, "MOSTRAR COLUMNAS DE <NOMBRE>". Si el usuario elige una tabla de la TableComboBox, se activa el OnChangeEvent de esta ComboBox que llena la FieldListbox.
procedimiento TFormTryMySQL.TableComboBoxChange(Sender: TObject);
Comienzo
FieldListBox.Clear;
SQLQuery1.SQL.Text := 'mostrar columnas de ' + TableComboBox.Text;
SQLQuery1.Open;
aunque no empiezan SQLQuery1.EOF
FieldListBox.Items.Add(SQLQuery1.Fields[0]. AsString);
SQLQuery1.Next;
fin;
SQLQuery1.Close;
fin;
Además de los nombres de los campos, el conjunto de resultados contiene información sobre el tipo de campo, si el campo es clave, si se permiten nulos y algo más.
Mostrando los datos
Bueno, como dijimos, usaríamos componentes para conectarnos a la base de datos, usemos algunos componentes para mostrar también los datos. Utilizaremos un segundo formulario para mostrar una cuadrícula con los datos solicitados por el usuario. Este formulario se mostrará cuando el usuario escriba un comando SQL en el cuadro de edición "Comando" y después haga clic en el botón "Abrir consulta". Este es el evento OnClick:
procedimiento TFormTryMySQL.OpenQueryButtonClick(Sender: TObject);
Comienzo
MostrarFormularConsultaForma := TShowFormaConsulta.Crear(self);
ShowQueryForm.Datasource1.DataSet := SQLQuery1;
SQLQuery1.SQL.Texto := ComandoEditar.Texto;
SQLQuery1.Open;
ShowQueryForm.ShowModal;
ShowQueryForm.Free;
SQLQuery1.Close;
fin;
El ShowQueryForm se ve así:
<centro></centro>
y contiene un
| TPanel | Align | alBottom |
| TDataSource | ||
| TDBGrid | Align | alCliente |
| DataSource | DataSource1 | |
| TButton | Pie de foto | Cierre |
El botón se coloca en el panel. Lo que ocurre en el OnClick de "Consulta Abierta" es esto. Primero creamos una instancia de TShowQueryForm. En segundo lugar, establecemos la propiedad DataSet de DataSource en nuestro SQLQuery1. Luego configuramos el comando SQL de SQLQuery para que el usuario introduzca en la caja de edición "Comando" y lo abrimos. Luego el ShowQueryForm se muestra modalmente, lo que significa que tendrá el foco de nuestra aplicación hasta que se cierre. Cuando está cerrado, lo "liberamos" y cerramos SQLQuery1 de nuevo.
El Formulario puede mejorarse aún más insertando un método para modificar el contenido del TDataSet y, en última instancia, de la Base de Datos. Se puede descargar una versión completa desde http://digitus.itk.ppke.hu/~janma/lazarus/MySql5Test.tar.gz (con agradecimientos a Arwen y JZombi del foro Lazarus MySQL) Pero los detalles relevantes son los siguientes:
Añade un botón en la parte inferior del formulario ShowQuery llamado AddButton y con el pie de foto 'Add'. Crea un método para AddButtonClick así:
procedimiento TShowQueryForm.AddButtonClick(Sender: TObject);
Comienzo
DataSource1.DataSet.Append;
fin;
Cambiar el código de OpenQueryButtonClick para permitir actualizaciones en la base de datos cuando terminemos con el Formulario de Consulta.
procedimiento TFormTryMySQL.OpenQueryButtonClick(Sender: TObject);
Comienzo
MostrarFormularConsulta:= TShowFormaConsulta.Crear(nil);
Prueba
ShowQueryForm.DataSource1.DataSet := SQLQuery1;
Escribiremos en la base de datos, asà que pongamos ReadOnly en false,
y para eso necesitamos establecer ParseSQL verdadero
SQLQuery1.ParseSQL:=true;
SQLQuery1.ReadOnly:=false;
SQLQuery1.SQL.Texto := ComandoEditar.Texto;
SQLQuery1.Open;
ShowQueryForm.ShowModal;
por fin
configurar el modo de actualización y actualizar la base de datos
SQLQuery1.UpdateMode:=upWhereChanged;
SQLQuery1.ApplyUpdates;
SQLTransaction1.Commit;
ShowQueryForm.Free;
SQLQuery1.Close;
Poner el modo de solo lectura y analizar SQL de nuevo a los valores predeterminados
SQLQuery1.ParseSQL:=false;
SQLQuery1.ReadOnly:=true;
fin;
fin;
Ahora podemos añadir registros a la base de datos. Si añadimos un TDBNavigator al formulario ShowQuery podemos movernos más fácilmente por la Red de Datos y editar registros; la base de datos se actualiza con nuestros cambios cada vez que cerramos el formulario ShowQuery, y podemos probar esto abriéndola de nuevo para inspeccionar la base de datos.
Si quieres poder ELIMINAR o modificar de alguna otra forma los registros en la base de datos original (es decir, asegurarte de que los cambios que hagas en el conjunto de datos local se comprometan de nuevo en la base de datos), entonces necesitas tener una columna en tu tabla de base de datos que sea una clave primaria autoincrementada, ya que el método 'delete' requiere poder generar una cláusula 'where' al escribir instrucciones de nuevo en la base de datos, para identificar los registros seleccionados para su eliminación. Así que usa el siguiente código en tu cliente MySQL (todo puede escribirse en una sola línea, pero se han añadido saltos de línea para mayor claridad):
ALTER TABLE TRESTRIG
AÑADIR AUTOID DE COLUMNA INT
CLAVE PRIMARIA AUTO_INCREMENT;
y entonces verás que el botón Borrar en el navegador funciona.
Fuentes
Las fuentes de este proyecto pueden descargarse aquí Para más proyectos demo, véase sourceforge