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 Microsoft Windows. accountest 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. Sa valeur par défaut est NULL.

• [ @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 d'éditeur de l'Éditeur. publisher_type est de type sysname et seule sa valeur par défaut, %, retourne un ensemble de résultats.

Ensembles de résultats

Nom de 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 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

Tâches

Procédure : afficher et modifier les propriétés du serveur de publication et du serveur de distribution (programmation Transact-SQL de la réplication)

Référence

sp_adddistpublisher (Transact-SQL)

sp_dropdistpublisher (Transact-SQL)