Compartilhar via


sp_changedistributor_property (Transact-SQL)

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

Altera as propriedades do Distribuidor. Esse procedimento armazenado é executado no Distribuidor em qualquer banco de dados. Para Distribuidores remotos, esse procedimento armazenado precisa ser executado em todos os servidores Publicador que se conectam ao Distribuidor remoto.

Se a distribuição ou o banco de dados do Publisher estiver em um grupo de disponibilidade, o procedimento armazenado precisará ser executado em todos os nós distribuidor e publicador, independentemente de sua função atual no grupo de disponibilidade.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_changedistributor_property
    [ [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Argumentos

@property [ = ] N'propriedade'

A propriedade de um determinado Distribuidor. @property é sysname e pode ser um destes valores:

Nome da propriedade Valores aceitáveis Descrição
heartbeat_interval Qualquer valor int (em minutos) Número máximo de minutos que um agente pode executar sem registrar uma mensagem de progresso. @heartbeat_interval é int, com um padrão de 10 minutos.
encrypt_distributor_connection mandatory, optional, strict, true, , false, yes, no Especifica o tipo de criptografia entre o Distribuidor e outros componentes de replicação.

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores.
trust_distributor_certificate yes, no Especifica se é necessário confiar no certificado usado pelo Distribuidor para conexões criptografadas. O padrão é no.

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores.
host_name_in_distributor_certificate Qualquer cadeia de caracteres Especifica o nome do host esperado no certificado do Distribuidor.

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores.
NULL (padrão) Todos os valores @property disponíveis são impressos.

Observação

Os padrões seguros pertencem ao provedor OLEDB 19 subjacente, que aprimora a segurança. A opção de substituir o padrão é menos segura do que configurar sua instância para usar um certificado confiável. Depois de substituir o padrão, você tem a opção de configurar o SQL Server para usar um certificado e, em seguida, usar o procedimento armazenado sp_changedistributor_property para definir a trust_distributor_certificate=no propriedade de volta para o padrão seguro.

@value [ = ] N'valor'

O valor da propriedade Distributor fornecida. @value é nvarchar(255), com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

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

Exemplos


-- Change the heartbeat interval at the Distributor to 5 minutes. 
USE master 
exec sp_changedistributor_property 
    @property = N'heartbeat_interval', 
    @value = 5;
GO

Configurar o distribuidor para confiar no certificado autoassinado

Para substituir o padrão seguro do provedor OLEDB 19 e definir trust_distributor_certificate=yes para que o distribuidor confie no certificado autoassinado, use o seguinte exemplo:

EXECUTE sp_changedistributor_property
    @property = N'trust_distributor_certificate',
    @value = N'yes';

Observação

Os padrões seguros pertencem ao provedor OLEDB 19 subjacente, que aprimora a segurança. A opção de substituir o padrão é menos segura do que configurar sua instância para usar um certificado confiável. Depois de substituir o padrão, você tem a opção de configurar o SQL Server para usar um certificado e, em seguida, usar o procedimento armazenado sp_changedistributor_property para definir a trust_distributor_certificate=no propriedade de volta para o padrão seguro.

Para mais informações, revise a mudança de distribuição remota no SQL Server 2025.

Permissões

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