sp_change_log_shipping_primary_database (Transact-SQL)

Altera as configurações do banco de dados primário.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] 'backup_share'] 
[, [ @backup_retention_period = ] 'backup_retention_period']
[, [ @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_compression = ] backup_compression_option ] 

Argumentos

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

• [ @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 padrão 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 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 emitido quando o limite do backup for excedido. threshold_alert é int e não pode ser NULL.

• [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
  Especifica se haverá um alerta quando backup_threshold for excedido.

  1 = habilitado.

  0 = desabilitado.

  threshold_alert_enabled é bit e não pode ser NULL.

• [ @history_retention_period = ] 'history_retention_period'
  É o período em minutos no qual o histórico é retido. history_retention_period é int. O valor 14420 será usado se nenhum valor for especificado.

• [ @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_change_log_shipping_primary_database deve ser executado a partir do banco de dados mestre no servidor primário. Esse procedimento armazenado faz o seguinte:

1. Altera as configurações no registro log_shipping_primary_database, se necessário.

2. Altera o registro local em log_shipping_monitor_primary no servidor primário usando argumentos fornecidos, se necessário.

3. Se o servidor monitor for diferente do servidor primário, altera o registro em log_shipping_monitor_primary no servidor monitor usando os argumentos fornecidos, se necessário.

Permissões

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

Exemplos

Este exemplo ilustra o uso de sp_change_log_shipping_primary_database para atualizar as configurações associadas ao AdventureWorks2012 do banco de dados primário.

EXEC master.dbo.sp_change_log_shipping_primary_database 
 @database = N'AdventureWorks' 
, @backup_directory = N'c:\LogShipping' 
, @backup_share = N'\\tribeca\LogShipping' 
, @backup_retention_period = 1440 
, @backup_threshold = 60 
, @threshold_alert = 0 
, @threshold_alert_enabled = 1 
, @history_retention_period = 1440 
,@monitor_server_security_mode = 1
,@backup_compression = 1

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

log_shipping_primary_databases (Transact-SQL)

Conceitos

Sobre o envio de logs (SQL Server)