• Artigo

sp_changedistributiondb (Transact-SQL)

Altera as propriedades do banco de dados de distribuição. Esse procedimento armazenado é executado no Distribuidor, em qualquer banco de dados.

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

Sintaxe

sp_changedistributiondb [ @database= ] 'database' 
    [ , [ @property= ] 'property' ] 
    [ , [ @value= ] 'value' ]

Argumentos

  • [ @database=] 'database'
    É o nome do banco de dados de distribuição. database é sysname, sem padrão.

  • [ @property=] 'property'
    É a propriedade a ser alterada para o banco de dados determinado. property é sysname, e pode ser um destes valores.

    Valor

    Descrição

    history_retention

    Período de retenção da tabela de histórico.

    max_distretention

    Período máximo de retenção de distribuição .

    min_distretention

    Período mínimo de retenção de distribuição.

    NULL (padrão)

    Todos os valores property são impressos.

  • [ @value=] 'value'
    É o novo valor da propriedade especificada. value é nvarchar(255), com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_changedistributiondb é usado em todos os tipos de replicação.

Exemplo

DECLARE @distributionDB AS sysname;
SET @distributionDB = N'distribution';

-- Change the history retention period to 24 hours and the
-- maximum retention period to 48 hours.  
USE distribution
EXEC sp_changedistributiondb @distributionDB, N'history_retention', 24
EXEC sp_changedistributiondb @distributionDB, N'max_distretention', 48
GO

Permissões

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