sp_add_log_shipping_secondary_primary (Transact-SQL)sp_add_log_shipping_secondary_primary (Transact-SQL)

適用対象: ○SQL Server XAzure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

指定したプライマリ データベースのセカンダリ サーバーに対して、プライマリ情報の設定、ローカルおよびリモート監視リンクの追加、コピー ジョブと復元ジョブの作成を行います。Sets up the primary information, adds local and remote monitor links, and creates copy and restore jobs on the secondary server for the specified primary database.

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

構文Syntax

  
sp_add_log_shipping_secondary_primary  
 [ @primary_server = ] 'primary_server',   
[ @primary_database = ] 'primary_database',  
[ @backup_source_directory = ] 'backup_source_directory' ,   
[ @backup_destination_directory = ] 'backup_destination_directory'  
[ @copy_job_name = ] 'copy_job_name'  
[ @restore_job_name = ] 'restore_job_name'  
[, [ @file_retention_period = ] 'file_retention_period']  
[, [ @monitor_server = ] 'monitor_server']  
[, [ @monitor_server_security_mode = ] 'monitor_server_security_mode']  
[, [ @monitor_server_login = ] 'monitor_server_login']  
[, [ @monitor_server_password = ] 'monitor_server_password']  
[, [ @copy_job_id = ] 'copy_job_id' OUTPUT ]  
[, [ @restore_job_id = ] 'restore_job_id' OUTPUT ]  
[, [ @secondary_id = ] 'secondary_id' OUTPUT]  

引数Arguments

[ @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.

[ @backup_source_directory = ] 'backup_source_directory' プライマリ サーバーからのトランザクション ログ バックアップ ファイルの保存先ディレクトリ。[ @backup_source_directory = ] 'backup_source_directory' The directory where transaction log backup files from the primary server are stored. backup_source_directorynvarchar (500) NULL にすることはできません。backup_source_directory is nvarchar(500) and cannot be NULL.

[ @backup_destination_directory = ] 'backup_destination_directory' バックアップ ファイルがコピー先のセカンダリ サーバー上のディレクトリ。[ @backup_destination_directory = ] 'backup_destination_directory' The directory on the secondary server where backup files are copied to. backup_destination_directorynvarchar (500) NULL にすることはできません。backup_destination_directory is nvarchar(500) and cannot be NULL.

[ @copy_job_name = ] 'copy_job_name' 使用する名前、SQL ServerSQL Serverトランザクション ログ バックアップをセカンダリ サーバーにコピーに作成されているエージェント ジョブ。[ @copy_job_name = ] 'copy_job_name' The name to use for the SQL ServerSQL Server Agent job being created to copy transaction log backups to the secondary server. copy_job_namesysname NULL にすることはできません。copy_job_name is sysname and cannot be NULL.

[ @restore_job_name = ] 'restore_job_name' 名前を指定します、SQL ServerSQL Serverセカンダリ データベースにバックアップを復元するセカンダリ サーバー上のエージェント ジョブ。[ @restore_job_name = ] 'restore_job_name' Is the name of the SQL ServerSQL Server Agent job on the secondary server that restores the backups to the secondary database. restore_job_namesysname NULL にすることはできません。restore_job_name is sysname and cannot be NULL.

[ @file_retention_period = ] 'file_retention_period' 指定されたパスのセカンダリ サーバーでバックアップ ファイルが保持される分単位の時間の長さ、@backup_destination_directoryパラメーターを削除する前にします。[ @file_retention_period = ] 'file_retention_period' The length of time, in minutes, that a backup file is retained on the secondary server in the path specified by the @backup_destination_directory parameter before being deleted. history_retention_periodint、既定値は NULL です。history_retention_period is int, with a default of NULL. 指定されていない場合、値 14420 が使用されます。A value of 14420 will be used if none is specified.

[ @monitor_server = ] 'monitor_server' 監視サーバーの名前です。[ @monitor_server = ] 'monitor_server' Is the name of the monitor server. Monitor_serversysname、既定値はありません、NULL にすることはできません。Monitor_server is sysname, with no default, and cannot be NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode' 監視サーバーへの接続に使用されるセキュリティ モード。[ @monitor_server_security_mode = ] 'monitor_server_security_mode' The security mode used to connect to the monitor server.

1 = Windows 認証。1 = Windows Authentication.

0 =SQL ServerSQL Server認証します。0 = SQL ServerSQL Server authentication.

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

[ @monitor_server_login = ] 'monitor_server_login' 監視サーバーへのアクセスに使用するアカウントの username です。[ @monitor_server_login = ] 'monitor_server_login' Is the username of the account used to access the monitor server.

[ @monitor_server_password = ] 'monitor_server_password' 監視サーバーへのアクセスに使用するアカウントのパスワードです。[ @monitor_server_password = ] 'monitor_server_password' Is the password of the account used to access the monitor server.

[ @copy_job_id = ] 'copy_job_id' OUTPUT セカンダリ サーバー上のコピー ジョブに関連付けられている ID です。[ @copy_job_id = ] 'copy_job_id' OUTPUT The ID associated with the copy job on the secondary server. copy_job_iduniqueidentifier NULL にすることはできません。copy_job_id is uniqueidentifier and cannot be NULL.

[ @restore_job_id = ] 'restore_job_id' OUTPUT セカンダリ サーバー上の復元ジョブに関連付けられている ID です。[ @restore_job_id = ] 'restore_job_id' OUTPUT The ID associated with the restore job on the secondary server. restore_job_iduniqueidentifier NULL にすることはできません。restore_job_id is uniqueidentifier and cannot be NULL.

[ @secondary_id = ] 'secondary_id' OUTPUT ログ配布構成におけるセカンダリ サーバーの ID。[ @secondary_id = ] 'secondary_id' OUTPUT The ID for the secondary server in the log shipping configuration. secondary_iduniqueidentifier NULL にすることはできません。secondary_id is uniqueidentifier and cannot be NULL.

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

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

結果セットResult Sets

なしNone

コメントRemarks

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

  1. 指定したプライマリ サーバーとプライマリ データベースのセカンダリ ID を生成する。Generates a secondary ID for the specified primary server and primary database.

  2. 次を行います。Does the following:

フィードバックをお待ちしております。 この記事の手順やコード例の中で、古い情報や間違っている情報を見つけた場合は、ぜひお知らせください。We are listening: If you find something outdated or incorrect in this article, such as a step or a code example, please tell us. このページの下部にある [フィードバック] セクション内で [このページ] ボタンをクリックしてください。You can click the This page button in the Feedback section at the bottom of this page. SQL に関するフィードバックのすべての項目に目を通しています (通常は翌日)。We read every item of feedback about SQL, typically the next day. よろしくお願いいたします。Thanks.

1.  <span data-ttu-id="43c8a-145">セカンダリ ID のエントリを追加します。 **log_shipping_secondary**指定された引数を使用します。</span><span class="sxs-lookup"><span data-stu-id="43c8a-145">Adds an entry for the secondary ID in **log_shipping_secondary** using the supplied arguments.</span></span>  

2.  <span data-ttu-id="43c8a-146">無効になったセカンダリ ID のコピー ジョブを作成する。</span><span class="sxs-lookup"><span data-stu-id="43c8a-146">Creates a copy job for the secondary ID that is disabled.</span></span>  

3.  <span data-ttu-id="43c8a-147">コピー ジョブ ID を設定、 **log_shipping_secondary**コピー ジョブのジョブ ID を入力します。</span><span class="sxs-lookup"><span data-stu-id="43c8a-147">Sets the copy job ID in the **log_shipping_secondary** entry to the job ID of the copy job.</span></span>  

4.  <span data-ttu-id="43c8a-148">無効になったセカンダリ ID の復元ジョブを作成します。</span><span class="sxs-lookup"><span data-stu-id="43c8a-148">Creates a restore job for the secondary ID that is disabled.</span></span>  

5.  <span data-ttu-id="43c8a-149">復元ジョブ ID を設定、 **log_shipping_secondary**復元ジョブのジョブ ID を入力します。</span><span class="sxs-lookup"><span data-stu-id="43c8a-149">Set the restore job ID in the **log_shipping_secondary** entry to the job ID of the restore job.</span></span>  

アクセス許可Permissions

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

使用例Examples

この例を使用して、 sp_add_log_shipping_secondary_primaryストアド プロシージャをプライマリ データベースの情報を設定するAdventureWorks2012AdventureWorks2012セカンダリ サーバーです。This example illustrates using the sp_add_log_shipping_secondary_primary stored procedure to set up information for the primary database AdventureWorks2012AdventureWorks2012 on the secondary server.

EXEC master.dbo.sp_add_log_shipping_secondary_primary   
@primary_server = N'TRIBECA'   
,@primary_database = N'AdventureWorks'   
,@backup_source_directory = N'\\tribeca\LogShipping'   
,@backup_destination_directory = N''   
,@copy_job_name = N''   
,@restore_job_name = N''   
,@file_retention_period = 1440   
,@monitor_server = N'ROCKAWAY'   
,@monitor_server_security_mode = 1   
,@copy_job_id = @LS_Secondary__CopyJobId OUTPUT   
,@restore_job_id = @LS_Secondary__RestoreJobId OUTPUT   
,@secondary_id = @LS_Secondary__SecondaryId OUTPUT ;  
GO  

関連項目See Also

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