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 elCREATE DATABASEi elUSE, 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
mariadbimariadb-dump. A les imatges recents de MariaDB és possible que els nomsmysqlimysqldumpja no existeixin, així que fes servir els nous. - La variable de la contrasenya és
MARIADB_ROOT_PASSWORD(també s’acceptaMYSQL_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éUSEi no has indicat la base de dades a la comanda.ERROR 1045 (28000): Access denied: contrasenya incorrecta o, com hem vist,-pllegint del fitxer en lloc del teclat.the input device is not a TTY: has fet servir-t(o-it) amb una redirecció<. Treu lat.
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.