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 |