指定ディレクトリへのバックアップ

日常の運用では、システムパラメータ data_backup_dest で指定されたデフォルトパスではなく、任意のストレージディレクトリにデータをバックアップする必要が生じることがあります。データバックアップの開始時に TO 構文でバックアップ先パスを指定すると、そのパスにバックアップデータが書き込まれます。この指定は一回限りの操作に適用され、システムパラメータを変更したり、後続の自動スケジュールによるバックアップに影響したりすることはありません。

前提条件

指定ディレクトリへのバックアップを開始する前に、以下を確認してください：

• アーカイブモードが有効になっており、ログアーカイブタスクの STATUS が DOING であること。

  ログアーカイブタスクの状態を確認する操作については、アーカイブ進捗状況の確認を参照してください。

  アーカイブモードを有効にする操作については、アーカイブモードの有効化を参照してください。

• バックアップ先パスが利用可能であること。バックアップ先では、NFS、Alibaba Cloud OSS、AWS S3、およびS3互換のオブジェクトストレージなどのストレージメディアを使用できます。dest_path の形式は、使用するバックアップメディアのパス規則に従う必要があります。各バックアップメディアの詳細な要件については、バックアップ前の準備を参照してください。

使用上の制限

• クラスタのバージョンはV4.4.2 BP3以降である必要があります。それより前のバージョンでは、システムはエラーコード ERROR 1235 (0A000) : %s not supported を返します。これは、クラスタのバージョンが最低要件を満たしていないことを示します。クラスタをアップグレードしてから、この機能を使用してください。

• アーカイブモードが無効であるか、ログアーカイブタスクの状態が DOING ではないときにバックアップを開始すると、システムはエラーコード ERROR 9040 (HY000) : backup can not start を返します。データバックアップはアーカイブログに依存するため、先にアーカイブモードを有効にし、ログアーカイブタスクが正常に実行されていることを確認してから、バックアップを開始してください。

• システムテナントが TO 構文でバックアップを開始する場合、指定できるテナントは1つだけです。複数のテナントに対して同時にバックアップを開始することや、TENANT 句を省略することはできません。これらの制約に違反すると、システムはエラーコード ERROR 1235 (0A000) : %s not supported を返します。

  • システムテナントが BACKUP TENANT = t1, t2 TO 'dest_path' を実行して複数のテナントを指定すると、同じバックアップ先ルートパスが共有されるため、異なるテナントのバックアップセットが互いに上書きされます。
  • システムテナントが BACKUP DATABASE TO 'dest_path' を実行して TENANT 句を指定しない場合、対象テナントの情報がないため、どのテナントのバックアップを開始すべきか判断できません。

• ユーザーテナントは、自身のテナントに対してのみバックアップを実行できます。TENANT 句で他のテナントを指定することはできません。指定すると、システムはエラーコード ERROR 1235 (0A000) : %s not supported を返します。

• 指定するバックアップ先パスは、有効でアクセス可能である必要があります。そうでない場合、システムはエラーコード ERROR 9116 (HY000) : no I/O operation permission of the object storage を返します。

• 指定したバックアップ先パスに過去のバックアップがない場合（初回バックアップ）、増分バックアップは自動的にフルバックアップに切り替わります。

• TO 構文でバックアップを開始しても、システムパラメータ data_backup_dest の値は変更されません。その後、TO 構文を使用せずにバックアップを開始すると、引き続きシステムパラメータで設定されたデフォルトパスが使用されるか、エラーが返されます。

指定ディレクトリへのバックアップの開始

上記の前提条件を満たしたら、以下の手順で指定ディレクトリへのバックアップを開始できます。

システムテナントによる指定ディレクトリへのバックアップの開始

sys テナントは、クラスタ内の指定したテナントのフルバックアップまたは増分バックアップを開始し、指定ディレクトリにデータをバックアップできます。

1. root ユーザーでクラスタの sys テナントにログインします。

2. （オプション）テナントのバックアップの並列度を設定します。

   バックアップの並列度は、テナントレベルの構成パラメータ ha_low_thread_score で制御します。この構成パラメータは、バックアップやバックアップクリーンアップなどの中・低優先度のタスクキューで使用するスレッド数を指定します。値の範囲は [0, 100]、デフォルト値は 0 です。バックアップの開始前に、構成パラメータ ha_low_thread_score の値を適切に引き上げることができます。変更する際は、毎回値を2倍にすることを推奨します。構成パラメータ ha_low_thread_score を確認する操作については、データバックアップ関連パラメータの確認を参照してください。

   構成パラメータ ha_low_thread_score の詳細については、ha_low_thread_scoreを参照してください。

   • クラスタ内のすべてのテナントのバックアップ並列度を設定する

     obclient [(none)]> ALTER SYSTEM SET ha_low_thread_score = 10 TENANT = all_user;
     

     または

     obclient [(none)]> ALTER SYSTEM SET ha_low_thread_score = 10 TENANT = all;
     

     説明

     OceanBaseデータベースV4.2.1以降では、TENANT = all_user と TENANT = all は同じ意味を持ちます。すべてのユーザーテナントに適用する場合は、TENANT = all_user の使用を推奨します。TENANT = all は今後廃止され、使用できなくなります。

   • クラスタ内の指定したテナントのバックアップ並列度を設定する

     obclient [(none)]> ALTER SYSTEM SET ha_low_thread_score = 10 TENANT = mysql_tenant;
     

3. 以下のステートメントを実行し、指定ディレクトリへのバックアップを開始します。

   システムテナントでは、以下の方法で指定パスへのフルバックアップと増分バックアップを実行できます：

   • フルバックアップ

     ALTER SYSTEM BACKUP TENANT = <tenant_name> TO 'dest_path' [PLUS ARCHIVELOG];
     

   • 増分バックアップ

     ALTER SYSTEM BACKUP INCREMENTAL TENANT = <tenant_name> TO 'dest_path' [PLUS ARCHIVELOG];
     

   ここで、tenant_name はバックアップ対象のテナント名、dest_path はバックアップ先パスです。PLUS ARCHIVELOG はオプションです。PLUS ARCHIVELOG を追加すると、データバックアップと同時にアーカイブログも指定ディレクトリにバックアップできます。最終的に、バックアップディレクトリにアーカイブログを含む完全なデータセットが生成されます。このデータセットはリストアに使用できるため、アーカイブログに依存せずに、テナントのデータを MIN_RESTORE_SCN の位置までリストアできます。

   説明

   システムテナントが `TO` 構文で指定できるテナントは1つだけです。複数のテナントに対して同時にバックアップを開始することや、`TENANT` 句を省略することはできません。

   例：

   • テナント mysql_tenant のフルバックアップを指定ディレクトリに作成します。

     obclient [(none)]> ALTER SYSTEM BACKUP TENANT = mysql_tenant TO 'file:///data/backup/sys_one_time_dest';
     

     コマンドが正常に実行されると、システムはテナント mysql_tenant の全データを指定ディレクトリ /data/backup/sys_one_time_dest にバックアップします。

   • テナント mysql_tenant の増分バックアップを指定ディレクトリに作成します。

     obclient [(none)]> ALTER SYSTEM BACKUP INCREMENTAL TENANT = mysql_tenant TO 'file:///data/backup/sys_one_time_dest';
     

     コマンドが正常に実行されると、システムはテナント mysql_tenant の増分データを指定ディレクトリ /data/backup/sys_one_time_dest にバックアップします。

   • テナント mysql_tenant のフルバックアップを開始し、アーカイブログも指定ディレクトリにバックアップします。

     obclient [(none)]> ALTER SYSTEM BACKUP TENANT = mysql_tenant TO 'file:///data/backup/self_contained_dest' PLUS ARCHIVELOG;
     

     コマンドが正常に実行されると、システムは指定ディレクトリ /data/backup/self_contained_dest に、アーカイブログを含む完全なデータセットを生成します。

   • テナント mysql_tenant の増分バックアップを開始し、アーカイブログも指定ディレクトリにバックアップします。

     obclient [(none)]> ALTER SYSTEM BACKUP INCREMENTAL TENANT = mysql_tenant TO 'file:///data/backup/self_contained_dest' PLUS ARCHIVELOG;
     

     コマンドが正常に実行されると、システムはテナント mysql_tenant の増分データを指定ディレクトリ /data/backup/self_contained_dest にバックアップし、アーカイブログも同じディレクトリにバックアップします。

   バックアップ中は、進捗状況をリアルタイムで確認できます。具体的な操作については、データバックアップの進捗状況の確認を参照してください。

ユーザーテナントによる指定ディレクトリへのバックアップの開始

ユーザーテナントは、自身のテナントのフルバックアップまたは増分バックアップを開始し、指定ディレクトリにデータをバックアップできます。他のテナントには影響しません。

1. テナント管理者がデータベースにログインします。

   この例では、root ユーザーで mysql_tenant テナントにログインするか、SYS ユーザーで oracle_tenant テナントにログインできます。

2. （オプション）自身のテナントのバックアップ並列度を設定します。

   バックアップの並列度は、テナントレベルの構成パラメータ ha_low_thread_score で制御します。この構成パラメータは、バックアップやバックアップクリーンアップなどの中・低優先度のタスクキューで使用するスレッド数を指定します。値の範囲は [0, 100]、デフォルト値は 0 です。バックアップの開始前に、構成パラメータ ha_low_thread_score の値を適切に引き上げることができます。変更する際は、毎回値を2倍にすることを推奨します。構成パラメータ ha_low_thread_score を確認する操作については、データバックアップ関連パラメータの確認を参照してください。

   構成パラメータ ha_low_thread_score の詳細については、ha_low_thread_scoreを参照してください。

   obclient [(none)]> ALTER SYSTEM SET ha_low_thread_score = 10;
   

3. 以下のステートメントを実行し、指定ディレクトリへのバックアップを開始します。

   ユーザーテナントでは、以下の方法で指定パスへのフルバックアップと増分バックアップを実行できます：

   • フルバックアップ

     ALTER SYSTEM BACKUP DATABASE TO 'dest_path' [PLUS ARCHIVELOG];
     

   • 増分バックアップ

     ALTER SYSTEM BACKUP INCREMENTAL DATABASE TO 'dest_path' [PLUS ARCHIVELOG];
     

   ここで、dest_path はバックアップ先パスです。PLUS ARCHIVELOG はオプションです。PLUS ARCHIVELOG を追加すると、データバックアップと同時にアーカイブログも指定ディレクトリにバックアップできます。最終的に、バックアップディレクトリにアーカイブログを含む完全なデータセットが生成されます。このデータセットはリストアに使用できるため、アーカイブログに依存せずに、テナントのデータを MIN_RESTORE_SCN の位置までリストアできます。

   例：

   • 自身のテナントのフルバックアップを指定ディレクトリに作成します。

     obclient [(none)]> ALTER SYSTEM BACKUP DATABASE TO 'file:///data/backup/one_time_dest';
     

     コマンドが正常に実行されると、システムは自身のテナントの全データを指定ディレクトリ /data/backup/one_time_dest にバックアップします。

   • 自身のテナントの増分バックアップを指定ディレクトリに作成します。

     obclient [(none)]> ALTER SYSTEM BACKUP INCREMENTAL DATABASE TO 'file:///data/backup/one_time_dest';
     

     コマンドが正常に実行されると、システムは自身のテナントの増分データを指定ディレクトリ /data/backup/one_time_dest にバックアップします。

   • 自身のテナントのフルバックアップを開始し、アーカイブログも指定ディレクトリにバックアップします。

     obclient [(none)]> ALTER SYSTEM BACKUP DATABASE TO 'file:///data/backup/self_contained_dest' PLUS ARCHIVELOG;
     

     コマンドが正常に実行されると、システムは指定ディレクトリ /data/backup/self_contained_dest に、アーカイブログを含む完全なデータセットを生成します。

   • 自身のテナントの増分バックアップを開始し、アーカイブログも指定ディレクトリにバックアップします。

     obclient [(none)]> ALTER SYSTEM BACKUP INCREMENTAL DATABASE TO 'file:///data/backup/self_contained_dest' PLUS ARCHIVELOG;
     

     コマンドが正常に実行されると、システムは自身のテナントの増分データを指定ディレクトリ /data/backup/self_contained_dest にバックアップし、アーカイブログも同じディレクトリにバックアップします。

   バックアップ中は、進捗状況をリアルタイムで確認できます。具体的な操作については、データバックアップの進捗状況の確認を参照してください。

ユーザーテナントの動作

フルバックアップ（BACKUP DATABASE）を開始した場合の、設定の組み合わせごとの動作を以下の表に示します。

増分バックアップ（BACKUP INCREMENTAL DATABASE）を開始した場合の、状況ごとの動作を以下の表に示します。

関連ドキュメント

• フルデータバックアップの開始

• 増分データバックアップの開始

• データバックアップの進捗状況の確認

• データバックアップ履歴の確認

• BACKUP

• バックアップパスまたはアーカイブパスを手動で空にする