Compartilhar via


sp_change_log_shipping_secondary_database (Transact-SQL)

Aplica-se: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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 ]
[ ; ]

Argumentos

@secondary_database [ = ] N'secondary_database'

O nome do banco 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 espera 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 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 for restaurado. @restore_all é um pouco e não pode serNULL.

@restore_mode [ = ] restore_mode

O modo de restauração do banco de dados secundário. @restore_mode é um pouco e não pode serNULL.

  • 0 = restaurar log com NORECOVERY.
  • 1 = restaurar log com STANDBY.

@disconnect_users [ = ] disconnect_users

Se definido como 1, os usuários serão desconectados do banco de dados secundário quando uma operação de restauração for executada. @disconnect_users é bit, com um padrão de 0, 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 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 padrão de -1.

@max_transfer_size [ = ] max_transfer_size

O tamanho, em bytes, da solicitação máxima de entrada ou saída emitida pelo SQL Server para o dispositivo de backup. @max_transfer_size é int, com um padrão de 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

Alerta a ser emitido quando o limite da restauração for excedido. @threshold_alert é int, com um padrão de 14421.

@threshold_alert_enabled [ = ] threshold_alert_enabled

Especifica se um alerta é gerado quando @restore_threshold é excedido.

  • 1 = habilitado
  • 0 = desativado.

@threshold_alert_enabled é um pouco e não pode serNULL.

@history_retention_period [ = ] history_retention_period

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

@ignoreremotemonitor [ = ] ignoreremotemonitor

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_change_log_shipping_secondary_database deve ser executado a master partir do banco de dados no servidor secundário. Esse procedimento armazenado executa as seguintes etapas:

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

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

Permissões

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

Exemplos

Este exemplo ilustra o uso 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;