Curso de MariaDB / Instalar MariaDB en Windows y comprobar el servidor y la conexión

En Windows puede instalar MariaDB Server con un paquete MSI y ejecutarlo como servicio. Anote el nombre del servicio, el puerto y la contraseña de administración, y compruebe tanto la conexión del cliente como una consulta SQL antes de comenzar los ejercicios de bases de datos.

Comprobar el equipo antes de instalar

Esta guía describe una nueva instalación local de aprendizaje en Windows 11 de 64 bits. Instalar el MSI y modificar servicios puede requerir permisos de administrador. Si ya tiene MariaDB o MySQL, distinga una actualización de esa instancia de la creación de otra independiente. La introducción a MariaDB y a la diferencia entre servidor y cliente ayuda a elegir los componentes que necesita.

Primero consulte los servicios y puertos de escucha en PowerShell. El nombre mostrado de un servicio puede diferir de su propiedad Name. Un nombre desconocido no significa que los datos de esa instancia se puedan descartar.

Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue

En un ordenador sin servidor previo, un resultado vacío es normal. Si aparece uno, averigüe para qué se utiliza antes de detenerlo o reutilizar su directorio de datos. Una instancia independiente necesita un nombre de servicio distinto y, si el puerto está ocupado, otro puerto. Adapte todos los comandos de conexión al puerto que elija realmente.

Descargar el MSI y elegir los componentes

  1. En la página oficial de descargas MariaDB, elija una versión estable de MariaDB Server con mantenimiento y su paquete Windows x64 MSI. Las versiones preliminares no son el punto de partida de esta instalación para principiantes.
  2. Ejecute el MSI, revise la licencia y continúe a Custom Setup si acepta sus condiciones. Compruebe que estén seleccionados el servidor, el cliente y el componente Database instance para crear una nueva instancia.
  3. Anote la ruta de instalación y el directorio de datos. Los ejemplos usan C:\Program Files\MariaDB 12.3\; sustitúyala por su ruta real si es diferente. Una herramienta gráfica como HeidiSQL es opcional para estos ejercicios de línea de comandos.

Los nombres y la distribución de las pantallas pueden cambiar entre versiones. La guía oficial de instalación MSI en Windows describe las opciones de la instancia. No elija actualizar una instancia existente solo porque el asistente ofrezca esa posibilidad.

Configurar el servicio, el administrador y la conexión

Opción Elección para una instancia local de aprendizaje
Contraseña de root Elija una contraseña robusta y guárdela de forma segura; root es el administrador de la base.
Acceso remoto de root Déjelo desactivado para este ejercicio local.
Cuenta anónima Déjela desactivada.
Servicio de Windows Instale como servicio y anote su nombre real.
Puerto TCP Use 3306 si está libre, o anote un puerto diferente.
Opción de juego de caracteres Una opción UTF-8 del instalador no sustituye la configuración explícita utf8mb4 de las bases.

La contraseña del administrador MariaDB no es su contraseña de inicio de sesión de Windows. Después de comprobar el servidor, creará otra cuenta para practicar SQL. El acceso local por 127.0.0.1 no requiere abrir el puerto del servidor a redes externas. Finalice la instalación y anote cualquier error en lugar de dar por hecho que el servidor ha arrancado.

Iniciar el servicio y verificar una conexión administrativa

Si el servicio se llama MariaDB, utilice estos comandos PowerShell. Sustituya el nombre si eligió otro. Iniciar un servicio puede requerir una ventana de PowerShell ejecutada como administrador.

Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB

El último estado debe ser Running. El acceso directo MariaDB Command Prompt de la instalación puede incluir ya el directorio del cliente en su ruta. En una ventana PowerShell ordinaria, una ruta explícita al ejecutable evita depender de esa configuración:

& "C:\Program Files\MariaDB 12.3\bin\mariadb.exe" --protocol=tcp --host=127.0.0.1 --port=3306 --user=root --password --default-character-set=utf8mb4

El operador & de PowerShell ejecuta la ruta entre comillas. Use su ruta y puerto reales. La opción --password sin valor solicita la contraseña de forma interactiva y evita escribirla en el comando. Una vez conectado, ejecute dentro del cliente:

SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;

El servidor debe devolver su versión y el resultado del cálculo, 2. Poder abrir el programa cliente sin establecer la conexión no demuestra que el servidor funcione. Si hay varios servidores locales, compruebe el puerto de esta instancia antes de interpretar la versión obtenida.

Crear una cuenta limitada a la base de prácticas

Utilice root para la preparación y después course_user para aprender. Compruebe primero si ese nombre ya existe:

SELECT User, Host FROM mysql.user WHERE User = 'course_user';

Si encuentra una cuenta, revise su host y finalidad antes de borrarla o recrearla. Para una nueva cuenta del curso, sustituya el marcador de contraseña siguiente por una contraseña propia robusta y ejecute como administrador:

CREATE USER 'course_user'@'127.0.0.1'
  IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';

GRANT ALL PRIVILEGES ON shopcourse.*
  TO 'course_user'@'127.0.0.1';

SHOW GRANTS FOR 'course_user'@'127.0.0.1';

El nombre completo de una cuenta incluye usuario y host. Estos ejemplos conectan deliberadamente por TCP a 127.0.0.1 y conceden derechos a esa cuenta de host. El alcance shopcourse.* permite trabajar en la base de prácticas, incluso crearla, sin privilegios globales ni permiso para conceder derechos a otros usuarios. Es válido otorgar este alcance antes de que exista la base.

Una aplicación de producción suele necesitar permisos más restringidos según su trabajo. Las referencias oficiales de CREATE USER y GRANT explican estas reglas.

Salga del cliente con \q y vuelva a conectarse desde el terminal. El siguiente comando supone que mariadb está en la ruta de búsqueda; si no lo está, use el ejecutable con la ruta completa y el operador & del ejemplo anterior.

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
SELECT CURRENT_USER() AS privilege_account;

Ejecute el último SELECT dentro de la nueva conexión. La cuenta de privilegios debe ser course_user@127.0.0.1. La opción --abort-source-on-error prepara el cliente para detenerse ante un error en un archivo ejecutado con SOURCE; no cambia el alcance de los permisos del usuario. En este procedimiento, CREATE USER y GRANT tienen efecto sin ejecutar manualmente FLUSH PRIVILEGES.

Diagnosticar los problemas habituales

  • El servicio no arranca: compruebe su nombre, un posible conflicto de puerto y el registro de errores de esa instancia. Conserve su directorio de datos.
  • No se encuentra el comando cliente: use la ruta real completa o MariaDB Command Prompt de la instalación.
  • No se puede conectar: compruebe que el servicio previsto está activo y que el host y el puerto del comando corresponden a él.
  • Aparece Access denied: verifique la contraseña y el host de la cuenta MariaDB. Un fallo de autenticación es distinto de un servidor detenido.

Antes de editar el my.ini de una instancia de aprendizaje, guarde el archivo original y anote su ubicación. Modifique una sola opción, reinicie esa instancia y compruebe el resultado. Restaure la copia si el cambio impide el arranque. Detener un servicio, desinstalar un programa y borrar archivos de bases de datos son acciones diferentes: eliminar datos no es una solución habitual a un problema de acceso.