sp_helpdistributor (Transact-SQL)sp_helpdistributor (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Répertorie des informations sur le serveur de distribution, la base de MicrosoftMicrosoft données de distribution, le répertoire de travail et SQL ServerSQL Server le compte d’utilisateur de l’agent.Lists information about the Distributor, distribution database, working directory, and MicrosoftMicrosoft SQL ServerSQL Server Agent user account. 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.This stored procedure is executed at the Publisher on the publication database or any database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
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 ]  

ArgumentsArguments

[ @distributor = ] 'distributor' OUTPUTNom du serveur de distribution.[ @distributor = ] 'distributor' OUTPUT Is the name of the Distributor. Distributor est de % type sysname, avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.Distributor is sysname, with a default of %, which is the only value that returns a result set.

[ @distribdb = ] 'distribdb' OUTPUTNom de la base de données de distribution.[ @distribdb = ] 'distribdb' OUTPUT Is the name of the distribution database. distribdb est de % type sysname, avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.distribdb is sysname, with a default of %, which is the only value that returns a result set.

[ @directory = ] 'directory' OUTPUTEst le répertoire de travail.[ @directory = ] 'directory' OUTPUT Is the working directory. Directory est de % type nvarchar (255) , avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.directory is nvarchar(255), with a default of %, which is the only value that returns a result set.

[ @account = ] 'account' OUTPUTEst le MicrosoftMicrosoft compte d’utilisateur Windows.[ @account = ] 'account' OUTPUT Is the MicrosoftMicrosoft Windows user account. Accountest de % type nvarchar (255) , avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.accountis nvarchar(255), with a default of %, which is the only value that returns a result set.

[ @min_distretention = ] _min_distretentionOUTPUTPériode de rétention minimale de la distribution, en heures.[ @min_distretention = ] _min_distretentionOUTPUT Is the minimum distribution retention period, in hours. min_distretention est de type int, avec -1comme valeur par défaut.min_distretention is int, with a default of -1.

[ @max_distretention = ] _max_distretentionOUTPUTPériode de rétention maximale de la distribution, en heures.[ @max_distretention = ] _max_distretentionOUTPUT Is the maximum distribution retention period, in hours. max_distretention est de type int, avec -1comme valeur par défaut.max_distretention is int, with a default of -1.

[ @history_retention = ] _history_retentionOUTPUTPériode de rétention de l’historique, en heures.[ @history_retention = ] _history_retentionOUTPUT Is the history retention period, in hours. history_retention est de type int, avec -1comme valeur par défaut.history_retention is int, with a default of -1.

[ @history_cleanupagent = ] 'history_cleanupagent' OUTPUTNom de l’agent de nettoyage de l’historique.[ @history_cleanupagent = ] 'history_cleanupagent' OUTPUT Is the name of the history cleanup agent. history_cleanupagent est de % type nvarchar (100) , avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.history_cleanupagent is nvarchar(100), with a default of %, which is the only value that returns a result set.

[ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUTNom de l’agent de nettoyage de distribution.[ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT Is the name of the distribution cleanup agent. distrib_cleanupagent est de % type nvarchar (100) , avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.distrib_cleanupagent is nvarchar(100), with a default of %, which is the only value that returns a result set.

[ @publisher = ] 'publisher'Nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

[ @local = ] 'local'Indique si SQL ServerSQL Server doit récupérer les valeurs du serveur local.[ @local = ] 'local' Is whether SQL ServerSQL Server should get local server values. local est de type nvarchar (5) , avec NULL comme valeur par défaut.local is nvarchar(5), with a default of NULL.

[ @rpcsrvname = ] 'rpcsrvname' OUTPUTNom du serveur qui émet des appels de procédure distante.[ @rpcsrvname = ] 'rpcsrvname' OUTPUT Is the name of the server that issues remote procedure calls. rpcsrvname est de % type sysname, avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.rpcsrvname is sysname, with a default of %, which is the only value that returns a result set.

[ @publisher_type = ] 'publisher_type' OUTPUTType de serveur de publication du serveur de publication.[ @publisher_type = ] 'publisher_type' OUTPUT Is the publisher type of the Publisher. publisher_type est de % type sysname, avec la valeur par défaut, qui est la seule valeur qui retourne un jeu de résultats.publisher_type is sysname, with a default of %, which is the only value that returns a result set.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
distributordistributor sysnamesysname Nom du serveur de distribution.Name of the Distributor.
base de données de distributiondistribution database sysnamesysname Nom de la base de données de distribution.Name of the distribution database.
directorydirectory nvarchar(255)nvarchar(255) Nom du répertoire de travail.Name of the working directory.
accountaccount nvarchar(255)nvarchar(255) Nom du compte d'utilisateur Windows.Name of the Windows user account.
rétention de la distrib min.min distrib retention Intint Période de rétention de distribution minimale.Minimum distribution retention period.
rétention maximale des détrib.max distrib retention intint Période maximale de rétention de distribution.Maximum distribution retention period.
rétention de l’historiquehistory retention intint Période de rétention de l'historique.History retention period.
agent de nettoyage de l’historiquehistory cleanup agent nvarchar(100)nvarchar(100) Nom de l'Agent de nettoyage de l'historiqueName of the History Cleanup Agent.
agent de nettoyage de distributiondistribution cleanup agent nvarchar(100)nvarchar(100) Nom de l'Agent de nettoyage de distribution.Name of the Distribution Cleanup Agent.
nom du serveur RPCrpc server name sysnamesysname Nom du serveur de distribution local ou distant.Name of the remote or local Distributor.
nom de connexion RPCrpc login name sysnamesysname Connexion utilisée pour les appels de procédure à distance au serveur de distribution distant.Login used for remote procedure calls to the remote Distributor.
type de serveur de publicationpublisher type sysnamesysname Type de serveur de publication ; il peut s'agir d'une des valeurs suivantes :Type of Publisher; can be one of the following:

MSSQLSERVERMSSQLSERVER

SOLUTIONORACLE

PASSERELLE ORACLEORACLE GATEWAY

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helpdistributor est utilisé dans tous les types de réplications.sp_helpdistributor is used in all types of replication.

Si un ou plusieurs paramètres de sortie sont spécifiés lors de l’exécution de sp_helpdistributor, tous les paramètres de sortie ayant la valeur NULL sont affectés à la sortie et aucun jeu de résultats n’est retourné.If one or more output parameters are specified when executing sp_helpdistributor, all output parameters set to NULL are assigned values on exit and no result set is returned. Si aucun paramètre de sortie n'est spécifié, un ensemble de résultats est retourné.If no output parameters are specified, a result set is returned.

AutorisationsPermissions

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 :The following result set columns or output parameters are returned to members of the sysadmin fixed server role at the Publisher and the db_owner fixed database role on the publication database:

Colonne de l'ensemble de résultatsResult set column Paramètre de sortieOutput parameter
accountaccount @compte@account
min distrib retentionmin distrib retention @min_distretention@min_distretention
max distrib retentionmax distrib retention @max_distretention@max_distretention
history retentionhistory retention @history_retention@history_retention
history cleanup agenthistory cleanup agent @history_cleanupagent@history_cleanupagent
distribution cleanup agentdistribution cleanup agent @distrib_cleanupagent@distrib_cleanupagent
rpc login namerpc login name nonenone

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 :The following result set column is returned to users in the publication access list for a publication at the Distributor:

  • directorydirectory

Les colonnes de l'ensemble de résultats suivantes sont retournées à tous les utilisateurs.The following result set columns are returned to all users.

Colonne de l'ensemble de résultatsResult set column Paramètre de sortieOutput parameter
distributordistributor @conseiller@distributor
distribution databasedistribution database @distribdb@distribdb
rpc server namerpc server name @rpcsrvname@rpcsrvname
publisher typepublisher type @publisher_type@publisher_type

Voir aussiSee Also

Afficher et modifier les propriétés d’un serveur de distribution et d’un serveur de publication View and Modify Distributor and Publisher Properties
sp_adddistpublisher (Transact-SQL) sp_adddistpublisher (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)sp_dropdistpublisher (Transact-SQL)