ApsaraDB RDS:RDS MySQL の物理バックアップを自己管理型データベースへ復元

• Q：データファイルをダウンロードする際にエラーが発生するのはなぜですか?

  A: wget -c 'https://****.bak.rds.aliyuncs.com/****_xb.qp?****' -O test_xb.qp コマンドを使用する場合、ダウンロードアドレスをシングルクォーテーション (') で囲むと、プログラムがアドレスを正しく識別し、エラーを防ぐのに役立ちます。

次の解凍コマンドを実行する際、test_xb.qp をお使いのバックアップファイル名に、/var/mysql_bkdata/ を作成した解凍パスに置き換えてください。

### MySQL 8.0
qpress -do  test_xb.qp | /u01/xtrabackup80/bin/xbstream -x -v -C /var/mysql_bkdata/

### MySQL 5.5/5.6/5.7
qpress -do  test_xb.qp | xbstream -x -v -C /var/mysql_bkdata/

次の解凍コマンドを実行する際、test_qp.xb をお使いのバックアップファイル名に、/var/mysql_bkdata/ を作成した解凍パスに置き換えてください。

## ステップ 1: ファイルを展開する
cat test_qp.xb | xbstream -x -v -C /var/mysql_bkdata/

## ステップ 2: ファイルを解凍する
### MySQL 5.5/5.6/5.7
innobackupex --decompress --remove-original /var/mysql_bkdata/

### MySQL 8.0
/u01/xtrabackup80/bin/xtrabackup --decompress --remove-original --target-dir=/var/mysql_bkdata/

次の解凍コマンドを実行する際、test.tar.gz をお使いのバックアップファイル名に、/var/mysql_bkdata/ を作成した解凍パスに置き換えてください。

tar -zxvf test.tar.gz -C /var/mysql_bkdata/

次の解凍コマンドを実行する際、test.xb.gz をお使いのバックアップファイル名に、/var/mysql_bkdata/ を作成した解凍パスに置き換えてください。

### MySQL 8.0
gzip -d -c test.xb.gz | /u01/xtrabackup80/bin/xbstream -x -v -C /var/mysql_bkdata/

### MySQL 5.5/5.6/5.7
gzip -d -c test.xb.gz | xbstream -x -v -C /var/mysql_bkdata/

• Q: ダウンロードしたバックアップファイルを解凍する際にエラーが発生した場合はどうすればよいですか？

  A: 次の項目を確認して、エラーのトラブルシューティングを行ってください。

  ダウンロードしたファイルが物理バックアップファイルであることを確認します。

  保存した圧縮ファイルの拡張子が正しいことを確認します (拡張子は URL に記載のものと一致している必要があります。例: xb.qp、.tar.gz、.xb.gz、または _qp.xb)。

  ファイル形式に適した解凍コマンドを使用します。

  一般的なエラー：

  • 解凍コマンドを実行すると、sh: qpress: command not found エラーが表示されます。

    解決策: 「前提条件」を参照して、qpress ツールがお使いのセルフマネージドデータベースサーバーにインストールされていることを確認してください。

  • 拡張子が _qp.xb の xbstream パッケージを解凍する際に、innobackupex not found エラーが発生します。

    解決策: 「前提条件」を参照して、Percona XtraBackup がお使いのセルフマネージドデータベースサーバーにインストールされていることを確認してください。

  • 拡張子が _qp.xb の xbstream パッケージファイルを cat コマンドで展開する際に、can't change to dir to xx( errorcode:no such file or directory) エラーが表示されます。

    解決策: このエラーは、ファイル名またはパスが正しくないことを示しています。コマンド内のファイル名とパスを確認してください。

• Q：xtrabackup: Unknown error 3613 というエラーが返されます。どうすれば解決できますか？

  A：Percona XtraBackup を最新バージョンに更新して、再試行してください。

• Q：Original data directory /var/mysql_newdata is not empty! というエラーが返されます。どうすればよいですか？

  A：sudo rm -rf /var/mysql_newdata/* コマンドでフォルダー内のファイルを削除し、復元操作を再試行してください。

• Q：InnodDB: Encryption information in datafile: ./xxx.ibd can't be decrypted, please check if a keyring plugin is loaded and initialized successfully. というエラーが返されます。どうすればよいですか？

  お使いのインスタンスで TDE が有効になっているかどうかを確認します：

  • TDE が有効になっている場合は、暗号化されたテーブルを確認してください。「前提条件」で説明されているように、「TDE (透過的データ暗号化) の設定」の手順に従って暗号化されたテーブルを復号し、このトピックの手順に従ってデータを復元してください。

  • TDE が有効になっていない場合は、「前提条件」で説明されているように、正しいバージョンの Percona XtraBackup がインストールされていることを確認してください。

• Q：ダウンロードしたバックアップファイルに TDE で暗号化されたデータが含まれているため、データ復元に失敗します。どうすれば解決できますか？

  A：ダウンロードした暗号化バックアップファイルからデータを復元することはできません。RDS インスタンス内の暗号化されたテーブルが原因で、復元エラーが発生します。「前提条件」で説明されているように、「TDE (透過的データ暗号化) の設定」の手順に従ってテーブルを復号し、新しいバックアップを作成してから、再度データを復元してください。

• Q：復元中に発生する innobackupex: File 'undo001' not found (Errcode: 2 - No Such file or directory) エラーを解決するにはどうすればよいですか？

  A：undo ファイルは、データベースのバージョンによって異なるシステムファイルです。セルフマネージドデータベースが ApsaraDB RDS for MySQL と同じバージョンであるかどうかを確認してください。

• Q：Ubuntu オペレーティングシステムで mysqld: [ERROR] Failed to open required defaults file: /etc/my.cnf というエラーが発生する原因と、その解決方法を教えてください。

  A：このエラーは、Ubuntu のセキュリティプログラム AppArmor が原因です。apt install -y apparmor-utils と aa-complain /usr/sbin/mysqld コマンドを使用して AppArmor の設定を変更します。

• Q：復元完了後、自己管理型データベースの起動に失敗したり、使用中に error 1105 Unknown error が発生した場合はどうすればよいですか？

  A：次の SQL 文を実行して、データベースのストレージエンジンを変更します。

  USE mysql;
  ALTER TABLE proc engine=myisam;
  ALTER TABLE event engine=myisam;
  ALTER TABLE func engine=myisam;

  説明

  ERROR 1067 (42000): Invalid default value for 'modified' というエラーが表示された場合は、まず SET SQL_MODE='ALLOW_INVALID_DATES'; 文を実行してください。

• Q：データベース復元後の root パスワードは何ですか？

  A：root パスワードの取得方法はバージョンによって異なります：

  • インスタンスが MySQL 5.7 または 8.0 を実行している場合、root パスワードは自己管理型データベースの root パスワードと同じです。

  • インスタンスが MySQL 5.5 または 5.6 を実行している場合、データベースを使用する前に root パスワードをリセットする必要があります。詳細については、「公式ドキュメント」をご参照ください。

• Q：起動時に InnodDB: Assertion failure in thread 140xxx in file page0zip.ic xxx というエラーが発生します。解決方法を教えてください。

  A：このエラーはディスク容量不足が原因である可能性があります。自己管理型データベースサーバーのディスクを拡張してから、再試行してください。

• Q：起動時に発生する [ERROR] Failed to open the relay log xxx、[ERROR] Slave: Failed to initialize the master info xxx、または [ERROR] Failed to create or recover replication info repositories. というエラーを解決するにはどうすればよいですか？

  A：これらのエラーは、RDS インスタンスが高可用性 (HA) 用に設定されているのに対し、ローカルの自己管理型データベースがプライマリノードとセカンダリノードを使用していないために発生します。これらのエラーは起動に影響しないため、無視しても問題ありません。

• Q：起動時に発生する [ERROR] Data Dictionary initialization failed エラーを解決するにはどうすればよいですか？

  A：このエラーは、互換性のないオペレーティングシステムが原因である可能性があります。ApsaraDB RDS の基盤となるオペレーティングシステムは Linux です。異なるオペレーティングシステムを使用するとバージョンの互換性の問題が発生する可能性があるため、Linux ベースのオペレーティングシステムを使用してデータベースを復元することを推奨します。

• Q：sudo systemctl start mysqld コマンドでローカルの MySQL サービスを起動できません。どうすればよいですか？

  A：これは、Linux で SELinux が Enforcing モードになっていることが原因である可能性があります。getenforce コマンドを実行して、SELinux の現在のステータスを確認できます。

  • これが開発環境またはテスト環境である場合は、SELinux モードを Permissive モードに変更することを推奨します。その後、sudo systemctl start mysqld を使用して MySQL の起動を試してください。

  • 本番環境の場合は、SELinux のログを確認して起動失敗の具体的な原因を特定し、その情報に基づいて SELinux ポリシーを修正することを推奨します。

• Q： 復元後、データ内の時刻がローカル時刻と一致しないのはなぜですか？また、どのように修正すればよいですか？

  A： 自己管理型データベースのタイムゾーンが RDS インスタンスと異なる場合は、自己管理型データベースの time_zone パラメーターを RDS インスタンスのものと一致するように変更する必要があります。RDS インスタンスの time_zone パラメーターが system に設定されている場合は、RDS インスタンスのリージョンを確認し、自己管理型データベースの time_zone パラメーターをそのリージョンのタイムゾーンに設定します。

• Q： 自己管理型データベースへの接続時に Access denied for user 'XXX' エラーが表示されます。どうすれば解決できますか？

  A： 元の ApsaraDB RDS for MySQL インスタンスの正しいアカウントとパスワードを使用していることを確認してください。

• Q： 自己管理型データベースへの接続時にパスワードを忘れました。どうすればよいですか？

  A： アカウントまたはパスワードを忘れた場合は、--skip-grant-tables パラメーターを指定して MySQL プロセスを起動します。これにより、起動時の権限チェックがバイパスされ、アカウントまたはパスワードなしでデータベースにログインできます。なお、--skip-grant-tables パラメーターの使用はセキュリティリスクとなります。ログイン後は直ちにアカウントとパスワードを変更してください。

• Q： 自己管理型データベースに接続した後、システムデータベースや、一部のデータベースしか表示されません。どうすればよいですか？

  A： データベースを再起動してから、元の RDS インスタンスの root アカウントまたは高権限アカウントを使用して接続し、データベースを確認してください。