sp_helpdistributor (Transact-SQL)
Affiche des informations sur le serveur de distribution, la base de données de distribution, le répertoire de travail et le compte d'utilisateur de l'Agent Microsoft SQL Server. 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 de 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. Le serveur de distribution est de type sysname et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @distribdb=] 'distribdb' OUTPUT
Nom de la base de données de distribution. distribdb est de type sysname et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @directory=] 'directory' OUTPUT
Répertoire de travail. directory est de type nvarchar(255) et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @account=] 'account' OUTPUT
Compte d'utilisateur Windows Microsoft. account* *est de type nvarchar(255) et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @min_distretention=] min_distretentionOUTPUT
Période de rétention minimale de la distribution, en heures. min_distretention est de type int, avec -1 comme valeur par défaut.[ @max_distretention=] max_distretentionOUTPUT
Période de rétention maximale de la distribution, en heures. max_distretention est de type int, avec -1 comme valeur par défaut.[ @history_retention=] history_retentionOUTPUT
Période de conservation de l'historique, en heures. history_retention est de type int, avec -1 comme valeur par défaut.[ @history_cleanupagent=] 'history_cleanupagent' OUTPUT
Nom de l'Agent de nettoyage de l'historique. history_cleanupagent est de type nvarchar(100) et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @distrib_cleanupagent =] 'distrib_cleanupagent' OUTPUT
Nom de l'Agent de nettoyage de distribution. distrib_cleanupagent est de type nvarchar(100) et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @publisher=] 'publisher'
Nom du serveur de publication. publisher est de type sysname, avec NULL comme valeur par défaut.[ @local=] 'local'
Indique si SQL Server doit récupérer des valeurs sur le serveur local. local est de type nvarchar(5), avec NULL comme valeur par défaut.[ @rpcsrvname=] 'rpcsrvname' OUTPUT
Nom du serveur qui émet des appels de procédure à distance. rpcsrvname est de type sysname et seule sa valeur par défaut, %, retourne un ensemble de résultats.[ @publisher_type= ] 'publisher_type' OUTPUT
Type du serveur de publication. publisher_type est de type sysname et seule sa valeur par défaut, %, retourne un ensemble de résultats.
Jeux de résultats
Nom de la colonne |
Type de données |
Description |
---|---|---|
serveur de distribution |
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 de rétention de distribution maximale. |
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 |
sysname |
Connexion utilisée pour les appels de procédure à distance au serveur de distribution distant. |
publisher type |
sysname |
Type du serveur de publication pouvant être : MSSQLSERVER ORACLE ORACLE GATEWAY |
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
sp_helpdistributor est utilisé dans tous les types de réplications.
Si un ou plusieurs paramètres de sortie sont spécifiés lors de l'exécution de sp_helpdistributor, tous ceux dont la valeur est NULL se voient attribuer des valeurs à la sortie et aucun ensemble 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 de l'ensemble 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 du 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 |
none |
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 |
Voir aussi
Référence
sp_adddistpublisher (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)
Concepts
Afficher et modifier les propriétés d'un serveur de distribution ou d'un serveur de publication