sp_add_log_shipping_primary_database (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

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 link do 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 log. 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 SQL Server Agent no servidor primário que copia o backup para a 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 log no diretório de backup 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 se conectar ao servidor monitor.

1 = Autenticação do Windows.

0 = SQL Server Autenticação. 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, após o último backup antes que um threshold_alert erro seja gerado. backup_threshold é int, com um padrão de 60 minutos.

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

[ @threshold_alert_enabled = ] threshold_alert_enabled Especifica se um alerta será gerado 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 é bit.

[ @history_retention_period = ] history_retention_period É o período de tempo em minutos no qual o histórico será mantido. 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 SQL Server ID do trabalho do 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 log 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 da opção Exibir ou Configurar a configuração de servidor padrão de compactação de backup. Esse é o valor padrão.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_add_log_shipping_primary_database deve ser executado 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 para o 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 log_shipping_primary_databases entrada para a ID do trabalho de backup.

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

  5. Se o servidor monitor for diferente do servidor primário, o adiciona um registro de monitor log_shipping_monitor_primary no servidor monitor usando 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

Sobre o envio de logs (SQL Server)
Procedimentos armazenados do sistema (Transact-SQL)