Condividi tramite

sp_changedistributor_property (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

Modifica le proprietà del server di distribuzione. Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione. Per i server di distribuzione remoti, questa stored procedure deve essere eseguita in tutti i server di pubblicazione che si connettono al server di distribuzione remoto.

Se il database di distribuzione o server di pubblicazione si trova in un gruppo di disponibilità, la stored procedure deve essere eseguita in tutti i nodi del server di distribuzione e del server di pubblicazione, indipendentemente dal ruolo corrente nel gruppo di disponibilità.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @property = ] N'property'

Proprietà per un server di distribuzione specificato. @property è sysname e può essere uno di questi valori:

Nome della proprietà Valori accettabili Descrizione
heartbeat_interval Qualsiasi valore int (in minuti) Periodo massimo in minuti durante il quale un agente può essere eseguito senza registrare alcun messaggio di stato. @heartbeat_interval è int, con un valore predefinito di 10 minuti.
encrypt_distributor_connection mandatory, optional, strict, truefalse, , yesno Specifica il tipo di crittografia tra il server di distribuzione e altri componenti di replica.

Si applica a: SQL Server 2025 (17.x) e versioni successive.
trust_distributor_certificate yes, no Specifica se considerare attendibile il certificato utilizzato dal server di distribuzione per le connessioni crittografate. Il valore predefinito è no.

Si applica a: SQL Server 2025 (17.x) e versioni successive.
host_name_in_distributor_certificate Qualsiasi stringa Specifica il nome host previsto nel certificato del server di distribuzione.

Si applica a: SQL Server 2025 (17.x) e versioni successive.
NULL (predefinito) Vengono stampati tutti i valori @property disponibili.

Annotazioni

Le impostazioni predefinite sicure riguardano il provider OLEDB 19 sottostante, che migliora la sicurezza. L'opzione per eseguire l'override del valore predefinito è meno sicura rispetto alla configurazione dell'istanza per l'uso di un certificato attendibile. Dopo l'override dell'impostazione predefinita, è possibile configurare SQL Server per l'uso di un certificato e quindi usare la stored procedure sp_changedistributor_property per ripristinare l'impostazione trust_distributor_certificate=no predefinita sicura della proprietà.

[ @value = ] N'value'

Valore per la proprietà del server di distribuzione specificata. @value è nvarchar(255), con il valore predefinito NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_changedistributor_property viene usato in tutti i tipi di replica.

Esempi


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

Configurare il server di distribuzione in modo che consideri attendibile il certificato autofirmato

Per eseguire l'override dell'impostazione predefinita sicura del provider OLEDB 19 e impostare trust_distributor_certificate=yes in modo che il server di distribuzione consideri attendibile il certificato autofirmato, usare l'esempio seguente:

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

Annotazioni

Le impostazioni predefinite sicure riguardano il provider OLEDB 19 sottostante, che migliora la sicurezza. L'opzione per eseguire l'override del valore predefinito è meno sicura rispetto alla configurazione dell'istanza per l'uso di un certificato attendibile. Dopo l'override dell'impostazione predefinita, è possibile configurare SQL Server per l'uso di un certificato e quindi usare la stored procedure sp_changedistributor_property per ripristinare l'impostazione trust_distributor_certificate=no predefinita sicura della proprietà.

Per maggiori informazioni, consulta la novità del distributore remoto in SQL Server 2025.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_changedistributor_property.

Contenuto correlato

  • Last updated on