Skip navigation links
8.1.4 ALTER FUNCTION 構文 »
Section Navigation      [Toggle]

8.1.3. ALTER LOGFILE GROUP 構文

ALTER LOGFILE GROUP logfile_group
    ADD UNDOFILE 'file_name'
    [INITIAL_SIZE [=] size]
    [WAIT]
    ENGINE [=] engine_name

このステートメントは、'file_name' という名前の UNDO ファイルを既存のログファイルグループ logfile_group に追加します。ALTER LOGFILE GROUP ステートメントは ADD UNDOFILE 節を 1 つだけ持ちます。DROP UNDOFILE 節は、現在サポートされていません。

注意

すべての MySQL Cluster ディスクデータオブジェクトが同じ名前空間を共有します。つまり、各ディスクデータオブジェクトは (単に、特定の型の各ディスクデータオブジェクトというだけでなく) 一意に名前が付けられている必要があります。たとえば、テーブル領域と UNDO ログファイルを同じ名前にしたり、UNDO ログファイルとデータファイルを同じ名前にしたりすることはできません。

MySQL Cluster NDB 6.2.17、6.3.23、および 6.4.3 より前のバージョンでは、UNDO ログファイルのパスとファイル名を 128 文字より長くすることができませんでした。(Bug#31769)

オプションの INITIAL_SIZE パラメータは、UNDO ファイルの初期サイズをバイト単位で設定します。指定されていない場合、初期サイズはデフォルトで 128M (128M バイト) になります。my.cnf で利用されているものと同様、大きさによって一文字の省略形を持つ size に従うこともできます。通常これは M (メガバイト) か G (ギガバイト) のどちらかの文字です。

32 ビットシステムでは、INITIAL_SIZE でサポートされる最大値は 4G です。(Bug#29186)

MySQL Cluster NDB 2.1.18、6.3.24、および 7.0.4 からは、INITIAL_SIZE に許可される最小値は 1M です。(Bug#29574)

注意

WAIT は解析されますが、それ以外では無視されます。そのため、MySQL 5.1 および MySQL Cluster NDB 6.x には影響しません。これは将来の拡張のために用意されています。

ENGINE パラメータ (必須) によって、このログファイルグループで使用されるストレージエンジンが決定され、ストレージエンジンの名前が engine_name になります。 MySQL 5.1 および MySQL Cluster NDB 6.x では、engine_name に指定できる値は 「NDBCLUSTER」 と 「NDB」 だけです。この 2 つの値は同等です。

ここに、ログファイルグループ lg_3 がすでに CREATE LOGFILE GROUP を利用して作成されていると仮定した例があります (項8.1.14. 「CREATE LOGFILE GROUP 構文」 を参照してください)。 

ALTER LOGFILE GROUP lg_3
    ADD UNDOFILE 'undo_10.dat'
    INITIAL_SIZE=32M
    ENGINE=NDBCLUSTER;

ALTER LOGFILE GROUP が ENGINE = NDBCLUSTER (または、ENGINE = NDB) とともに使用されると、各 MySQL Cluster データノード上に UNDO ログファイルが作成されます。INFORMATION_SCHEMA.FILES テーブルに問い合わせすることによって UNDO ファイルが作成され、それらの情報を得たことを検証することができます。例 : 

mysql> SELECT FILE_NAME, LOGFILE_GROUP_NUMBER, EXTRA
    -> FROM INFORMATION_SCHEMA.FILES
    -> WHERE LOGFILE_GROUP_NAME = 'lg_3';
+-------------+----------------------+----------------+
| FILE_NAME   | LOGFILE_GROUP_NUMBER | EXTRA          |
+-------------+----------------------+----------------+
| newdata.dat |                    0 | CLUSTER_NODE=3 |
| newdata.dat |                    0 | CLUSTER_NODE=4 |
| undo_10.dat |                   11 | CLUSTER_NODE=3 |
| undo_10.dat |                   11 | CLUSTER_NODE=4 |
+-------------+----------------------+----------------+
4 rows in set (0.01 sec)

詳しくは The INFORMATION_SCHEMA FILES Table を参照してください。

ALTER LOGFILE GROUP は、MySQL 5.1.6 で追加されました。MySQL 5.1 および MySQL Cluster NDB 6.x では、MySQL Cluster のディスクデータストレージで使用する場合のみ有効です。詳細は MySQL Cluster Disk Data Tables をご覧ください。