Partilhar via

sp_changedistributor_property (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

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

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

@property [ = ] N'propriedade'

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

Nome da propriedade Valores aceitáveis Description
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 o certificado usado pelo Distribuidor deve ser confiável para conexões criptografadas. A predefiniçã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 de @property disponíveis são impressos.

Observação

Os padrões seguros pertencem ao provedor OLEDB subjacente 19, que aumenta a segurança. A opção para 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 Distribuidor fornecida. @value é nvarchar(255), com um padrão de NULL.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

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

Examples


-- 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 subjacente 19, que aumenta a segurança. A opção para 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, consulte a variação do distribuidor remoto no SQL Server 2025.

Permissions

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

Conteúdo relacionado

  • Last updated on