Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
SQL ServerAzure SQL Managed Instance
Modifie les propriétés du serveur de distribution. Cette procédure stockée est exécutée sur le serveur de distribution sur n’importe quelle base de données. Pour les serveurs de distribution distants, cette procédure stockée doit être exécutée sur tous les serveurs de publication qui se connectent au serveur de distribution distant.
Si la base de données de distribution ou de serveur de publication se trouve dans un groupe de disponibilité, la procédure stockée doit être exécutée sur tous les nœuds serveurs de distribution et serveur de publication, quel que soit leur rôle actuel dans le groupe de disponibilité.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_changedistributor_property
[ [ @property = ] N'property' ]
[ , [ @value = ] N'value' ]
[ ; ]
Arguments
[ @property = ] N’property'
Propriété d’un serveur de distribution donné. @property est sysname et peut être l’une des valeurs suivantes :
| Nom de la propriété | Valeurs acceptables | Description |
|---|---|---|
heartbeat_interval |
Toute valeur int (en minutes) | Nombre maximal de minutes pendant lesquelles un agent peut s'exécuter sans enregistrer de message de progression.
@heartbeat_interval est int, avec une valeur par défaut de 10 minutes. |
encrypt_distributor_connection |
mandatory, optional, , stricttrue, false, , yes,no |
Spécifie le type de chiffrement entre le serveur de distribution et d’autres composants de réplication. S’applique à : SQL Server 2025 (17.x) et versions ultérieures. |
trust_distributor_certificate |
yes, no |
Spécifie s’il faut approuver le certificat utilisé par le serveur de distribution pour les connexions chiffrées. La valeur par défaut est no.S’applique à : SQL Server 2025 (17.x) et versions ultérieures. |
host_name_in_distributor_certificate |
N’importe quelle chaîne | Spécifie le nom d’hôte attendu dans le certificat du serveur de distribution. S’applique à : SQL Server 2025 (17.x) et versions ultérieures. |
NULL (valeur par défaut) |
Toutes les valeurs de @property disponibles sont imprimées. |
Note
Les valeurs par défaut sécurisées se rapportent au fournisseur OLEDB sous-jacent 19, ce qui améliore la sécurité. L’option de remplacement de la valeur par défaut est moins sécurisée que la configuration de votre instance pour utiliser un certificat approuvé. Après avoir remplacé la valeur par défaut, vous avez la possibilité de configurer SQL Server pour utiliser un certificat, puis d’utiliser la procédure stockée sp_changedistributor_property pour définir la trust_distributor_certificate=no propriété sur la valeur par défaut sécurisée.
[ @value = ] N’value'
Valeur de la propriété de distribution donnée.
@value est nvarchar(255), avec la valeur par défaut NULL.
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Notes
sp_changedistributor_property est utilisé dans tous les types de réplication.
Exemples
-- Change the heartbeat interval at the Distributor to 5 minutes.
USE master
exec sp_changedistributor_property
@property = N'heartbeat_interval',
@value = 5;
GO
Configurer le serveur de distribution pour approuver le certificat auto-signé
Pour remplacer la valeur par défaut sécurisée du fournisseur OLEDB 19 et définir trust_distributor_certificate=yes afin que le serveur de distribution approuve le certificat auto-signé, utilisez l’exemple suivant :
EXECUTE sp_changedistributor_property
@property = N'trust_distributor_certificate',
@value = N'yes';
Note
Les valeurs par défaut sécurisées se rapportent au fournisseur OLEDB sous-jacent 19, ce qui améliore la sécurité. L’option de remplacement de la valeur par défaut est moins sécurisée que la configuration de votre instance pour utiliser un certificat approuvé. Après avoir remplacé la valeur par défaut, vous avez la possibilité de configurer SQL Server pour utiliser un certificat, puis d’utiliser la procédure stockée sp_changedistributor_property pour définir la trust_distributor_certificate=no propriété sur la valeur par défaut sécurisée.
Pour plus d’informations, consultez le changement de réaction du distributeur distant dans SQL Server 2025.
autorisations
Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_changedistributor_property