16.4 Configuration InnoDB

Pour utiliser les tables InnoDB en MySQL versions 3.23, voyez InnoDB en MySQL 3.23 .

En MySQL 4.0, vous n'avez rien à faire pour obtenir le support des tables InnoDB . Si vous ne souhaitez pas utiliser les tables InnoDB , vous pouvez ajouter l'option skip-innodb dans votre fichier d'options MySQL.

Si vous ne spécifiez aucune options de configuration InnoDB , MySQL 4.0 et plus récent créera un fichier de données auto-croissant appelé ibdata1 et deux fichiers de log de 5 Mo appelés ib_logfile0 et ib_logfile1 dans le dossier de données MySQL. En MySQL 4.0.0 et 4.0.1, le fichier de données est de 64 Mo et pas auto-croissant. En MySQL 3.23, InnoDB ne démarrera pas si vous ne fournissez pas d'options de configuration.

Pour configurer le fichier de données InnoDB , utilisez l'option innodb_data_file_path dans la section [mysqld] du fichier my.cnf . Sous Windows, vous pouvez utiliser my.ini à la place. La valeur de innodb_data_file_path doit être une liste d'un ou plusieurs fichiers. Si vous indiquez plusieurs fichiers, séparez les noms par des caractères points-virgules ( ';' ) :

innodb_data_file_path=datafile_spec1[;datafile_spec2]...

[mysqld]
innodb_data_file_path=ibdata1:10M:autoextend

Une table contenant 50 Mo de données, appelée ibdata1 et un fichier 50 Mo auto-croissant, appelé ibdata2 dans le dossier de données est configuré comme ceci :

[mysqld]
innodb_data_file_path=ibdata1:50M;ibdata2:50M:autoextend

file_name:file_size[:autoextend[:max:max_file_size]]

Si le disque est plein, vous aurez à ajouter un autre fichier sur un autre disque. Les informations pour reconfigurer une table existante sont données dans la section Ajout et suppression des fichiers de logs et de données InnoDB .

[mysqld]
innodb_data_file_path=ibdata1:10M:autoextend:max:500M

[mysqld]
innodb_data_home_dir = /ibdata
innodb_data_file_path=ibdata1:50M;ibdata2:50M:autoextend

InnoDB forme le chemin de chaque fichier en concaténant textuellement la valeur de innodb_data_home_dir devant le nom du fichier, en ajoutant un slash si nécessaire. Si l'option innodb_data_home_dir n'est pas mentionnée dans my.cnf , la valeur par défaut est le dossier ``point'' ./ , c'est à dire le dossier de données de MySQL.

[mysqld]
innodb_data_home_dir =
innodb_data_file_path=/ibdata/ibdata1:50M;/ibdata/ibdata2:50M:autoextend

[mysqld]
# Vous pouvez placer d'autres options MYSQL ici
# ...
# Le fichier de données doit contenir vos données et index.
# Assurez vous que vous avez l'espace disque nécessaire.
innodb_data_file_path = ibdata1:10M:autoextend
#
# Utilisez un buffer de taille 50 à 80 % de votre mémoire serveur
set-variable = innodb_buffer_pool_size=70M
set-variable = innodb_additional_mem_pool_size=10M
#
# Utiisez un fichier de log de taille 25 % du buffer mémoire
set-variable = innodb_log_file_size=20M
set-variable = innodb_log_buffer_size=8M
#
innodb_flush_log_at_trx_commit=1

Lorsque vous créez pour la première fois une base de données InnoDB , il est mieux de lancer le serveur depuis la commande en ligne. InnoDB va afficher des informations sur la création de la base, et vous verrez commence ça se passe. Voyez la section plus bas, pour une illustration. Par exemple, sous Windows, vous pouvez démarrer mysqld-max.exe , qui est stocké dans C:\mysql\bin , vous pouvez le démarrer comme ceci :

C:\> C:\mysql\bin\mysqld-max --console

Voyez Créer un Tablespace InnoDB pour un exemple des informations affichées par InnoDB .

• Un seul des deux fichiers my.cnf ou my.ini doit être créé.
• Le fichier my.cnf doit être placé dans le dossier racine du disque C: .
• Le fichier my.ini doit être placé dans le dossier WINDIR , e.g, C:\WINDOWS ou C:\WINNT . Vous pouvez utiliser la commande SET de MS-DOS pour afficher la valeur de WINDIR :

  C:\> SET WINDIR windir=C:\WINNT

• Si votre PC utilise un gestionnaire de démarrage où le C: n'est pas votre disque de démarrage, alors votre seule option est d'utilise le fichier my.ini .

• /etc/my.cnf Options globales.
• COMPILATION_DATADIR/my.cnf Options spécifiques au serveur.
• defaults-extra-file Le fichier spécifié avec --defaults-extra-file=... .
• ~/.my.cnf Options spécifiques à l'utilisateur.

Si vous voulez vous assurer que mysqld lit les options uniquement depuis un fichier spécifique, vous pouvez utiliser l'option --defaults-option comme première option de ligne de commande, au démarrage du serveur :

mysqld --defaults-file=your_path_to_my_cnf

[mysqld]
# Vous pouvez placer d'autres options MYSQL ici
# ...
innodb_data_home_dir =
#
# Le fichier de données doivent contenir vos données et index.
innodb_data_file_path = /ibdata/ibdata1:2000M;/dr2/ibdata/ibdata2:2000M:autoextend
#
# Utilisez un buffer de taille 50 à 80 % de votre mémoire serveur
# mais assurez vous sous Linux que l'utilisation totale est inférieure à 2 Go
set-variable = innodb_buffer_pool_size=1G
set-variable = innodb_additional_mem_pool_size=20M
innodb_log_group_home_dir = /dr3/iblogs
#
# innodb_log_arch_dir doit être le même que  innodb_log_group_home_dir
# (starting from 4.0.6, you can omit it)
innodb_log_arch_dir = /dr3/iblogs
set-variable = innodb_log_files_in_group=2
#
# Utilisez un fichier de log de taille 15 % du buffer mémoire
set-variable = innodb_log_file_size=250M
set-variable = innodb_log_buffer_size=8M
#
innodb_flush_log_at_trx_commit=1
set-variable = innodb_lock_wait_timeout=50
#
# Décommentez les prochaines lignes, si vous voulez les utiliser
#innodb_flush_method=fdatasync
#set-variable = innodb_thread_concurrency=5

innodb_buffer_pool_size
+ key_buffer_size
+ max_connections*(sort_buffer_size+read_buffer_size+binlog_cache_size)
+ max_connections*2MB

Comment optimiser d'autres paramètres du serveur mysqld ? Les valeurs qui conviennent à la majorité des utilisateurs sont :

[mysqld]
skip-external-locking
set-variable = max_connections=200
set-variable = read_buffer_size=1M
set-variable = sort_buffer_size=1M
# key_buffer vaut de 5 à 50%
# de la RAM disponible, suivant l'utilisation des
# tables MyISAM, mais gardez
# key_buffer + InnoDB en deça de < 80% de votre RAM
set-variable = key_buffer_size=...