COPY_BACKUP

This procedure copies one or more backup pieces from the Recovery Appliance to a SBT destination. The Recovery Appliance copies all backup pieces matching the specified tag to the location specified with the format and template_name parameters.

Syntax

PROCEDURE copy_backup (
   tag IN VARCHAR2,
   format IN VARCHAR2,
   template_name IN VARCHAR2,
   compression_algorithm IN VARCHAR2 DEFAULT NULL,
   encryption_algorithm IN VARCHAR2 DEFAULT NULL,
   comments IN VARCHAR2 DEFAULT NULL);

Parameters

Table 21-7 COPY_BACKUP Parameters

Parameter	Description
`tag`	The tag of the backups to copy. The Recovery Appliance copies all backups matching this tag.
`format`	The naming format of the backup pieces to create. This parameter follows the same rules as the RMAN `FORMAT` parameter. If not specified, default format is `RA_SBT_%d_%I_<SBT_job_template_key>_%U_<bs_key>`.
`template_name`	The name of the SBT job library template. The Recovery Appliance copies the backup piece to tape (or cloud), using the media pool referenced in the SBT template name as the copy destination.
`compression_algorithm`	Specifies the compression algorithm. If `compression_algorithm` is specified, it will override the compression algorithm defined in `template_name` for this single operation. If `template_name` is NULL, it defines the compression algorithm for this operation. `BASIC`: Good compression ratios with potentially lower speed than `MEDIUM`. `LOW`: Optimized for speed with potentially lower compression raios than `BASIC`. `MEDIUM`: Recommended for most environments. Good combination of compression ratios and speed. `HIGH`: Best suited for operations over slower networks where the limiting factor is maximum network throughput. Provides the highest level of compression with the most negative impact on CPU performance. `OFF`: No compression. `NULL`: (default) indicates that the algorithm defined in the SBT job template should be used.
`encryption_algorithm`	Specifies the encryption algorithm If `encryption_algorithm` is specified, it will override the encryption algorithm defined in `template_name` for this single operation. If `template_name` is NULL, it defines the encryption algorithm for this operation. Valid values are 'AES128', 'AES192', 'AES256', 'OFF', 'CLIENT', or the constant equivalents ENC_OFF, ENC_AES128, ENC_AES192, ENC_AES256, ENC_CLIENT. Note: A value of `CLIENT` or `ENC_CLIENT` requires the client to generate encrypted backups. Failure to do so will result in cloud backup job failures on the Recovery Appliance.
`comments`	Optional user supplied comment describing reason for executing this command.