15. Apéndices
15.1. DBMS y MySQL con Laragon
En 2008, los apéndices del curso describían la instalación de SQL Server 2005 Express y de MySQL 5, sus herramientas de administración (MySQL GUI Tools) y sus controladores ODBC, con unas treinta capturas de pantalla. Los Capítulos 10 y 11 de este documento usan únicamente MySQL 8, y la forma más fácil de instalarlo en Windows es instalar Laragon, un entorno de desarrollo portátil que incluye, entre otras cosas, MySQL, el cliente gráfico HeidiSQL, una terminal configurada, Apache y PHP. El autor también lo usa para sus cursos de PHP.
15.1.1. Instalación
Laragon puede descargarse desde https://laragon.org. La instalación es estándar; puede conservar la carpeta de instalación sugerida ([C:\laragon]). Laragon proporciona MySQL 8 (la versión exacta depende de la versión de Laragon), con una cuenta de administrador sin contraseña ([root]) y un servidor que escucha en el puerto 3306 de la máquina local. Esta es la configuración que suponen los ejemplos de este documento, donde las cadenas de conexión tienen la forma:
Si MySQL se instaló de otra manera, con una contraseña para [root], debe reemplazarla en [Password=] en las cadenas de conexión de los ejemplos (archivos [appsettings.json] o constantes al inicio de los programas).
En un sistema sin Laragon, también puede instalar MySQL Community Server desde https://dev.mysql.com/downloads/mysql/, o su derivado de código abierto, MariaDB. Sin embargo, los ejemplos solo se han probado con MySQL 8: los scripts del Capítulo 10 usan una intercalación específica de MySQL 8 ([utf8mb4_0900_ai_ci]), y los ejemplos del Capítulo 11 pasan una versión del servidor MySQL ([MySqlServerVersion]) a Pomelo; con MariaDB, habría que ajustar estos dos puntos.
15.1.2. Inicio y detención de MySQL
La ventana principal de Laragon incluye un botón “Start All” que inicia los servidores (Apache y MySQL) y un botón “Stop” que los detiene. A diferencia de la instalación de MySQL 5 descrita en 2008, MySQL no es un servicio de Windows que se ejecute al iniciar el sistema: solo se ejecuta cuando se inicia desde Laragon, lo que evita que consuma recursos cuando no se usa. El menú de Laragon (clic derecho en la ventana) también permite iniciar solo MySQL y seleccionar su versión.
Cuando MySQL no está en ejecución, los programas de los Capítulos 10 y 11 fallan con una excepción que indica que no se pudo establecer ninguna conexión (“Unable to connect to any of the specified MySQL hosts”): esto es lo primero que hay que verificar si se produce un error.
15.1.3. El cliente de línea de comandos
El botón Terminal de Laragon abre una terminal donde están disponibles los comandos de Laragon, incluido el cliente de línea de comandos de MySQL [mysql]. Para conectarse al servidor, use:
luego ingrese comandos SQL terminados con punto y coma ([show databases;], [use dbarticles;], [select * from articles;]) y [exit] para salir. El cliente también puede ejecutar un script SQL, como lo hace el Capítulo 10 para crear sus bases de datos:
Los scripts recrean completamente su base de datos cada vez que se ejecutan: puede volver a ejecutarlos para restaurar los datos a su estado inicial después de las pruebas.
15.1.4. El cliente gráfico HeidiSQL
El botón Database de Laragon inicia el cliente gráfico HeidiSQL, que reemplaza a las MySQL GUI Tools de 2008 (hoy obsoletas). En el primer inicio, HeidiSQL ofrece una sesión de conexión ya configurada para el servidor MySQL de Laragon (host [127.0.0.1], usuario [root], contraseña vacía, puerto 3306); basta con abrirla. Verá lo siguiente:
- a la izquierda, la vista de árbol de las bases de datos del servidor y sus tablas;
- a la derecha, pestañas que muestran la estructura de una tabla, sus datos (que pueden editarse directamente) y un campo para ingresar consultas SQL (la pestaña "Query"), que se ejecutan con [F9].
Para crear una base de datos con un script del Capítulo 10, abra el script (desde el menú “File”, con el comando “Load SQL file”) en una pestaña de consulta y luego ejecútelo ([F9]). También puede crear una base de datos, un usuario y los permisos del usuario mediante los menús de HeidiSQL (clic derecho en la conexión / “Create New” / "Database"; menú "Tools" / "User Manager"), pero los scripts SQL tienen la ventaja de ser reproducibles y poder volver a ejecutarse.
15.1.5. Las bases de datos de este documento
Los Capítulos 10 y 11 usan las siguientes bases de datos, todas ubicadas en el servidor MySQL local:
Base de datos | Capítulo | Creación |
[dbarticles] | 10 | Script [10-adonet/sql/dbarticles.sql]: tabla [articles] de los ejemplos de ADO.NET |
[dbtaxes] | 10 | script [10-adonet/sql/dbtaxes.sql]: la tabla [brackets] de la versión 6 de la aplicación [Tax] y el usuario [admtaxes] |
[efarticles], [efshop], [efclients] | 11 | creadas por los propios programas ([EnsureCreated]) o por migraciones de EF Core ([dotnet ef database update]) |
[eftaxes] | 11 | creada por la migración del proyecto de la versión 7 de la aplicación [Tax] |
Una vez finalizadas las pruebas, una base de datos puede eliminarse con el comando SQL [drop database name;], en el cliente [mysql], o en HeidiSQL.
15.2. Los paquetes NuGet utilizados
La siguiente tabla resume las bibliotecas NuGet utilizadas por los ejemplos, junto con las versiones con las que se probaron. Se descargan automáticamente mediante el comando [dotnet] durante la primera compilación (por lo que se requiere acceso a Internet en ese momento).
Paquete | Versión | Capítulos |
[Microsoft.Extensions.DependencyInjection] | 10.0.12 | 6, 10, 11, 12 |
[Microsoft.Extensions.Configuration.Json] | 10.0.12 | 6, 10, 11, 12 |
[MSTest] | 4.0.2 | 6, 10 |
[MySqlConnector] | 2.4.0 | 10 |
[Microsoft.EntityFrameworkCore] | 9.0.0 | 11 |
[Microsoft.EntityFrameworkCore.Relational] | 9.0.0 | 11 |
[Microsoft.EntityFrameworkCore.Design] | 9.0.0 | 11 |
[Pomelo.EntityFrameworkCore.MySql] | 9.0.0 | 11 |
[Microsoft.Extensions.Http] | 10.0.12 | 13 |
La herramienta de migraciones de EF Core se instala una sola vez con el comando [dotnet tool install --global dotnet-ef --version 9.0.0] (Capítulo 11). ASP.NET Core (Capítulos 12 y 13) forma parte del SDK y no requiere ningún paquete.