Compartilhar via


sp_add_log_shipping_primary_database (Transact-SQL)

Instala o banco de dados primário para uma configuração de envio de log, incluindo o trabalho de backup, registro de monitor local e registro de monitor remoto.

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

Sintaxe

sp_add_log_shipping_primary_database [ @database = ] 'database', 
[ @backup_directory = ] 'backup_directory', 
[ @backup_share = ] 'backup_share', 
[ @backup_job_name = ] 'backup_job_name', 
[, [ @backup_retention_period = ] backup_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']
[, [ @backup_threshold = ] backup_threshold ] 
[, [ @threshold_alert = ] threshold_alert ] 
[, [ @threshold_alert_enabled = ] threshold_alert_enabled ] 
[, [ @history_retention_period = ] history_retention_period ]
[, [ @backup_job_id = ] backup_job_id OUTPUT ]
[, [ @primary_id = ] primary_id OUTPUT]
[, [ @backup_compression = ] backup_compression_option ] 

Argumentos

  • [ @database= ] 'database'
    É o nome do banco de dados primário de envio de logs. database é sysname, sem padrão, e não pode ser NULL.

  • [ @backup_directory= ] 'backup_directory'
    É o caminho para a pasta de backup no servidor primário. backup_directory é nvarchar(500), sem padrão, e não pode ser NULL.

  • [ @backup_share= ] 'backup_share'
    É o caminho de rede para o diretório de backup no servidor primário. backup_share é nvarchar(500), sem padrão, e não pode ser NULL.

  • [ @backup_job_name= ] 'backup_job_name'
    É o nome do trabalho do SQL Server Agent no servidor primário que copia o backup na pasta de backups. backup_job_name é sysname e não pode ser NULL.

  • [ @backup_retention_period= ] backup_retention_period
    É o período de tempo, em minutos, para reter o arquivo de backup de logs no diretório de backups no servidor primário. backup_retention_period é int, sem padrão, e não pode ser NULL.

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

  • [ @monitor_server_security_mode= ] monitor_server_security_mode
    O 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'
    É o nome de usuário da conta usada para acessar o servidor monitor.

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

  • [ @backup_threshold= ] backup_threshold
    É o período de tempo, em minutos, depois do último backup antes que um erro threshold_alert seja gerado. backup_threshold é int, com um padrão de 60 minutos.

  • [ @threshold_alert= ] threshold_alert
    É o alerta a ser emitido quando o limite de backup é excedido. threshold_alert é int, com um padrão de 14.420.

  • [ @threshold_alert_enabled= ] threshold_alert_enabled
    Especifica se haverá um alerta quando backup_threshold for excedido. O valor de zero (0), o padrão, significa que o alerta está desabilitado e não será aumentado. threshold_alert_enabled é bit.

  • [ @history_retention_period= ] history_retention_period
    É o período de tempo em minutos pelo qual o histórico será mantido. history_retention_period é int, com um padrão de NULL. Se nenhum valor for especificado, será usado o valor 14.420.

  • [ @backup_job_id= ] backup_job_id OUTPUT
    A ID de trabalho do SQL Server Agent associado ao trabalho de backup no servidor primário. backup_job_id é uniqueidentifier e não pode ser NULL.

  • [ @primary_id= ] primary_id OUTPUT
    A ID do banco de dados primário para configuração de envio de logs. primary_id é uniqueidentifier e não pode ser NULL.

  • [ @backup_compression = ] backup_compression_option
    Especifica se uma configuração de envio de logs usa compactação de backup. Este parâmetro é suportado somente no SQL Server 2008 Enterprise (ou em uma versão posterior).

    0 = Desabilitado. Nunca compacta backups de log.

    1 = Habilitado. Sempre compacte backups de log.

    2 = Use a configuração da opção de configuração do servidor do padrão de compactação de backup. Este é o valor padrão.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_add_log_shipping_primary_database deve ser executado a partir do banco de dados mestre no servidor primário. Esse procedimento armazenado executa as seguintes funções:

  1. Gera uma ID primária e adiciona uma entrada no banco de dados primário na tabela log_shipping_primary_databases usando os argumentos fornecidos.

  2. Cria um trabalho de backup para o banco de dados primário que está desabilitado.

  3. Define a ID do trabalho de backup na entrada log_shipping_primary_databases para a ID do trabalho de backup.

  4. Adiciona um registro de monitor local à tabela log_shipping_monitor_primary no servidor primário, usando os argumentos fornecidos.

  5. Se o servidor monitor for diferente do servidor primário, adiciona um registro de monitor em log_shipping_monitor_primary no servidor monitor usando os argumentos fornecidos.

Permissões

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

Exemplos

Este exemplo adiciona o banco de dados AdventureWorks2008R2 como banco de dados primário em uma configuração de envio de log.

DECLARE @LS_BackupJobId AS uniqueidentifier 
DECLARE @LS_PrimaryId AS uniqueidentifier 

EXEC master.dbo.sp_add_log_shipping_primary_database 
@database = N'AdventureWorks' 
,@backup_directory = N'c:\lsbackup' 
,@backup_share = N'\\tribeca\lsbackup' 
,@backup_job_name = N'LSBackup_AdventureWorks' 
,@backup_retention_period = 1440
,@monitor_server = N'rockaway' 
,@monitor_server_security_mode = 1 
,@backup_threshold = 60 
,@threshold_alert = 0 
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
,@backup_job_id = @LS_BackupJobId OUTPUT 
,@primary_id = @LS_PrimaryId OUTPUT 
,@overwrite = 1 
,@backup_compression = 0
GO