sys.sp_change_log_shipping_secondary_database (Transact-SQL)

Aplica-se a: SQL Server

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

Transact-SQL convenções de sintaxe

Syntax

sys.sp_change_log_shipping_secondary_database
    [ @secondary_database = ] N'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 ]
    [ , [ @ignoreremotemonitor = ] ignoreremotemonitor ]
[ ; ]

Arguments

@secondary_database [ = ] N'secondary_database'

O nome da base de dados no servidor secundário. @secondary_database é sysname, sem padrão.

[ @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, com um padrão de 0, e não pode ser NULL.

[ @restore_all = ] restore_all

Se definido para 1, o servidor secundário restaura todas as cópias de segurança dos registos de transações disponíveis quando o trabalho de restauro é executado. Caso contrário, ele para depois que um arquivo é restaurado. @restore_allé mordido, e não pode ser NULL.

[ @restore_mode = ] restore_mode

O modo de restauração para o banco de dados secundário. @restore_modeé mordido, e não pode ser NULL.

  • 0 = restaurar o registo com NORECOVERY.
  • 1 = restaurar o registo com STANDBY.

[ @disconnect_users = ] disconnect_users

Se definido para 1, os utilizadores são desligados da base de dados secundária quando é realizada uma operação de restauro. @disconnect_users é bit, com um padrão de 0, 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 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 padrão de -1.

[ @max_transfer_size = ] max_transfer_size

O tamanho, em bytes, do pedido máximo de entrada ou saída emitido pelo SQL Server ao dispositivo de backup. @max_transfer_size é int, com um padrão de NULL.

[ @restore_threshold = ] restore_threshold

O número de minutos permitidos 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 for excedido. @threshold_alert é int, com um padrão de 14421.

@threshold_alert_enabled [ = ] threshold_alert_enabled

Especifica se um alerta é emitido quando @restore_threshold é ultrapassado.

  • 1 = ativado
  • 0 = desativado.

@threshold_alert_enabledé mordido, e não pode ser NULL.

@history_retention_period [ = ] history_retention_period

O período de tempo em minutos em que o histórico é mantido. @history_retention_period é int, com um padrão de 1440.

[ @ignoreremotemonitor = ] ignorar monitor remoto

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Remarks

sp_change_log_shipping_secondary_database deve ser executado a master partir do banco de dados no servidor secundário. Este procedimento armazenado executa os seguintes passos:

  1. Altera as definições nos log_shipping_secondary_database registos conforme necessário.

  2. Altera o registo local do monitor no log_shipping_monitor_secondary servidor secundário usando argumentos fornecidos, se necessário.

Permissions

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

Examples

Este exemplo ilustra o uso sp_change_log_shipping_secondary_database para atualizar parâmetros secundários da base de dados para a base de dados LogShipAdventureWorks.

EXECUTE 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;