sys.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

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

Arguments

@secondary_database [ = ] N'secondary_database'

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

@primary_server [ = ] N'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 [ = ] N'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.

[ @overwrite = ] sobrescrever

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

[ @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.

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