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 MicrosoftSQL 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.

Icône Lien de rubriqueConventions 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