sp_change_log_shipping_secondary_database (Transact-SQL)

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

Convenções da sintaxe Transact-SQL

Sintaxe

sp_change_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[, [ @restore_delay = ] 'restore_delay']
[, [ @restore_all = ] 'restore_all']
[, [ @restore_mode = ] 'restore_mode']
[, [ @disconnect_users = ] 'disconnect_users']
[, [ @block_size = ] 'block_size']
[, [ @buffer_count = ] 'buffer_count']
[, [ @max_transfer_size = ] 'max_transfer_size']
[, [ @restore_threshold = ] 'restore_threshold'] 
[, [ @threshold_alert = ] 'threshold_alert'] 
[, [ @threshold_alert_enabled = ] 'threshold_alert_enabled'] 
[, [ @history_retention_period = ] 'history_retention_period']

Argumentos

• [ @restore_delay = ] 'restore_delay'
  A quantidade de tempo, em minutos, que o servidor secundário espera antes de restaurar um determinado arquivo de backup. restore_delay é int e não pode ser NULL. O valor padrão é 0.

• [ @restore_all = ] 'restore_all'
  Se definido como 1, o servidor secundário restaura todos os backups de log de transações disponíveis quando o trabalho de restauração é executado. Caso contrário, ele será interrompido depois que um arquivo for restaurado. restore_all é bit e não pode ser NULL.

• [ @restore_mode = ] 'restore_mode'
  O modo de restauração do banco de dados secundário.

  0 = restaure o log NORECOVERY.

  1 = restaure o log de restauração com STANDBY.

  restore é bit e não pode ser NULL.

• [ @disconnect_users = ] 'disconnect_users'
  Se definido em 1, os usuários são desconectados de um banco de dados secundários quando a operação de restauração é executada. Padrão = 0. disconnect_users é bit e não pode ser NULL.

• [ @block_size = ] 'block_size'
  Tamanho, em bytes, usado como tamanho de bloco para o dispositivo de backup. block_size é int, com um valor padrão de -1.

• [ @buffer_count = ] 'buffer_count'
  Número total de buffers usado pela operação de backup ou restauração. buffer_count é int, com um valor padrão de -1.

• [ @max_transfer_size = ] 'max_transfer_size'
  O tamanho, em bytes, da solicitação máxima de entrada ou de saída emitida por SQL Server para o dispositivo de backup. max_transfersize é int e pode ser NULL.

• [ @restore_threshold = ] 'restore_threshold'
  Número de minutos permitidos a decorrer entre operações de restauração antes que um alerta seja gerado. restore_threshold é int e não pode ser NULL.

• [ @threshold_alert = ] 'threshold_alert'
  É o alerta a ser gerado quando o limite da restauração é excedido. threshold_alert é int, com um valor padrão 14420.

• [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
  Especifica se haverá um alerta quando restore_threshold for excedido. 1 = habilitado; 0 = desabilitado. threshold_alert_enabled é bit e não pode ser NULL.

• [ @history_retention_period = ] 'history_retention_period'
  É a duração de tempo em minutos na qual o histórico será retido. history_retention_period é int. Se nenhum valor for especificado, será usado o valor 1.440.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

sp_change_log_shipping_secondary_database deve ser executado do banco de dados master no servidor secundário. Esse procedimento armazenado faz o seguinte:

1. Altera as configurações nos registros log_shipping_secondary_database, como necessário

2. Altera o monitor local registrado no log_shipping_monitor_secondary, no servidor secundário, 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_secondary_database para atualizar parâmetros de banco de dados secundários, para o banco de dados LogShipAdventureWorks.

EXEC master.dbo.sp_change_log_shipping_secondary_database 
 @secondary_database =  'LogShipAdventureWorks'
,  @restore_delay = 0
,  @restore_all = 1
,  @restore_mode = 0
,  @disconnect_users = 0
,  @threshold_alert = 14420
,  @threshold_alert_enabled = 1
,  @history_retention_period = 14420

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Conceitos

Sobre o envio de logs (SQL Server)