Skip to content

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:

Server=localhost;Port=3306;Database=dbarticles;User=root;Password=

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:

> mysql -u root

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:

1
2
3
> cd csharp-oct-2026\10-adonet\sql
> mysql -u root < dbarticles.sql
> mysql -u root < dbtaxes.sql

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.