sp_changedistributiondb (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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

Convenções de sintaxe de 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 fornecido. property é sysname e pode ser um desses 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 de propriedade disponíveis são impressos.

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

Valores do código de retorno

0 (sucesso) ou 1 (fracasso)

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.

Confira também

Exibir e modificar propriedades de Publicador e Distribuidor
sp_adddistributiondb (Transact-SQL)
sp_dropdistributiondb (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL)