Partilhar via


sp_add_log_shipping_secondary_database (Transact-SQL)

Aplica-se a:SQL Server

Cria uma base de dados secundária para o envio de registos.

Transact-SQL convenções de sintaxe

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

Arguments

[ @secondary_database = ] 'secondary_database'

O nome do banco de dados secundário. @secondary_database é sysname, sem padrão.

@primary_server [ = ] «primary_server»

O nome da instância primária do 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 no servidor primário. @primary_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 é inteligente 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 a tarefa de restauração é executada. Caso contrário, ele para depois que um arquivo é restaurado. @restore_allé mordida e não pode ser NULL.

[ @restore_mode = ] 'restore_mode'

O modo de restauração para o banco de dados secundário.

  • 0: Restaurar registo com NORECOVERY
  • 1: restaurar registo com STANDBY

@restore_modeé mordida e não pode ser NULL.

[ @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. A predefinição é 0. @disconnect_usersé mordida 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 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 valor 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_transfersize é int e pode ser 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 é inteligente e não pode ser NULL.

@threshold_alert [ = ] «threshold_alert»

O alerta a ser disparado quando o limite de backup for excedido. @threshold_alert é int, com um padrão de 14.420.

@threshold_alert_enabled [ = ] «threshold_alert_enabled»

Especifica se um alerta é emitido quando @restore_threshold é ultrapassado. Um valor de 1 (o padrão) significa que o alerta é elevado. @threshold_alert_enabled é pouco.

[ @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 NULL. Um valor de 14420 é usado se nenhum for especificado.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

sp_add_log_shipping_secondary_database deve ser executado a master partir do banco de dados no servidor secundário. Este procedimento armazenado faz o seguinte:

  1. sp_add_log_shipping_secondary_primary deve ser chamado antes deste procedimento armazenado para inicializar a informação principal da base de dados de envio de registos no servidor secundário.

  2. Adiciona uma entrada para a base de dados secundária usando log_shipping_secondary_databases os argumentos fornecidos.

  3. Adiciona um registo local de monitorização no log_shipping_monitor_secondary servidor secundário usando argumentos fornecidos.

  4. Se o servidor de monitorização for diferente do servidor secundário, sp_add_log_shipping_secondary_database adiciona um registo de monitorização no log_shipping_monitor_secondary servidor de monitorização usando argumentos fornecidos.

Permissions

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

Examples

Este exemplo ilustra a utilização do sp_add_log_shipping_secondary_database procedimento armazenado para adicionar a base de dados LogShipAdventureWorks como base de dados secundária numa configuração de envio de registos, com a base de dados AdventureWorks2025 primária a residir no servidor TRIBECAprimário .

EXECUTE master.dbo.sp_add_log_shipping_secondary_database
    @secondary_database = N'LogShipAdventureWorks',
    @primary_server = N'TRIBECA',
    @primary_database = N'AdventureWorks2022',
    @restore_delay = 0,
    @restore_mode = 1,
    @disconnect_users = 0,
    @restore_threshold = 45,
    @threshold_alert_enabled = 0,
    @history_retention_period = 1440;
GO