Partilhar via

sp_change_log_shipping_primary_database (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

Sintaxe

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'backup_share' ]
    [ , [ @backup_retention_period = ] 'backup_retention_period' ]
    [ , [ @monitor_server_security_mode = ] 'monitor_server_security_mode' ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @backup_threshold = ] 'backup_threshold' ]
    [ , [ @threshold_alert = ] 'threshold_alert' ]
    [ , [ @threshold_alert_enabled = ] 'threshold_alert_enabled' ]
    [ , [ @history_retention_period = ] 'history_retention_period' ]
    [ , [ @backup_compression = ] backup_compression_option ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumentos

@database [ = ] «base de dados»

O nome do banco de dados no servidor primário. @primary_database é sysname, sem padrão.

@backup_directory [ = ] N'backup_directory'

O caminho para a pasta de backup no servidor primário. @backup_directory é nvarchar(500), sem padrão, e não pode ser NULL.

@backup_share [ = ] N'backup_share'

O caminho de rede para o diretório de backup no servidor primário. @backup_share é nvarchar(500), sem padrão, e não pode ser NULL.

@backup_retention_period [ = ] «backup_retention_period»

O período de tempo, em minutos, para manter o arquivo de backup de log no diretório de backup no servidor primário. @backup_retention_period é int, sem padrão, e não pode ser NULL.

@monitor_server_security_mode [ = ] «monitor_server_security_mode»

O modo de segurança usado para se conectar 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 monitor.

@monitor_server_password [ = ] «monitor_server_password»

A senha da conta usada para acessar o servidor monitor.

@backup_threshold [ = ] «backup_threshold»

O período de tempo, em minutos, após o último backup antes que um erro de @threshold_alert seja gerado. @backup_threshold é int, com um padrão de 60 minutos.

@threshold_alert [ = ] «threshold_alert»

O alerta a ser disparado quando o limite de backup for excedido. @threshold_alert é int e não pode ser NULL.

@threshold_alert_enabled [ = ] «threshold_alert_enabled»

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

  • 1: ativado
  • 0: deficiente

threshold_alert_enabled é pouco e não pode ser NULL.

@history_retention_period [ = ] «history_retention_period»

O período de tempo em minutos em que o histórico é mantido. @history_retention_period é int. Um valor de 14420 é usado se nenhum for especificado.

@backup_compression [ = ] backup_compression_option

Especifica se uma configuração de envio de logs usa compactação de backup. Este parâmetro tem suporte na edição Enterprise para SQL Server 2008 (10.0.x) (e versões posteriores) e em todas as edições no SQL Server 2016 (13.x) com Service Pack 1 (e versões posteriores).

  • 0: Desativado. Nunca compacte backups de log

  • 1: Ativado. Sempre compactar backups de log

  • 2 (padrão): use a opção de configuração do servidor padrão de compactação de backup .

@monitor_connection_options [ = ] «<key_value_pairs>;[ ...]»

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

Especifica opções de conectividade adicionais para a conexão do 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, true, false
TrustServerCertificate true, false, yes, no
ServerCertificate Caminho no sistema de arquivos para o certificado do servidor. Este tem um comprimento máximo de 260 caracteres.
HostNameInCertificate Substituição de nome de host para o certificado. Este tem um comprimento máximo de 255 caracteres.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

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

  1. Altera as configurações no log_shipping_primary_database registro, se necessário.

  2. Altera o registro local no log_shipping_monitor_primary servidor primário usando argumentos fornecidos, se necessário.

  3. Se o servidor monitor for diferente do servidor primário, as alterações serão registradas no log_shipping_monitor_primary servidor monitor usando os argumentos fornecidos, se necessário.

Permissões

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

Exemplos

Este exemplo ilustra o uso de sp_change_log_shipping_primary_database para atualizar as configurações associadas ao banco de dados AdventureWorks2025primário .

EXECUTE master.dbo.sp_change_log_shipping_primary_database
    @database = N'AdventureWorks',
    @backup_directory = N'c:\LogShipping',
    @backup_share = N'\\tribeca\LogShipping',
    @backup_retention_period = 1440,
    @backup_threshold = 60,
    @threshold_alert = 0,
    @threshold_alert_enabled = 1,
    @history_retention_period = 1440,
    @monitor_server_security_mode = 1,
    @backup_compression = 1;

Conteúdo relacionado

  • Last updated on