このトピックでは、SQL文を使用して、PolarDB-Xのバイナリログを開始、一時停止、リセット、およびローリング更新する方法について説明します。
使用上の注意
このトピックで説明するSQL文を使用するには、SUPERまたはREPLICATION CLIENT権限を取得する必要があります。 詳細については、「アカウントと権限の管理」をご参照ください。
このトピックで説明するSQL文は、PolarDB-X 5.4.17以降のインスタンスでサポートされています。
WITH句が含まれていない場合、操作はバイナリログに対してシングルストリームモードで実行されます。
WITH句が含まれている場合、操作は指定されたバイナリログに対してマルチストリームモードで実行されます。
WITH句のストリームグループ名は、マルチストリームグループを作成するときに指定するストリームグループ名です。
START MASTER
説明
バイナリログ機能は自動的に有効になります。 STOP MASTERステートメントを実行しない場合は、START MASTERステートメントを実行する必要はありません。
START MASTERステートメントを実行すると、バイナリログが生成されます。
構文
START MASTER [WITH stream_group_name]
例
次のステートメントを実行して、単一ストリームのバイナリログ機能を有効にします。
START MASTER;
次のステートメントを実行して、group1という名前のストリームグループのマルチストリームバイナリログ機能を有効にします。
group1でマスターを開始します。
STOP MASTER
説明
バイナリログ機能を無効にすると、バイナリログは生成されなくなります。
バイナリログ機能を長時間無効にしないでください。 それ以外の場合、データノード (DN) に対応する物理バイナリログはクリアされ、バイナリログ機能を再有効化した後に復元することはできません。 DNに対応するバイナリログの保存期間の設定方法については、「ローカルログバックアップ」をご参照ください。
構文
STOP MASTER [stream_group_name]
例
次のステートメントを実行して、単一ストリームのバイナリログ機能を無効にします。
STOP MASTER;
次のステートメントを実行して、group1という名前のストリームグループのマルチストリームバイナリログ機能を無効にします。
group1でマスターを停止します。
リセットマスター
説明
RESET MASTERステートメントを実行する前に、STOP MASTERステートメントを実行してバイナリログ機能を無効にする必要があります。
RESET MASTERステートメントを実行すると、既存のバイナリログファイルが削除されます。
RESET MASTERステートメントを実行すると、現在の時点に基づいてバイナリログファイルが再生成されます。 ファイルは000001から番号が付けられています。
RESET MASTERステートメントを実行した後、START MASTERステートメントを実行してバイナリログ機能を再起動する必要があります。
構文
リセットマスター [stream_group_name]
例
次のステートメントを実行して、単一ストリームのバイナリログ機能をリセットします。
リセットマスター;
次のステートメントを実行して、group1という名前のストリームグループのマルチストリームバイナリログ機能をリセットします。
group1のリセットマスター;
フラッシュログ
説明
FLUSH LOGSステートメントを実行すると、最大数のバイナリログファイルへのログの書き込みが停止し、ログ書き込み用の新しいファイルが生成されます。
この機能は、シングルストリームモードのバイナリログでのみサポートされます。
構文
フラッシュログ;
例
次のステートメントを実行して、バイナリログファイルのローリング更新を実行します。
フラッシュログ;
ローリング更新を実行する前に、最大数のログファイルはbinlog.000004です。
はバイナリログを表示します。+ -------------- ------------- | LOG_NAME | FILE_SIZE | + -------------- ------------- | binlog.000001 | 20968 | | binlog.000002 | 10489381 | | binlog.000003 | 10486003 | | binlog.000004 | 361752 | + -------------- -------------
ローリング更新を実行すると、最大数のログファイルがbinlog.000005に変更されます。
はバイナリログを表示します。+ -------------- ------------- | LOG_NAME | FILE_SIZE | + -------------- ------------- | binlog.000001 | 20968 | | binlog.000002 | 10489381 | | binlog.000003 | 10486003 | | binlog.000004 | 361752 | | binlog.000005 | 260 | + -------------- -------------