Partilhar via

  • Artigo

sp_change_log_shipping_primary_database (Transact-SQL)

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

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

Sintaxe

sp_change_log_shipping_primary_database [ @database = ] 'database'
[, [ @backup_directory = ] 'backup_directory'] 
[, [ @backup_share = ] '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 ]

Argumentos

  • [ [ @database = ] 'database'
    É o nome do banco de dados do servidor primário. primary_database é sysname, sem padrão definido.

  • [ [ @backup_directory = ] '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 = ] '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 reter o arquivo de backup de logs no diretório de backups 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 conexão com o servidor monitor.

    1 = Autenticação do Windows.

    0 = Autenticação do SQL Server.

    monitor_server_security_mode é bit e não pode ser 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, depois do último backup antes que um erro threshold_alert seja gerado. backup_threshold é int, com um padrão de 60 minutos.

  • [ [ @threshold_alert = ] 'threshold_alert'
    O alerta a ser emitido quando o limite de backup é excedido. threshold_alert é int e não pode ser NULL.

  • [ [ @threshold_alert_enabled = ] 'threshold_alert_enabled'
    Especifica se haverá um alerta quando backup_threshold for excedido.

    1 = habilitado.

    0 = desabilitado.

    threshold_alert_enabled é bit e não pode ser NULL.

  • [ [ @history_retention_period = ] 'history_retention_period'
    É o comprimento de em minutos hora na qual o histórico é retido. history_retention_period é int. O valor 14420 será usado se nenhum valor for especificado.

  • [ @backup_compression = ] backup_compression_option
    Especifica se uma configuração de envio de logs usa compactação de backup. Este parâmetro é suportado somente no SQL Server 2008 Enterprise (ou em uma versão posterior).

    0 = Desabilitado. Nunca compacta backups de log.

    1 = Habilitado. Sempre compacta backups de log.

    2 = Use a configuração da opção de configuração do servidor do padrão de compactação de backup. Este é o valor padrão.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

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

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

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

  3. Se o servidor monitor for diferente do servidor primário, altera o registro em log_shipping_monitor_primary no servidor monitor usando os argumentos fornecidos, se necessário.

Permissões

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

Exemplos

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

EXEC 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