Compartilhar via

sp_change_log_shipping_secondary_primary (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_primary
    [ @primary_server = ] 'primary_server' ,
    [ @primary_database = ] 'primary_database' ,
    [ , [ @backup_source_directory = ] N'backup_source_directory' ]
    [ , [ @backup_destination_directory = ] N'backup_destination_directory' ]
    [ , [ @file_retention_period = ] file_retention_period ]
    [ , [ @monitor_server_security_mode = ] monitor_server_security_mode ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumentos

@primary_server [ = ] 'primary_server'

O nome da instância primária do Mecanismo de Banco de Dados do SQL Server em uma configuração de envio de log. @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.

@backup_source_directory [ = ] N'backup_source_directory'

O diretório onde os arquivos de backup de log de transações do servidor primário são armazenados. @backup_source_directory é nvarchar(500) e não pode ser NULL.

@backup_destination_directory [ = ] N'backup_destination_directory'

O diretório no servidor secundário onde arquivos de backup são copiados. @backup_destination_directory é nvarchar(500) e não pode ser NULL.

@file_retention_period [ = ] 'file_retention_period'

O período de tempo em minutos em que os arquivos de backup são retidos. @file_retention_period é int, com um padrão de NULL. O valor 14420 será usado se nenhum valor for especificado.

@monitor_server_security_mode [ = ] 'monitor_server_security_mode'

O modo de segurança usado para conexão ao servidor monitor.

  • 1: Autenticação do Windows;
  • 0: Autenticação do SQL Server.

@monitor_server_security_mode é bit e o padrão é NULL.

@monitor_server_login [ = ] 'monitor_server_login'

O nome de usuário da conta usada para acessar o servidor do monitor.

@monitor_server_password [ = ] 'monitor_server_password'

A senha da conta usada para acessar o servidor do monitor.

[ @monitor_connection_options = ] '<key_value_pairs>; [...]'

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores

Especifica mais opções de conectividade para a conexão de servidor vinculado ao utilizar um monitor remoto, na forma de pares de valores de chave. @monitor_connection_options é nvarchar(4000) e tem o padrão de NULL.

A tabela a seguir lista as opções de conectividade disponíveis:

Key Value
Encrypt strict, mandatory, optional, , truefalse
TrustServerCertificate true, false, , yesno
ServerCertificate Caminho no sistema de arquivos para o certificado do servidor. Isso tem um comprimento máximo de 260 caracteres.
HostNameInCertificate Substituição de nome do host para o certificado. Isso tem um comprimento máximo de 255 caracteres.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

sp_change_log_shipping_secondary_primary deve ser executado a master partir do banco de dados no servidor secundário. Este procedimento armazenado executa as seguintes ações:

  1. Altera as configurações conforme log_shipping_secondary necessário.

  2. Se o servidor monitor for diferente do servidor secundário, altere o registro do monitor no log_shipping_monitor_secondary servidor monitor usando os argumentos fornecidos, se necessário.

Permissões

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

Conteúdo relacionado

  • Last updated on