ApsaraDB RDS:ネイティブレプリケーションインスタンスの使用

前提条件

新しいネイティブレプリケーションインスタンスを作成、または既存のインスタンスをスペックアップするには、インスタンスが次の要件を満たす必要があります。インスタンスの詳細は、基本情報 ページで確認できます。

• データベースバージョン： MySQL 5.7 (マイナーバージョン 20240930 以降) または MySQL 8.0 (マイナーバージョン 20250531 以降)

• プロダクトシリーズ： Basic Edition

• 課金方法：サブスクリプション、従量課金

  説明

  Serverless ネイティブレプリケーションインスタンスを使用するには、まず従量課金インスタンスを作成してネイティブレプリケーションを有効にした後、課金方法を Serverless に変更する必要があります。

• サポート対象リージョン: 中国 (上海)、中国 (北京)、中国 (深圳)、中国 (広州)、中国 (成都)

  重要

  ApsaraDB RDS のネイティブレプリケーションは、現在上記のリージョンでのみ利用可能です。他のリージョンでのサポートは、将来的に追加される予定です。他のリージョンでこの機能が必要な場合は、チケットを送信してください。

課金

• 新しいインスタンスの購入時にネイティブレプリケーションを有効にした場合、新しいインスタンスには標準料金が課金されます。既存のインスタンスをネイティブレプリケーションインスタンスにアップグレードしても、追加料金は発生しません。

• ApsaraDB RDS for MySQL インスタンスへのフルデータインポート中に、自己管理データベースのバックアップを Object Storage Service (OSS) にアップロードしてから RDS にダウンロードする場合、バックアップが OSS に保存されている間、OSS ストレージ料金が発生します。

ネイティブ レプリケーションの権限

ApsaraDB RDS for MySQL ネイティブレプリケーションインスタンスの特権アカウントは、標準の ApsaraDB RDS for MySQL インスタンスでは利用できない権限を持っています。

インスタンス移行や仕様変更などのメンテナンス操作中、ネイティブレプリケーションコマンドの実行権限とパラメーター変更権限は一時的に取り消されます。これはインスタンスのレプリケーションプロセスには影響しません。メンテナンス作業が完了すると、システムは権限を復元します。

注意事項

ApsaraDB RDS for MySQL ネイティブレプリケーションインスタンスには、以下の制限事項があります。

ネイティブレプリケーションインスタンスへのアップグレード

ステップ 2：データレプリケーションの設定

1. 自己管理データベースに Percona XtraBackup をインストールし、バックアップを実行する

   1. Percona XtraBackup のインストール:

      CentOS へのインストール

      • MySQL 5.7

        wget https://downloads.percona.com/downloads/Percona-XtraBackup-2.4/Percona-XtraBackup-2.4.29/binary/redhat/8/x86_64/percona-xtrabackup-24-2.4.29-1.el8.x86_64.rpm
        yum localinstall percona-xtrabackup-24-2.4.29-1.el8.x86_64.rpm

      • MySQL 8.0

        wget https://downloads.percona.com/downloads/Percona-XtraBackup-8.0/Percona-XtraBackup-8.0.35-31/binary/redhat/8/x86_64/percona-xtrabackup-80-8.0.35-31.1.el8.x86_64.rpm
        yum localinstall percona-xtrabackup-80-8.0.35-31.1.el8.x86_64.rpm

      Ubuntu へのインストール

      1. Percona XtraBackup をインストールします。

         • MySQL 5.7

           # 1. Percona リポジトリパッケージをダウンロードします。
           wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
           
           # 2. リポジトリパッケージをインストールします。
           sudo dpkg -i percona-release_latest.generic_all.deb
           
           # 3. パッケージリストを更新します。
           sudo apt-get update
           
           # 4. Percona XtraBackup をインストールします。
           sudo apt-get install -y percona-xtrabackup-24

         • MySQL 8.0

           # 1. Percona リポジトリパッケージをダウンロードします (前のステップで実行していない場合)。
           wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
           
           # 2. リポジトリパッケージをインストールします。
           sudo dpkg -i percona-release_latest.generic_all.deb
           
           # 3. パッケージリストを更新します。
           sudo apt-get update
           
           # 4. Percona XtraBackup をインストールします。
           sudo apt-get install -y percona-xtrabackup-80

      2. qpress をインストールします。Ubuntu 用の Percona XtraBackup には qpress が含まれていないため、別途インストールする必要があります。

         sudo apt-get install -y qpress

   2. バックアップを作成します。

      以下の 3 つの圧縮方法は xtrabackup コマンドに基づいており、主に InnoDB ストレージエンジンを使用するインスタンスに適しています。データベースに MyISAM テーブルが含まれている場合は、innobackupex コマンドを使用してください。

      デフォルトの qpress 圧縮

      xtrabackup --backup \
        --host=127.0.0.1 \
        --port=3306 \
        --user=<your_user> \
        --password=<your_password> \
        --stream=xbstream \
        --compress > ./<your_backup.xb>

      QuickLZ 圧縮

      この方法には Percona XtraBackup 8.0.34-29 以前が必要です。詳細については、Percona XtraBackup の公式ドキュメントをご参照ください。

      xtrabackup --backup \
        --host=127.0.0.1 \
        --port=3306 \
        --user=<your_user> \
        --password=<your_password> \
        --stream=xbstream \
        --compress > ./<your_backup_qp.xb>

      外部 ZSTD 圧縮

      xtrabackup --backup \
        --host=127.0.0.1 \
        --port=3306 \
        --user=<your_user> \
        --password=<your_password> \
        --stream=xbstream \
        | zstd -q - > ./<your_backup.xb.zstd>

2. 完全なデータをインポートし、データレプリケーションを自動的に設定する

   説明

   データをインポートする前に、ネットワーク接続が自己管理 MySQL データベースと ApsaraDB RDS for MySQL インスタンスの間に存在することを確認してください。

   OSS からのダウンロード

   1. 自己管理データベースのバックアップを OSS にアップロードする

      ossutil ツールや OSS SDK など、さまざまなツールを使用してバックアップファイルをアップロードできます。このトピックでは ossutil を例として使用します。

      重要

      送信先の OSS バケットと ApsaraDB RDS for MySQL インスタンスが同じリージョンにあることを確認してください。そうでない場合、RDS は OSS からバックアップファイルを取得できません。

      1. ossutil をインストールします。

         yum install -y unzip
         sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
         ossutil config

      2. バックアップデータを OSS にアップロードします。

         ossutil -e <your_oss_endpoint> -i <your_accesskey_id> -k <your_accesskey_secret> cp <your_backup_file> oss://<your_bucket_name>/

   2. バックアップファイルを OSS から RDS にインポートし、レプリケーションリンクを自動的に設定する

      1. [RDS インスタンス] リストに移動してリージョンを選択し、宛先インスタンスの ID をクリックします。

      2. 左側のナビゲーションバーで、ネイティブレプリケーション をクリックします。

      3. ネイティブレプリケーションページで、全データのインポート をクリックし、次のパラメーターを設定して、決定 をクリックします。

         カテゴリ	パラメーター	説明
         バックアップインポート設定 (必須)	MySQLバージョン	システムは 5.7 または 8.0 を自動的に表示します。構成は不要です。
         	メソッド	OSS からインポート を選択します。
         	OSS バケット	自己管理データベースのバックアップファイルが保存されている OSS バケットを選択してください。OSS バケットの詳細については、「ファイルのアップロード」をご参照ください。
         	OSS オブジェクト名	OSS バケットから自己管理データベースのバックアップファイルを選択します。バックアップファイルが OSS バケットのサブディレクトリにある場合は、完全なパス名を手動で入力して検索する必要があります。以下の 3 つのバックアップファイル形式がサポートされています。 Percona XtraBackup によって生成された xbstream ファイル。 Percona XtraBackup の組み込み QuickLZ 圧縮を使用して生成された _qp.xb ファイル。 zstd を使用して圧縮された xbstream ファイルで、.xb.zst ファイル拡張子を持つもの。
         自動レプリケーション設定を有効にすることをお勧めします。システムが以下の構成に基づいてデータレプリケーションリンクを自動的にセットアップします。自動レプリケーション設定を有効にしない場合、完全データをインポートした後、レプリケーションリンクを手動でセットアップする必要があります。
         自動レプリケーション設定 (任意)	レプリケーション自動構築	このスイッチをオンにすると、自己管理 MySQL データベースから ApsaraDB RDS for MySQL インスタンスへのレプリケーション関係が自動的に確立されます。
         	ソース IP	ソースの自己管理データベースの IP アドレスを入力します。
         	ソースポート	ソースの自己管理データベースのポート番号を入力します。
         	ソースアカウント	ソースの自己管理データベースのユーザー名を入力します。ユーザーは REPLICATION CLIENT および REPLICATION SLAVE 権限を持っている必要があります。
         	ソースアカウントのパスワード	ソースユーザーアカウントのパスワードを入力します。

   バックアップの直接ストリーミング

   1. 自己管理データベースに backup-helper ツールをインストールし、バックアップ転送プロセスを開始する

      # backup-helper ツールをインストールします。
      wget -O backup-helper https://mysql-backup-helper.oss-cn-beijing.aliyuncs.com/v1.0.0-alpha/backup-helper && chmod +x backup-helper
      # バックアップ転送プロセスを開始します。
      # MySQL が実行中で、対応するバージョンの Percona XtraBackup がインストールされていることを確認してください。
      ./backup-helper --backup --mode=stream --host=<mysql_ip> --port=<mysql_port> --user=<mysql_user> --password=<mysql_password>

   2. データを RDS にインポートする

      1. ApsaraDB RDS コンソールにログインし、リージョンを選択して、宛先インスタンスの ID をクリックします。

      2. 左側のナビゲーションバーで、ネイティブレプリケーション をクリックします。

      3. ネイティブレプリケーションページで、全データのインポート をクリックし、次のパラメーターを設定して、決定 をクリックします。

         カテゴリ	パラメーター	説明
         バックアップインポート設定 (必須)	MySQLバージョン	システムは自動的に 5.7 または 8.0 を表示します。構成は不要です。
         	メソッド	ストリームバックアップからインポート を選択します。
         	バックアップソース IP	バックアップ転送に使用する IP アドレスを入力します。
         	バックアップソースポート	バックアップ転送に使用するポートを入力します。デフォルトのポートは 9999 です。
         自動レプリケーション設定を有効にすることを推奨します。システムは、以下の構成に基づいてデータレプリケーションリンクを自動的に設定します。自動レプリケーション設定を有効にしない場合は、完全データをインポートした後にレプリケーションリンクを手動で設定する必要があります。
         自動レプリケーション設定 (任意)	レプリケーション自動構築	このスイッチをオンにすると、自己管理 MySQL データベースから ApsaraDB RDS for MySQL インスタンスへのレプリケーション関係が自動的に確立されます。
         	ソース IP	ソースの自己管理データベースの IP アドレスを入力します。
         	ソースポート	ソースの自己管理データベースのポート番号を入力します。
         	ソースアカウント	ソースの自己管理データベースのユーザー名を入力します。ユーザーは REPLICATION CLIENT および REPLICATION SLAVE 権限を持っている必要があります。
         	ソースアカウントのパスワード	ソースユーザーアカウントのパスワードを入力します。

   完全データをインポートした際にレプリケーション自動構築を選択しなかった場合、または自動レプリケーションリンクで問題が発生して回復できない場合は、次のステップを参照して、自己管理 MySQL データベースから ApsaraDB RDS for MySQL インスタンスへのデータレプリケーションリンクを手動で確立できます。

   データレプリケーションの手動設定

   1. RDS インスタンスの特権アカウントを作成します。

   2. 自己管理データベースでレプリケーションアカウントを作成し、権限を付与します。

      -- レプリケーションアカウント 'replica' を作成します。本番環境では、'%' の代わりに特定の IP アドレスからのアクセスに制限することを推奨します。
      -- 'Test123!' を強力なパスワードに置き換えてください。
      CREATE USER 'replica'@'%' IDENTIFIED BY 'Test123!';
      
      -- 必要なレプリケーション権限を付与します。
      GRANT REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'replica'@'%';
      
      -- 権限の変更を適用します。
      FLUSH PRIVILEGES;

   3. 特権アカウントを使用して RDS インスタンスにログインし、手動でレプリケーションリンクを設定します。

      -- レプリケーションを設定します。
      CHANGE MASTER TO MASTER_HOST='<source_ip>', MASTER_PORT=<source_port>, MASTER_USER='<replication_user>', MASTER_PASSWORD='<replication_password>', MASTER_AUTO_POSITION=1;
      
      -- レプリケーションを開始します。
      START SLAVE;
      
      -- レプリケーションステータスを確認します。
      SHOW SLAVE STATUS;

3. レプリケーションステータスの確認

   RDS インスタンス詳細のネイティブレプリケーション ページに戻り、データレプリケーションリンク情報を表示します。 レプリケーションステータスが [実行中] の場合、データレプリケーションリンクが正常に確立されたことを示します。

ネイティブレプリケーションの無効化

1. [RDS インスタンス] リストに移動してリージョンを選択し、次にターゲットインスタンスの ID をクリックします。インスタンスはネイティブレプリケーションインスタンスである必要があります。

2. 左側のナビゲーションバーで、ネイティブレプリケーション をクリックし、次に ネイティブレプリケーションの無効化 をクリックします。

3. 決定 をクリックします。

   重要

   [はい] をクリックすると、自己管理 MySQL データベースと ApsaraDB RDS for MySQL ネイティブレプリケーションインスタンス間のレプリケーション関係が終了します。その後、インスタンスは標準の ApsaraDB RDS for MySQL インスタンスに戻り、読み取り専用モードから読み書きモードに切り替わり、書き込み操作を実行できるようになります。

関連コンテンツと API

• ApsaraDB RDS for MySQL ネイティブレプリケーションインスタンスを作成するには、CreateDBInstance API オペレーションを呼び出すことができます。次の点にご注意ください。

  • インスタンスの基本構成は、前提条件を満たす必要があります。その他のパラメーターは、必要に応じて設定できます。

  • ExternalReplication パラメーターを ON に設定します。

• 既存のインスタンスにネイティブレプリケーションリンクを設定するには、ImportUserBackupFile API オペレーションを呼び出すことができます。

付録：ネットワーク構成

ネットワーク接続の問題の詳細については、「接続とネットワーキング」をご参照ください。