15. Apêndices
15.1. SGBD e MySQL com Laragon
Em 2008, os apêndices do curso descreviam a instalação do SQL Server 2005 Express e do MySQL 5, suas ferramentas de administração (MySQL GUI Tools) e seus drivers ODBC, com cerca de trinta capturas de tela. Os Capítulos 10 e 11 deste documento usam apenas o MySQL 8, e a maneira mais fácil de instalá-lo no Windows é instalar o Laragon, um ambiente de desenvolvimento portátil que inclui, entre outras coisas, o MySQL, o cliente gráfico HeidiSQL, um terminal configurado, o Apache e o PHP. O autor também o usa em seus cursos de PHP.
15.1.1. Instalação
O Laragon pode ser baixado em https://laragon.org. A instalação é padrão; você pode manter a pasta de instalação sugerida ([C:\laragon]). O Laragon fornece o MySQL 8 (a versão exata depende da versão do Laragon), com uma conta de administrador sem senha ([root]) e um servidor escutando na porta 3306 da máquina local. Essa é a configuração presumida pelos exemplos deste documento, nos quais as strings de conexão têm a forma:
Se o MySQL foi instalado de outra forma, com uma senha para [root], você deve informá-la em [Password=] nas strings de conexão dos exemplos (arquivos [appsettings.json] ou constantes no início dos programas).
Em um sistema sem o Laragon, você também pode instalar o MySQL Community Server a partir de https://dev.mysql.com/downloads/mysql/, ou seu derivado de código aberto, o MariaDB. No entanto, os exemplos foram testados apenas com o MySQL 8: os scripts do Capítulo 10 usam uma collation específica do MySQL 8 ([utf8mb4_0900_ai_ci]), e os exemplos do Capítulo 11 passam uma versão de servidor MySQL ([MySqlServerVersion]) ao Pomelo; com o MariaDB, esses dois pontos precisariam ser ajustados.
15.1.2. Iniciando e parando o MySQL
A janela principal do Laragon inclui um botão “Start All” que inicia os servidores (Apache e MySQL) e um botão “Stop” que os interrompe. Ao contrário da instalação do MySQL 5 descrita em 2008, o MySQL não é um serviço do Windows executado na inicialização do sistema: ele só roda quando iniciado pelo Laragon, o que evita que consuma recursos quando não está em uso. O menu do Laragon (clique com o botão direito na janela) também permite iniciar apenas o MySQL e selecionar sua versão.
Quando o MySQL não está em execução, os programas dos Capítulos 10 e 11 falham com uma exceção indicando que não foi possível estabelecer uma conexão (“Unable to connect to any of the specified MySQL hosts”): essa é a primeira coisa a verificar se ocorrer um erro.
15.1.3. O cliente de linha de comando
O botão Terminal do Laragon abre um terminal no qual os comandos do Laragon estão disponíveis, incluindo o cliente de linha de comando do MySQL [mysql]. Para se conectar ao servidor, use:
em seguida, digite comandos SQL terminados por ponto e vírgula ([show databases;], [use dbarticles;], [select * from articles;]) e [exit] para sair. O cliente também pode executar um script SQL, o que o Capítulo 10 faz para criar seus bancos de dados:
Os scripts recriam completamente o banco de dados a cada execução: você pode executá-los novamente para restaurar os dados ao estado inicial após os testes.
15.1.4. O cliente gráfico HeidiSQL
O botão Database do Laragon inicia o cliente gráfico HeidiSQL, que substitui as MySQL GUI Tools de 2008 (hoje obsoletas). Na primeira execução, o HeidiSQL oferece uma sessão de conexão já configurada para o servidor MySQL do Laragon (host [127.0.0.1], usuário [root], senha em branco, porta 3306); basta abri-la. Você verá:
- à esquerda, a árvore dos bancos de dados do servidor e de suas tabelas;
- à direita, guias que exibem a estrutura de uma tabela, seus dados (que podem ser editados diretamente) e um campo para digitar consultas SQL (a guia "Query"), que são executadas por [F9].
Para criar um banco de dados com um script do Capítulo 10, abra o script (pelo menu “File”, com o comando “Load SQL file”) em uma guia de consulta e execute-o ([F9]). Você também pode criar um banco de dados, um usuário e permissões de usuário pelos menus do HeidiSQL (clique com o botão direito na conexão / “Create New” / "Database"; menu "Tools" / "User Manager"), mas os scripts SQL têm a vantagem de serem reproduzíveis e poderem ser executados novamente.
15.1.5. Os bancos de dados deste documento
Os Capítulos 10 e 11 usam os seguintes bancos de dados, todos localizados no servidor MySQL local:
Banco de dados | Capítulo | Criação |
[dbarticles] | 10 | Script [10-adonet/sql/dbarticles.sql]: tabela [articles] dos exemplos de ADO.NET |
[dbtaxes] | 10 | script [10-adonet/sql/dbtaxes.sql]: a tabela [brackets] da versão 6 da aplicação [Tax] e o usuário [admtaxes] |
[efarticles], [efshop], [efclients] | 11 | criados pelos próprios programas ([EnsureCreated]) ou por migrações do EF Core ([dotnet ef database update]) |
[eftaxes] | 11 | criado pela migração do projeto da versão 7 da aplicação [Tax] |
Concluídos os testes, um banco de dados pode ser excluído com o comando SQL [drop database name;], no cliente [mysql], ou no HeidiSQL.
15.2. Os pacotes NuGet utilizados
A tabela a seguir resume as bibliotecas NuGet usadas pelos exemplos, com as versões com as quais os exemplos foram testados. Elas são baixadas automaticamente pelo comando [dotnet] durante a primeira compilação (portanto, é necessário acesso à Internet nesse momento).
Pacote | Versão | 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 |
A ferramenta de migração do EF Core é instalada uma única vez com o comando [dotnet tool install --global dotnet-ef --version 9.0.0] (Capítulo 11). O ASP.NET Core (Capítulos 12 e 13) faz parte do SDK e não requer nenhum pacote.