Guida all'aggiornamento per MySQL 4.* o 5.0.*

1.  Aggiornamento diretto, consigliato per la migrazione da 4.1 a 5.0

Il motore myisam della versione 4.1 è abbastanza maturo da permette un aggiornamento diretto alla successiva versione maggiore di MySQL.

Per questo passo sono richieste due shell, poiché una è occupata dalla sessione di mysql.

# quickpkg dev-db/mysql
# alias MYSQL="mysql --user=root
--password='propria_password'"
# DATADIR=$(MYSQL --batch --raw --silent --skip-column-names \
   --execute='SHOW variables LIKE "datadir";' \
   | sed -e 's|datadir[ \t]||')

(Il comando seguente bisogna eseguirlo in una seconda shell)
# mysql --user=root --password='propria_password'
mysql> FLUSH TABLES WITH READ LOCK;

(Ritornare alla prima shell e lanciare questi comandi)
# tar -cjpvf ~/mysql.$(date +%F"T"%H-%M).tar.bz2 \
   /etc/conf.d/mysql /etc/mysql/my.cnf "${DATADIR}"
# MYSQL --execute="UNLOCK TABLES;"
# tar -tjvf ~/mysql.*.tar.bz2
# emerge -av ">dev-db/mysql-5.0"
# dispatch-conf
# revdep-rebuild
# /etc/init.d/mysql restart
# mysql_upgrade_shell --user=root
--password='propria_password' \
   --protocol=tcp --datadir="${DATADIR}"
# /etc/init.d/mysql restart
# unset DATADIR
# unalias MYSQL

2.  Aggiornamento da precedenti versioni di MySQL

Gli utenti che aggiornano da una vecchia versione di MySQL (<4.0.24) devono prima installare MySQL 4.0.25. Chi invece già usa la versione corrente può tranquillamente saltare questa sezione e continuare con la prossima.

# emerge -av --buildpkg "<mysql-4.1"

3.  Creazione backup di tutti i dati correnti

Uno dei più importanti compiti di ogni amministratore è quello di fare un backup di tutti i dati. Ecco come fare:

# mysqldump \
  -uroot \
  --password='propria_password' \
  -hlocalhost \
  --all-databases \
  --opt \
  --allow-keywords \
  --flush-logs \
  --hex-blob \
  --master-data \
  --max_allowed_packet=16M \
  --quote-names \
  --result-file=BACKUP_MYSQL_4.0.SQL

Adesso dovrebbe esserci il file BACKUP_MYSQL_4.0.SQL, che più avanti può essere utilizzato per ripristinare i dati. I dati sono stati scritti in sintassi SQL, Structured Query Language.

Probabilmente converrà controllare se il backup funziona prima di procedere ulteriormente.

4.  Aggiornamento da versioni recenti di MySQL

Se si è saltato il passo #1, adesso si deve creare un pacchetto di backup (del server database, non dei dati) della versione correntemente installata:

# quickpkg dev-db/mysql

Ora bisogna eliminare la versione installata con tutti i suoi dati:

# /etc/init.d/mysql stop
# emerge -C mysql
# tar cjpvf ~/mysql.$(date +%F"T"%H-%M).tar.bz2 /etc/mysql/my.cnf /var/lib/mysql/
# ls -l ~/mysql.*
# rm -rf /var/lib/mysql/ /var/log/mysql

Dopo aver eliminato completamente la vecchia installazione di MySQL, si può procedere con l'installazione della nuova versione. Notare che revdep-rebuild è necessario per riemergere i pacchetti linkati a MySQL.

# emerge -av ">mysql-4.1"
(Aggiornare i file di configurazione, è possibile anche usare dispatch-conf)
# etc-update
# revdep-rebuild

Adesso si deve configurare la nuova versione installata di MySQL e riavviare il demone:

# emerge --config =mysql-4.1.<micro_version>
# /etc/init.d/mysql start

Infine bisogna importare il backup creato in precedenza:

Vecchie versioni delle utility mysqldump potrebbero esportare le tabelle in un ordine errato se vengono usate le foreign keys. Per evitare questo problema, frapporre il comando SQL tra questi due:

SET FOREIGN_KEY_CHECKS=0
SET FOREIGN_KEY_CHECKS=1

Poi, importare il backup.

# cat BACKUP_MYSQL_4.0.SQL \
     | mysql \
     -uroot \
     --password='propria_password' \
     -hlocalhost \
     --max_allowed_packet=16M

# mysql_fix_privilege_tables \
     --defaults-file=/etc/mysql/my.cnf \
     --user=root \
     --password='propria_password' \

Adesso, riavviando il demone di MySQL, se tutto va come previsto si avrà MySQL con versione 4.1.x perfettamente funzionante. :-)

# /etc/init.d/mysql restart

Se ci sono stati problemi durante il processo di upgrade, per favore riportarli su Gentoo Bugzilla.

5.  Ripristinare la vecchia versione di MySQL 4.0

Se non si è soddisfatti di MySQL 4.1, è possibile ritornare indietro alla 4.0.

# /etc/init.d/mysql stop
# emerge -C mysql
# rm -rf /var/lib/mysql/ /var/log/mysql
# emerge --usepkgonly "<mysql-4.1"
(Sostituire <timestamp> con quello usato durante la creazione del backup.)
# tar -xjpvf mysql.<timestamp>.tar.bz2 -C /
# /etc/init.d/mysql start

6.  Conversione del charset

Introduzione

Questo capitolo non è stato scritto per essere una guida completa su come effettuare queste conversioni, ma come una breve lista di suggerimenti che l'utente può approfondire da solo in seguito.

Convertire un database può essere un lavoro complesso e la difficoltà aumenta con il variare dei dati presenti. Per esempio quando si lavora con serialized object o blobs è uno dei casi dove è difficile effettuare la conversione senza problemi.

Indici

Ogni carattere utf-8 è considerato lungo 3 byte compreso un indice. Gli indici in MySQL possono essere grandi al massimo 1000 byte (767 per le tabelle di InnoDB). Notare che i limiti sono misurati in byte, considerato che la lunghezza di una colonna è interpretata come un numero di caratteri.

MySQL può inoltre creare indici come parti di una colonna, questo può essere un po' d'aiuto. Qui sotto ci sono alcuni esempi:

$ mysql -uroot -p'propria_password' test

mysql> SHOW variables LIKE "version" \G
*************************** 1. row ***************************
Variable_name: version
Value: 5.0.24-log
1 row in set (0.00 sec)

mysql> CREATE TABLE t1 (
->   c1 varchar(255) NOT NULL default '',
->   c2 varchar(255) NOT NULL default ''
->   ) ENGINE=MyISAM DEFAULT CHARSET=utf8;
Query OK, 0 rows affected (0.01 sec)

mysql> ALTER TABLE t1
->   ADD INDEX idx1 ( c1 , c2 );
ERROR 1071 (42000): Specified key was too long; max key length is 1000 bytes

mysql> ALTER TABLE t1
->   ADD INDEX idx1 ( c1(165) , c2(165) );
Query OK, 0 rows affected (0.01 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> CREATE TABLE t2 (
->   c1 varchar(255) NOT NULL default '',
->   c2 varchar(255) NOT NULL default ''
->   ) ENGINE=MyISAM DEFAULT CHARSET=sjis;
Query OK, 0 rows affected (0.00 sec)

mysql> ALTER TABLE t2
->   ADD INDEX idx1 ( c1(250) , c2(250) );
Query OK, 0 rows affected (0.03 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> CREATE TABLE t3 (
->   c1 varchar(255) NOT NULL default '',
->   c2 varchar(255) NOT NULL default ''
->   ) ENGINE=MyISAM DEFAULT CHARSET=latin1;
Query OK, 0 rows affected (0.00 sec)

mysql> ALTER TABLE t3
->   ADD INDEX idx1 ( c1 , c2 );
Query OK, 0 rows affected (0.03 sec)
Records: 0  Duplicates: 0  Warnings: 0

Ambiente

Il sistema deve essere configurato per supportare il locale UTF-8. Maggiori informazioni è possibile trovarle nelle guide: Usare UTF-8 con Gentoo e Guida alla localizzazione

In questo esempio, verranno impostate alcune variabili d'ambiente in /etc/env.d/02locale per far in modo che il sistema utilizzi il locale inglese UTF-8:

LC_ALL=en_US.UTF-8
LANG=en_US.UTF-8

Dopo aver configurato il file è necessario lanciare env-update && source /etc/profile

iconv

iconv, fornito dal pacchetto sys-libs/glibc, è utilizzato per convertire file di testo da una codifica ad un'altra. La stessa funzione si può ottenere con il pacchetto app-text/recode.

(Da latin1 a utf8)
$ iconv -f ISO-8859-15 -t UTF-8 file1.sql > file2.sql

(Da Japanese a utf8)
$ iconv -f ISO2022JP -t UTF-8 file1.sql > file2.sql

iconv può essere utilizzato per recodificare dei dump sql anche se l'ambiente non è impostato su utf8.

SQL Mangling

E' possibile utilizzare le funzioni di MySQL CONVERT() e CAST() per convertire i dati nei proprio script SQL.

Apache (server web)

Per usare utf-8 con apache, bisogna modificare le seguenti variabili nel file httpd.conf: AddDefaultCharset, CharsetDefault, CharsetSourceEnc. Se i file html non sono codificati in utf-8, essi devono essere convertiti usando iconv o recode.

I contenuti di questo documento sono rilasciati sotto la licenza Creative Commons - Attribution / Share Alike.