Restaurar una base de dades MySQL a Docker | Iespai
Categorías: DockerLinux

Restaurar una base de dades MySQL a Docker: guia pas a pas



Restaurar una base de dades MySQL que funciona dins d’un contenidor Docker és una tasca que, tard o d’hora, hauràs de fer: per recuperar-te d’un error, per migrar a un servidor nou o per tenir una còpia de producció a l’entorn de proves. En aquesta guia t’explico pas a pas com fer-ho, primer amb el mètode més directe i després amb el clàssic de copiar el fitxer al contenidor.

Als exemples el contenidor es diu mysql_db, la base de dades botiga i la còpia de seguretat copia.sql. Canvia’ls pels teus.

Pas 1: fer la còpia de seguretat amb mysqldump

Si encara no tens la còpia, fes-la amb mysqldump. No cal entrar al contenidor: el pots executar amb docker exec i redirigir la sortida a un fitxer de l’amfitrió.

docker exec mysql_db sh -c 'exec mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --routines --triggers --databases botiga' > copia.sql
  • sh -c '… $MYSQL_ROOT_PASSWORD …': les cometes simples fan que la variable s’expandeixi dins del contenidor, on la imatge oficial de MySQL la té definida si l’has creat amb -e MYSQL_ROOT_PASSWORD=…. Així la contrasenya no queda a l’historial del teu terminal.
  • --single-transaction: fa una còpia coherent de les taules InnoDB sense bloquejar-les.
  • --routines --triggers: inclou els procediments emmagatzemats i els disparadors (els disparadors ja s’hi inclouen per defecte, però així queda explícit).
  • --databases botiga: afegeix al fitxer el CREATE DATABASE i el USE, de manera que en restaurar no cal crear la base de dades abans.

L’avís mysqldump: [Warning] Using a password on the command line interface can be insecure. és normal: va a la sortida d’errors i no s’escriu dins de copia.sql.

Si la base de dades no és en un contenidor, la comanda és la mateixa sense el docker exec:

mysqldump -u usuari -p --single-transaction --routines --databases botiga > copia.sql

Amb -p sense res al costat, mysqldump et demana la contrasenya. Si la poses enganxada (-pContrasenya, sense espai), funciona, però queda a l’historial i és visible a la llista de processos.

Pas 2: restaurar sense copiar res al contenidor (mètode recomanat)

La manera més senzilla és passar el fitxer a l’entrada estàndard del client mysql del contenidor. Fixa’t que es fa servir docker exec -i (sense -t):

docker exec -i mysql_db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD"' < copia.sql

Si la còpia s’ha fet sense --databases (només amb el nom de la base de dades), el fitxer no conté cap CREATE DATABASE ni USE. Llavors has de crear la base de dades i indicar-la en restaurar:

docker exec mysql_db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD" -e "CREATE DATABASE botiga CHARACTER SET utf8mb4"'
docker exec -i mysql_db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD" botiga' < copia.sql

Si la còpia està comprimida, no cal descomprimir-la a disc:

gunzip -c copia.sql.gz | docker exec -i mysql_db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD" botiga'

Compte amb -p i la redirecció. Si fas docker exec -i mysql_db mysql -u root -p botiga < copia.sql, el client intenta llegir la contrasenya de l’entrada estàndard, que és el fitxer SQL, i falla:

Enter password: ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

Per això als exemples la contrasenya es passa amb la variable de l’entorn del contenidor.

Pas 3 (alternativa): copiar el fitxer al contenidor i fer SOURCE

Aquest és el mètode de la versió original de la guia. És útil si vols treballar de manera interactiva dins del client de MySQL.

Copia el fitxer al contenidor amb docker cp:

docker cp copia.sql mysql_db:/tmp/copia.sql

Obre el client de MySQL dins del contenidor (aquí sí amb -it, perquè és interactiu i et demanarà la contrasenya):

docker exec -it mysql_db mysql -u root -p

I, dins del client, crea la base de dades (si la còpia no la crea) i carrega el fitxer:

CREATE DATABASE botiga;
USE botiga;
SOURCE /tmp/copia.sql;

Quan acabis, surt del client amb exit (o Ctrl+D); com que has obert directament mysql, tornes al terminal de l’amfitrió. Esborra la còpia del contenidor perquè no hi quedi:

docker exec mysql_db rm /tmp/copia.sql

Pas 4: comprovar la restauració

docker exec mysql_db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD" -t -e "SHOW TABLES FROM botiga; SELECT COUNT(*) FROM botiga.clients"'
+------------------+
| Tables_in_botiga |
+------------------+
| clients          |
+------------------+
+----------+
| COUNT(*) |
+----------+
|        3 |
+----------+

Compara el nombre de taules i de files amb l’original per assegurar-te que no ha faltat res.

Si fas servir Docker Compose

Amb Compose, fes servir el nom del servei (per exemple, db) en lloc del nom del contenidor. La comanda actual és docker compose (amb espai, el connector v2); l’antic docker-compose amb guió està obsolet. I per redirigir un fitxer has d’afegir -T, que desactiva el pseudoterminal:

docker compose exec -T db sh -c 'exec mysql -u root -p"$MYSQL_ROOT_PASSWORD" botiga' < copia.sql

Restaurar en un contenidor nou

Les imatges oficials de MySQL i MariaDB executen automàticament els fitxers .sql, .sql.gz i .sh que trobin a /docker-entrypoint-initdb.d la primera vegada que arrenquen amb el directori de dades buit. És una manera còmoda de crear un contenidor que ja neixi amb les dades:

docker run -d --name mysql_nou \
  -e MYSQL_ROOT_PASSWORD=canvia-la \
  -e MYSQL_DATABASE=botiga \
  -v "$PWD/copia.sql:/docker-entrypoint-initdb.d/copia.sql:ro" \
  mysql:8.0

Si el volum de dades ja té una base de dades, aquests fitxers s’ignoren.

MariaDB en lloc de MySQL

Si el contenidor és de MariaDB (la imatge mariadb, o el que instal·la Debian quan demanes «MySQL»), el procediment és el mateix, però:

  • Els clients es diuen mariadb i mariadb-dump. A les imatges recents de MariaDB és possible que els noms mysql i mysqldump ja no existeixin, així que fes servir els nous.
  • La variable de la contrasenya és MARIADB_ROOT_PASSWORD (també s’accepta MYSQL_ROOT_PASSWORD).
  • Una còpia feta amb MySQL 8 pot donar ERROR 1273 … Unknown collation: 'utf8mb4_0900_ai_ci' en restaurar-la a MariaDB, perquè aquesta col·lació no hi existeix. Cal canviar-la al fitxer per una que MariaDB conegui (per exemple, utf8mb4_unicode_ci).

Errors habituals

  • ERROR 1049 (42000): Unknown database 'botiga': la base de dades no existeix. Crea-la abans o fes la còpia amb --databases.
  • ERROR 1046 (3D000) at line …: No database selected: el fitxer no té USE i no has indicat la base de dades a la comanda.
  • ERROR 1045 (28000): Access denied: contrasenya incorrecta o, com hem vist, -p llegint del fitxer en lloc del teclat.
  • the input device is not a TTY: has fet servir -t (o -it) amb una redirecció <. Treu la t.

Conclusió

Amb aquests passos pots restaurar una base de dades MySQL en un contenidor Docker de manera fiable. El mètode de redirigir el fitxer amb docker exec -i és el més ràpid i no deixa còpies dins del contenidor; el de docker cp i SOURCE continua sent útil quan vols fer-ho pas a pas. I recorda que una còpia de seguretat només val si l’has provat de restaurar alguna vegada.

Posts relacionats

Esta web usa cookies.