

# RMAN プロシージャの共通パラメータ
<a name="Appendix.Oracle.CommonDBATasks.CommonParameters"></a>

RMAN のタスクを実行するには、Amazon RDS パッケージ `rdsadmin.rdsadmin_rman_util` を使用できます。いくつかのパラメータは、パッケージ内のすべてのプロシージャに共通です。パッケージ内の共通パラメータは以下のとおりです。


****  

| パラメータ名 | データ型 | 有効な値 | デフォルト | 必須 | 説明 | 
| --- | --- | --- | --- | --- | --- | 
| `p_directory_name` | varchar2 | データベースの有効なディレクトリ名。 | — | はい | バックアップファイルを含めるディレクトリの名前。 | 
| `p_label` | varchar2 | `a-z`, `A-Z`, `0-9`, `'_'`, `'-'`, `'.'` | — | いいえ | バックアップファイル名に含まれている一意の文字列。 上限は 30 文字です。  | 
| `p_owner` | varchar2 | `p_directory_name` に指定されたディレクトリの有効な所有者。 | — | はい | バックアップファイルを含めるディレクトリの所有者。 | 
| `p_tag` | varchar2 | `a-z`, `A-Z`, `0-9`, `'_'`, `'-'`, `'.'` | NULL | いいえ | 日次、週次、増分レベルのバックアップなど、バックアップの目的または使用方法を示すためにバックアップを区別できるようにする目的で使用する文字列。<br />上限は 30 文字です。タグでは、大文字と小文字は区別されません。タグは、入力する際に使用されるのが大文字か小文字かに関係なく、常に大文字で格納されます。<br />タグは一意である必要はないので、複数のバックアップに同じタグを付けることができます。<br />タグを指定しない場合、RMAN は、`TAG{{YYYYMMDDTHHMMSS}}` の形式を使用してデフォルトのタグを自動的に割り当てます。ここで {{YYYY}} は年、{{MM}} は月、{{DD}} は日、{{HH}} は時間 (24 時間形式)、{{MM}} は分、{{SS}} は秒です。日付と時刻は、RMAN がバックアップを開始した日時を示します。<br />例えば、2019-09-27 の 21:45:17 に開始されたバックアップに対して、バックアップに `TAG20190927T214517` というタグが付けられることがあります。<br />`p_tag` パラメータは、以下の Amazon RDS for Oracle DB エンジンバージョンでサポートされています。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/Appendix.Oracle.CommonDBATasks.CommonParameters.html) | 
| `p_compress` | boolean | `TRUE`, `FALSE` | `FALSE` | いいえ | BASIC バックアップ圧縮を行うには `TRUE` を指定します。<br />BASIC バックアップ圧縮を無効にするには `FALSE` を指定します。 | 
| `p_include_archive_logs` | boolean | `TRUE`, `FALSE` | `FALSE` | いいえ | アーカイブ REDO ログをバックアップに含めるには、`TRUE` を指定します。<br />アーカイブ REDO ログをバックアップから除外するには、`FALSE` を指定します。<br />アーカイブ REDO ログをバックアップに含める場合は、`rdsadmin.rdsadmin_util.set_configuration` プロシージャを使用して保持期間を 1 時間以上に設定します。また、バックアップを実行する直前に `rdsadmin.rdsadmin_rman_util.crosscheck_archivelog` プロシージャを呼び出します。そうしないと、アーカイブ REDO ログファイルが Amazon RDS 管理プロシージャで削除されて見つからないため、バックアップは失敗する場合があります。 | 
| `p_include_controlfile` | boolean | `TRUE`, `FALSE` | `FALSE` | いいえ | 制御ファイルをバックアップに含めるには、`TRUE` を指定します。<br />制御ファイルをバックアップから除外するには、`FALSE` を指定します。 | 
| `p_optimize` | boolean | `TRUE`, `FALSE` | `TRUE` | いいえ | バックアップの最適化を有効にするには、`TRUE` を指定します。アーカイブ REDO ログを含める場合は、バックアップサイズが縮小されます。<br />バックアップの最適化を無効にするには、`FALSE` を指定します。 | 
| `p_parallel` | number | Oracle Database Enterprise Edition (EE) の場合は `1`〜`254` の有効な整数<br />`1`その他の Oracle データベースエディションの場合は  | `1` | いいえ | チャネルの数。 | 
| `p_rman_to_dbms_output` | boolean | `TRUE`, `FALSE` | `FALSE` | いいえ | `TRUE` の場合、RMAN 出力は `DBMS_OUTPUT` ディレクトリのファイルに加えて、`BDUMP` パッケージに送信されます。SQL\*Plus で、`SET SERVEROUTPUT ON` を使用して出力を確認します。<br />`FALSE` の場合、RMAN 出力は `BDUMP` ディレクトリのファイルにのみ送信されます。 | 
| `p_section_size_mb` | number | 有効な整数 | `NULL` | いいえ | セクションサイズのメガバイト (MB)。<br />各ファイルを指定されたセクションサイズに分割し、パラレルして検証します。<br />`NULL` の場合、パラメータは無視されます。 | 
| `p_validation_type` | varchar2 | `'PHYSICAL'`, `'PHYSICAL+LOGICAL'` | `'PHYSICAL'` | いいえ | 破損の検出のレベル。<br />物理的な破損を確認するには、`'PHYSICAL'` を指定します。物理的な破損の一例は、ヘッダーおよびフッターの不一致によるブロックです。<br />物理的な破損に加えて論理的な不整合を確認するには、`'PHYSICAL+LOGICAL'` を指定します。論理的な破損の一例は破損ブロックです。 | 