• Artigo

sp_add_log_shipping_secondary_database (Transact-SQL)

Configura um banco de dados secundário para o envio de logs.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

        sp_add_log_shipping_secondary_database
[ @secondary_database = ] 'secondary_database',
[ @primary_server = ] 'primary_server', 
[ @primary_database = ] 'primary_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

  • [ @secondary_database = ] 'secondary_database'
    É o nome do banco de dados secundário. secondary_database é sysname, sem nenhum padrão.

  • [ @primary_server = ] 'primary_server'
    Nome da instância primária do Microsoft Mecanismo de banco de dados do SQL Server, na configuração de envio de logs. primary_server, é sysname e não pode ser NULL.

  • [ @primary_database = ] 'primary_database'
    É o nome do banco de dados do servidor primário. primary_database é sysname, sem nenhum 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 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 encerra após um arquivo ser 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 = Log de restauração com 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. Default = 0. disconnect usuários é bit e não pode ser NULL.

  • [ @block_size = ] 'block_size'
    O tamanho, em bytes, usado como 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 usado pelo backup ou operação de restauração. buffer_count é int, com um valor padrão -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'
    Número de minutos permitidos para o 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 emitido quando o limite de backup é excedido. threshold_alert é int, com um padrão de 14.420.

  • [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Especifica se haverá um alerta quando backup_threshold for excedido. O valor de um (1), por padrão, significa que o alerta é emitido. threshold_alert_enabled é bit.

  • [ @history_retention_period = ] 'history_retention_period'
    É o período em minutos em que o histórico é mantido. history_retention_period é int, com um padrão de NULL. O valor 14420 será usado se nenhum valor for especificado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

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

  1. sp_add_log_shipping_secondary_primary deve ser carregado antes deste procedimento armazenado para inicializar a informação do banco de dados de envio de logs primário no servidor secundário.

  2. Adiciona uma entrada para o banco de dados secundário em log_shipping_secondary usando os argumentos fornecidos.

  3. Adiciona um registro de monitor local em log_shipping_monitor_secondary no servidor secundário usando os argumentos fornecidos.

  4. Se o servidor monitor for diferente do servidor secundário, adiciona um registro de monitor em log_shipping_monitor_secondary no servidor monitor usando os argumentos fornecidos.

Permissões

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

Exemplos

Este exemplo ilustra a utilização do procedimento armazenado sp_add_log_shipping_secondary_database para adicionar o banco de dados LogShipAdventureWorks2008R2 como um banco de dados secundário em uma configuração de envio de logs com o banco de dados primário AdventureWorks2008R2 que reside no servidor primário TRIBECA.

EXEC master.dbo.sp_add_log_shipping_secondary_database 
@secondary_database = N'LogShipAdventureWorks2008R2' 
,@primary_server = N'TRIBECA' 
,@primary_database = N'AdventureWorks2008R2' 
,@restore_delay = 0 
,@restore_mode = 1 
,@disconnect_users = 0 
,@restore_threshold = 45   
,@threshold_alert_enabled = 0 
,@history_retention_period = 1440 
GO