managed_backup.sp_backup_config_schedule (Transact-SQ)

適用対象: SQL Server 2016 (13.x) 以降のバージョン

Microsoft Azure への SQL Server マネージド バックアップの自動スケジュール オプションまたはカスタム スケジュール オプションを構成します。

Transact-SQL 構文表記規則

構文

EXEC managed_backup.sp_backup_config_schedule
    [ @database_name = ] 'database_name'
    , [ @scheduling_option = ] { 'Custom' | 'System' }
    , [ @full_backup_freq_type = ] { 'Daily' | 'Weekly' }
    , [ @days_of_week = ] 'days_of_the_week'
    , [ @backup_begin_time = ] 'begin time of the backup window'
    , [ @backup_duration = ] 'backup window length'
    , [ @log_backup_freq = ] 'frequency of log backup'
[ ; ]

引数

[ @database_name = ] 'database_name'

特定のデータベースでマネージド バックアップを有効にするためのデータベース名。

@database_nameが NULL に設定されている場合、設定はインスタンス レベルで適用されます (インスタンスに作成されたすべての新しいデータベースに適用されます)。

[ @scheduling_option = ] { 'Custom' |'System' }

システム制御バックアップ スケジュールの System を指定します。 他のパラメーターで定義されたカスタム スケジュールの Custom を指定します。

[ @full_backup_freq_type = ] { 'Daily' |'Weekly' }

マネージド バックアップ操作の頻度の種類。 Daily または Weeklyに設定できます。

[ @days_of_week = ] 'days_of_the_week'

@full_backup_freq_typeがWeeklyに設定されているバックアップの曜日。 Mondayなどの完全な文字列名を指定します。 パイプ記号 (|) で区切って、複数の日の名前を指定することもできます。 たとえば、N'Monday | Wednesday | Friday' のようにします。

[ @backup_begin_time = ] 'バックアップ ウィンドウの時刻'

バックアップ ウィンドウの開始時刻。 バックアップは時間枠外では開始されません。これは、 @backup_begin_time と @backup_durationの組み合わせによって定義されます。 形式: hh:mm。

[ @backup_duration = ] 'backup window length'

バックアップ時間枠の期間。 @backup_begin_timeと@backup_durationによって定義された時間枠内にバックアップが完了する保証はありません。 この時間枠で開始されたが、期間の期間を超えるバックアップ操作は取り消されません。 形式: hh:mm。

[ @log_backup_freq = ] 'ログ バックアップの頻度'

これにより、トランザクション ログ バックアップの頻度が決まります。 これらのバックアップは、データベース バックアップに指定されたスケジュールではなく、定期的に実行されます。 @log_backup_freq は分単位または時間単位で指定でき、 0:00 は有効であり、ログ バックアップがないことを示します。 ログ バックアップを無効にすることは、単純な復旧モデルを使用するデータベースにのみ適しています。 形式: hh:mm。

Note

復旧モデルが単純から完全に変更された場合は、0:00から 0 以外の値に@log_backup_freqを再構成する必要があります。

リターン コードの値

0 (成功) または 1 (失敗)。

アクセス許可

ALTER ANY CREDENTIAL 権限を持つ db_backupoperator データベース ロールのメンバーシップと、 sp_delete_backuphistory ストアド プロシージャに対する EXECUTE 権限が必要です。

例

次の例では、データベース Testのマネージド バックアップを構成し、午前 4 時から毎日の完全バックアップを実行します。最大バックアップ期間は 2 時間で、ログの頻度は 15 分です。

USE msdb;
GO

EXEC managed_backup.sp_backup_config_schedule @database_name = 'Test',
    @scheduling_option = 'Custom',
    @full_backup_freq_type = 'Daily',
    @backup_begin_time = '04:00',
    @backup_duration = '02:00',
    @log_backup_freq = '00:15';
GO

関連するコンテンツ

• managed_backup.sp_backup_config_basic (Transact-SQL)
• managed_backup.sp_backup_config_advanced (Transact-SQL)