Partager via


sp_helpdistributor (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Répertorie des informations sur le serveur de distribution, la base de données de distribution, le répertoire de travail et le compte d’utilisateur SQL Server Agent. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication ou sur n'importe quelle base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_helpdistributor [ [ @distributor = ] 'distributor' OUTPUT ]
    [ , [ @distribdb = ] 'distribdb' OUTPUT ]
    [ , [ @directory = ] 'directory' OUTPUT ]
    [ , [ @account = ] 'account' OUTPUT ]
    [ , [ @min_distretention = ] min_distretention OUTPUT ]
    [ , [ @max_distretention = ] max_distretention OUTPUT ]
    [ , [ @history_retention = ] history_retention OUTPUT ]
    [ , [ @history_cleanupagent = ] 'history_cleanupagent' OUTPUT ]
    [ , [ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @local = ] 'local' ]
    [ , [ @rpcsrvname = ] 'rpcsrvname' OUTPUT ]
    [ , [ @publisher_type = ] 'publisher_type' OUTPUT ]
[ ; ]

Arguments

[ @distributor = ] 'distributor' OUTPUT

Nom du serveur de distribution. @distributor est sysname, avec une valeur par défaut , qui est la seule valeur qui retourne un jeu de %résultats.

[ @distribdb = ] 'distribdb' OUTPUT

Nom de la base de données de distribution. @distribdb est sysname, avec une valeur par défaut , qui est la seule valeur qui retourne un jeu de %résultats.

[ @directory = ] 'directory' OUTPUT

Répertoire de travail. @directory est nvarchar(255), avec une valeur par défaut %, qui est la seule valeur qui retourne un jeu de résultats.

[ @account = ] 'account' OUTPUT

Compte d’utilisateur Microsoft Windows. @account est nvarchar(255), avec une valeur par défaut %, qui est la seule valeur qui retourne un jeu de résultats.

[ @min_distretention = ] sortie de min_distretention

Période de rétention minimale de la distribution, en heures. @min_distretention est int, avec la valeur par défaut -1.

[ @max_distretention = ] sortie de max_distretention

Période de rétention de distribution maximale, en heures. @max_distretention est int, avec la valeur par défaut -1.

[ @history_retention = ] sortie de history_retention

Période de rétention de l’historique, en heures. @history_retention est int, avec la valeur par défaut -1.

[ @history_cleanupagent = ] SORTIE 'history_cleanupagent'

Nom de l’agent de nettoyage de l’historique. @history_cleanupagent est nvarchar(100), avec une valeur par défaut %, qui est la seule valeur qui retourne un jeu de résultats.

[ @distrib_cleanupagent = ] SORTIE 'distrib_cleanupagent'

Nom de l’agent de nettoyage de distribution. @distrib_cleanupagent est nvarchar(100), avec une valeur par défaut %, qui est la seule valeur qui retourne un jeu de résultats.

[ @publisher = ] 'publisher'

Nom du serveur de publication. @publisher est sysname, avec la valeur par défaut NULL.

[ @local = ] 'local'

Indique si SQL Server doit obtenir des valeurs de serveur local. @local est nvarchar(5), avec la valeur par défaut NULL.

[ @rpcsrvname = ] 'rpcsrvname' OUTPUT

Nom du serveur qui émet des appels de procédure distante. @rpcsrvname est sysname, avec une valeur par défaut , qui est la seule valeur qui retourne un jeu de %résultats.

[ @publisher_type = ] SORTIE 'publisher_type'

Type d’éditeur du serveur de publication. @publisher_type est sysname, avec une valeur par défaut , qui est la seule valeur qui retourne un jeu de %résultats.

Jeu de résultats

Nom de la colonne Type de données Description
distributor sysname Nom du serveur de distribution.
distribution database sysname Nom de la base de données de distribution.
directory nvarchar(255) Nom du répertoire de travail.
account nvarchar(255) Nom du compte d'utilisateur Windows.
min distrib retention int Période de rétention de distribution minimale.
max distrib retention int Période maximale de rétention de distribution.
history retention int Période de rétention de l'historique.
history cleanup agent nvarchar(100) Nom de l'Agent de nettoyage de l'historique
distribution cleanup agent nvarchar(100) Nom de l'Agent de nettoyage de distribution.
rpc server name sysname Nom du serveur de distribution local ou distant.
rpc login name sysname Connexion utilisée pour les appels de procédure à distance au serveur de distribution distant.
publisher type sysname Type de serveur de publication ; il peut s'agir d'une des valeurs suivantes :

- MSSQLSERVER
-ORACLE
- ORACLE GATEWAY

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_helpdistributor est utilisé dans tous les types de réplication.

Si un ou plusieurs paramètres de sortie sont spécifiés lors de l’exécution sp_helpdistributor, tous les paramètres de sortie définis sur NULL sont affectés à des valeurs lors de la sortie et aucun jeu de résultats n’est retourné. Si aucun paramètre de sortie n'est spécifié, un ensemble de résultats est retourné.

autorisations

Les colonnes du jeu de résultats ou les paramètres de sortie suivants sont retournés aux membres du rôle serveur fixe sysadmin sur le serveur de publication et le rôle de base de données fixe db_owner sur la base de données de publication :

Colonne de l'ensemble de résultats Paramètre de sortie
account @account
min distrib retention @min_distretention
max distrib retention @max_distretention
history retention @history_retention
history cleanup agent @history_cleanupagent
distribution cleanup agent @distrib_cleanupagent
rpc login name Aucune

La colonne de l'ensemble de résultats suivante est retournée aux utilisateurs dans la liste d'accès aux publications sur le serveur de distribution :

  • directory

Les colonnes de l'ensemble de résultats suivantes sont retournées à tous les utilisateurs.

Colonne de l'ensemble de résultats Paramètre de sortie
distributor @distributor
distribution database @distribdb
rpc server name @rpcsrvname
publisher type @publisher_type