sp_add_log_shipping_secondary_primary (Transact-SQL)

Configura as informações primárias, adiciona links de monitor local e remoto e cria trabalhos de cópia e restauração no servidor secundário para o banco de dados primário especificado.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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]

Argumentos

  • [ @primary_server = ] 'primary_server'
    O nome da instância primária do Microsoft Mecanismo de banco de dados do SQL Server na configuração de envio de logs. primary_server é sysname e não pode ser NULL.

  • [ @primary_database = ] 'primary_database'
    Nome do banco de dados no servidor primário. primary_database é sysname, sem padrão.

  • [ @backup_source_directory = ] 'backup_source_directory'
    Diretório em que os arquivos de backup de log de transações do servidor primário são armazenados. backup_source_directory é nvarchar(500) e não pode ser NULL.

  • [ @backup_destination_directory = ] 'backup_destination_directory'
    Diretório do servidor secundário em que os arquivos de backup são copiados. backup_destination_directory é nvarchar(500) e não pode ser NULL.

  • [ @copy_job_name = ] 'copy_job_name'
    Nome a ser usado para o trabalho do SQL Server Agent que está sendo criado para copiar backups de log de transações no servidor secundário. copy_job_name é sysname e não pode ser NULL.

  • [ @restore_job_name = ] 'restore_job_name'
    Nome do trabalho do SQL Server Agent no servidor secundário que restaura os backups no banco de dados secundário. restore_job_name é sysname e não pode ser NULL.

  • [ @file_retention_period = ] 'file_retention_period'
    Período em minutos em que o histórico é retido. history_retention_period é int, com um padrão NULL. Se nenhum valor for especificado, será usado o valor 14.420.

  • [ @monitor_server = ] 'monitor_server'
    Nome do servidor monitor. Monitor_server é sysname, sem padrão, e não pode ser NULL.

  • [ @monitor_server_security_mode = ] 'monitor_server_security_mode'
    Modo de segurança usado para conexão com o servidor monitor.

    1 = Autenticação do Windows.

    0 = Autenticação do SQL Server.

    monitor_server_security_mode é bit e não pode ser NULL.

  • [ @monitor_server_login = ] 'monitor_server_login'
    Nome de usuário da conta usado para acessar o servidor monitor.

  • [ @monitor_server_password = ] 'monitor_server_password'
    Senha da conta usada para acessar o servidor monitor.

  • [ @copy_job_id = ] 'copy_job_id' OUTPUT
    ID associada ao trabalho de cópia no servidor secundário. copy_job_id é uniqueidentifier e não pode ser NULL.

  • [ @restore_job_id = ] 'restore_job_id' OUTPUT
    ID associada ao trabalho de restauração no servidor secundário. restore_job_id é uniqueidentifier e não pode ser NULL.

  • [ @secondary_id = ] 'secondary_id' OUTPUT
    ID do servidor secundário na configuração de envio de log. secondary_id é uniqueidentifier e não pode ser NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_add_log_shipping_secondary_primary precisa ser executado no banco de dados mestre do servidor secundário. Esse procedimento armazenado faz o seguinte:

  1. Gera uma ID secundária para o servidor primário especificado e o banco de dados primário.

  2. Faz o seguinte:

    1. Adiciona uma entrada para a ID secundária em log_shipping_secondary usando os argumentos fornecidos.

    2. Cria um trabalho de cópia para a ID secundária que é desabilitada.

    3. Define a ID do trabalho de cópia na entrada log_shipping_secondary para a ID de trabalho do trabalho de cópia.

    4. Cria um trabalho de restauração para a ID secundária que é desabilitada.

    5. Define a ID do trabalho de restauração na entrada log_shipping_secondary para a ID de trabalho do trabalho de restauração.

Permissões

Somente membros da função de servidor fixa sysadmin podem executar esse procedimento.

Exemplos

Esse exemplo ilustra a utilização do procedimento armazenado sp_add_log_shipping_secondary_primary para configurar informações para o AdventureWorks2008R2 do banco de dados primário no servidor secundário.

EXEC master.dbo.sp_add_log_shipping_secondary_primary 
@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks2008R2' 
,@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