Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:SQL Server
Instâ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.