sp_add_log_shipping_secondary_database (Transact-SQL)sp_add_log_shipping_secondary_database (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

ログ配布のセカンダリ データベースを設定します。Sets up a secondary databases for log shipping.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
sp_add_log_shipping_secondary_database  
[ @secondary_database = ] 'secondary_database',  
[ @primary_server = ] 'primary_server',   
[ @primary_database = ] 'primary_database',  
[, [ @restore_delay = ] 'restore_delay']  
[, [ @restore_all = ] 'restore_all']  
[, [ @restore_mode = ] 'restore_mode']  
[, [ @disconnect_users = ] 'disconnect_users']  
[, [ @block_size = ] 'block_size']  
[, [ @buffer_count = ] 'buffer_count']  
[, [ @max_transfer_size = ] 'max_transfer_size']  
[, [ @restore_threshold = ] 'restore_threshold']   
[, [ @threshold_alert = ] 'threshold_alert']   
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled']   
[, [ @history_retention_period = ] 'history_retention_period']  

引数Arguments

[ @secondary_database = ] 'secondary_database' セカンダリ データベースの名前です。[ @secondary_database = ] 'secondary_database' Is the name of the secondary database. secondary_databasesysname、既定値はありません。secondary_database is sysname, with no default.

[ @primary_server = ] 'primary_server' プライマリ インスタンスの名前、 MicrosoftMicrosoft SQL Server データベース エンジンSQL Server Database Engineログ配布構成にします。[ @primary_server = ] 'primary_server' The name of the primary instance of the MicrosoftMicrosoft SQL Server データベース エンジンSQL Server Database Engine in the log shipping configuration. primary_serversysname NULL にすることはできません。primary_server is sysname and cannot be NULL.

[ @primary_database = ] 'primary_database' プライマリ サーバー上のデータベースの名前です。[ @primary_database = ] 'primary_database' Is the name of the database on the primary server. primary_databasesysname、既定値はありません。primary_database is sysname, with no default.

[ @restore_delay = ] 'restore_delay' セカンダリ サーバーが指定されたバックアップ ファイルを復元する前に待機する分単位の時間数。[ @restore_delay = ] 'restore_delay' The amount of time, in minutes, that the secondary server waits before restoring a given backup file. restore_delayint NULL にすることはできません。restore_delay is int and cannot be NULL. 既定値は 0 です。The default value is 0.

[ @restore_all = ] 'restore_all' 場合 1、セカンダリ サーバーに設定するは、復元ジョブを実行すると、すべてのトランザクション ログ バックアップを復元します。[ @restore_all = ] 'restore_all' If set to 1, the secondary server restores all available transaction log backups when the restore job runs. それ以外の場合、1 つのファイルを復元した後を停止します。Otherwise, it stops after one file is restored. restore_allビットNULL にすることはできません。restore_all is bit and cannot be NULL.

[ @restore_mode = ] 'restore_mode' セカンダリ データベースの復元モード。[ @restore_mode = ] 'restore_mode' The restore mode for the secondary database.

0 = NORECOVERY でログを復元します。0 = Restore log with NORECOVERY.

1 = STANDBY でログを復元します。1 = restore log with STANDBY.

復元ビットNULL にすることはできません。restore is bit and cannot be NULL.

[ @disconnect_users = ] 'disconnect_users' かどうか 1 に設定、ユーザーが切断されているセカンダリ データベースから復元操作を実行します。[ @disconnect_users = ] 'disconnect_users' If set to 1, users are disconnected from the secondary database when a restore operation is performed. 既定 = 0。Default = 0. 切断ユーザーはビットNULL にすることはできません。disconnect users is bit and cannot be NULL.

[ @block_size = ] 'block_size' サイズ (バイト単位) をバックアップ デバイスのブロック サイズとして使用されます。[ @block_size = ] 'block_size' The size, in bytes, that is used as the block size for the backup device. block_sizeintを既定値は-1。block_size is int with a default value of -1.

[ @buffer_count = ] 'buffer_count' バックアップまたは復元操作で使用されるバッファーの合計数。[ @buffer_count = ] 'buffer_count' The total number of buffers used by the backup or restore operation. buffer_countintを既定値は-1。buffer_count is int with a default value of -1.

[ @max_transfer_size = ] 'max_transfer_size' サイズをバイト単位の最大入力または出力要求によって発行されたSQL ServerSQL Serverバックアップ デバイスにします。[ @max_transfer_size = ] 'max_transfer_size' The size, in bytes, of the maximum input or output request which is issued by SQL ServerSQL Server to the backup device. max_transfersizeint NULL にすることができます。max_transfersize is int and can be NULL.

[ @restore_threshold = ] 'restore_threshold' 許容経過時間を分単位の数は、アラートを生成する前に、操作を復元します。[ @restore_threshold = ] 'restore_threshold' The number of minutes allowed to elapse between restore operations before an alert is generated. restore_thresholdint NULL にすることはできません。restore_threshold is int and cannot be NULL.

[ @threshold_alert = ] 'threshold_alert' アラートが、バックアップのしきい値を超えたときに発生します。[ @threshold_alert = ] 'threshold_alert' Is the alert to be raised when the backup threshold is exceeded. threshold_alertint、既定値は 14,420 です。threshold_alert is int, with a default of 14,420.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' アラートが発生したかどうかを指定します。 ときにbackup_thresholdを超過します。[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Specifies whether an alert is raised when backup_threshold is exceeded. 値 1 (既定値) では、警告が発生します。The value of one (1), the default, means that the alert is raised. threshold_alert_enabledビットします。threshold_alert_enabled is bit.

[ @history_retention_period = ] 'history_retention_period' 履歴を保持する分単位の時間の長さです。[ @history_retention_period = ] 'history_retention_period' Is the length of time in minutes in which the history is retained. history_retention_periodint、既定値は NULL です。history_retention_period is int, with a default of NULL. 指定されていない場合、値 14420 が使用されます。A value of 14420 is used if none is specified.

リターン コードの値Return Code Values

0 (成功) または 1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

なしNone

コメントRemarks

sp_add_log_shipping_secondary_databaseから実行する必要があります、マスターセカンダリ サーバー上のデータベース。sp_add_log_shipping_secondary_database must be run from the master database on the secondary server. このストアド プロシージャでは次の処理が行われます。This stored procedure does the following:

  1. sp_add_log_shipping_secondary_primaryプライマリ ログ配布セカンダリ サーバー上のデータベース情報を初期化するためにこのストアド プロシージャの前に呼び出す必要があります。sp_add_log_shipping_secondary_primary should be called prior to this stored procedure to initialize the primary log shipping database information on the secondary server.

  2. セカンダリ データベースのエントリを追加します。 log_shipping_secondary_databases指定された引数を使用します。Adds an entry for the secondary database in log_shipping_secondary_databases using the supplied arguments.

  3. ローカル監視レコードを追加します。 log_shipping_monitor_secondary 、セカンダリ サーバーを使用して引数を指定します。Adds a local monitor record in log_shipping_monitor_secondary on the secondary server using supplied arguments.

  4. 監視サーバーがセカンダリ サーバーと異なる場合は、監視レコードを追加します。 log_shipping_monitor_secondaryモニターでサーバーを使用して引数を指定します。If the monitor server is different from the secondary server, adds a monitor record in log_shipping_monitor_secondary on the monitor server using supplied arguments.

アクセス許可Permissions

メンバーのみ、 sysadmin固定サーバー ロールは、この手順を実行できます。Only members of the sysadmin fixed server role can run this procedure.

使用例Examples

この例を使用して、 sp_add_log_shipping_secondary_databaseストアド プロシージャ、データベースを追加するLogShipAdventureWorksログ配布構成におけるセカンダリ データベースとしてプライマリ データベースとAdventureWorks2012AdventureWorks2012プライマリ サーバー TRIBECA に搭載されています。This example illustrates using the sp_add_log_shipping_secondary_database stored procedure to add the database LogShipAdventureWorks as a secondary database in a log shipping configuration with the primary database AdventureWorks2012AdventureWorks2012 residing on the primary server TRIBECA.

EXEC master.dbo.sp_add_log_shipping_secondary_database   
@secondary_database = N'LogShipAdventureWorks'   
,@primary_server = N'TRIBECA'   
,@primary_database = N'AdventureWorks2012'   
,@restore_delay = 0   
,@restore_mode = 1   
,@disconnect_users = 0   
,@restore_threshold = 45     
,@threshold_alert_enabled = 0   
,@history_retention_period = 1440 ;  
GO  

関連項目See Also

ログ配布について (SQL Server) About Log Shipping (SQL Server)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)