sp_change_log_shipping_secondary_database (Transact-SQL)

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

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

Ícone de link do tópico 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 aguarda 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 restaurará todos os backups de log de transações disponíveis quando o trabalho de restauração for executado. Caso contrário, ele será interrompido depois que um arquivo tiver sido restaurado. restore_all é bit e não pode ser NULL.

[ @restore_mode = ] 'restore_mode' O modo de restauração para o 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 como 1, os usuários são desconectados do banco de dados secundário quando uma operação de restauração é executada. Padrão = 0. disconnect_users é bit e não pode ser NULL.

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

[ @buffer_count = ] 'buffer_count' O número total de buffers usados 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 de entrada ou saída máxima emitida pelo SQL Server para o dispositivo de backup. max_transfersize é int e pode ser NULL.

[ @restore_threshold = ] 'restore_threshold' O número de minutos permitidos para sair entre as 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 de restauração é excedido. threshold_alert é int, com um padrão de 14421.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled' Especifica se um alerta será gerado 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' É o período de tempo em minutos no qual o histórico será mantido. history_retention_period é int. Um valor de 1440 será usado se nenhum for especificado.

Valores do 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 mestre no servidor secundário. Esse procedimento armazenado faz o seguinte:

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

  2. Altera o registro do monitor local log_shipping_monitor_secondary no servidor secundário usando 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

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