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.
.gif "Ícone de vínculo de tópico")
Convenções da 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 valor 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 da rede para o diretório de backup no servidor primário. backup_share é nvarchar(500), sem valor 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 backup. 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 backup no servidor primário. backup_retention_period é int, sem valor padrão e não pode ser NULL.[ @monitor_server= ] 'monitor_server'
É o nome do servidor monitor. Monitor_server é sysname, sem valor 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 ao 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'
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 gerado quando o limite do backup for excedido. threshold_alert é int, com o valor padrão 14.420.[ @threshold_alert_enabled= ] threshold_alert_enabled
Especifica se haverá um alerta quando backup_threshold for excedido. O valor zero (0), o padrão, significa que o alerta está desabilitado e não será aumentado. threshold_alert_enabled is bit.[ @history_retention_period= ] history_retention_period
É a duração de tempo em minutos na qual o histórico será retido. history_retention_period é int, com um padrão 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 associada 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 a configuração de envio de log. 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 compacte backups de log.
1 = Habilitado. Sempre compacte backups de log.
2 = Use a configuração de Exibir ou configurar a opção de configuração de servidor backup compression default. Esse é 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:
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.
Cria um trabalho de backup para o banco de dados primário que está desabilitado.
Define a ID do trabalho de backup na entrada log_shipping_primary_databases para a ID do trabalho de backup.
Adiciona um registro de monitor local à tabela log_shipping_monitor_primary no servidor primário, usando os argumentos fornecidos.
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 este procedimento.
Exemplos
Este exemplo adiciona o banco de dados AdventureWorks2012 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
Consulte também
Referência
Procedimentos armazenados do sistema (Transact-SQL)