sp_helpuser (Transact-SQL)

Article
12/15/2008

Mis à jour : 14 avril 2006

Signale des informations sur les entités de sécurité de niveau base de données dans la base de données en cours.

Important :
sp_helpuser ne retourne pas d'information sur les sécurisables introduits dans SQL Server 2005. Utilisez sys.database_principals à la place.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_helpuser [ [ @name_in_db = ] 'security_account' ]

Arguments

[ @name_in_db = ] 'security_account'
Nom de l'utilisateur de base de données ou du rôle de base de données dans la base de données en cours. security_account doit exister dans la base de données en cours. security_account est de type sysname, avec la valeur par défaut NULL. Si security_account n'est pas spécifié, sp_helpuser retourne des informations sur toutes les entités de sécurité de base de données.

Notes

Pour consulter des informations sur l'appartenance des rôles de base de données, utilisez sys.database_role_members. Pour consulter des informations sur les membres des rôles de serveur, utilisez sys.server_role_members. Pour consulter des informations sur les entités de sécurité au niveau serveur, utilisez sys.server_principals.

Exécuter sp_helpuser pour un rôle de base de données équivaut à exécuter sp_helpgroup pour ce rôle de base de données.

Autorisations

Nécessite l'appartenance au rôle public.

Les informations retournées sont sujettes à des restrictions d'accès aux métadonnées. Les entités sur lesquelles l'entité de sécurité ne possède pas d'autorisations n'apparaissent pas. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées.

Valeurs de code retournées

0 (succès) ou 1 (échec)

Ensembles de résultats

Le tableau ci-dessous indique l'ensemble de résultats obtenu, lorsqu'aucun compte d'utilisateur et aucun utilisateur SQL Server ni Windows n'est spécifié pour security_account.

Nom de colonne	Type de données	Description
UserName	sysname	Utilisateurs dans la base de données en cours.
GroupName	sysname	Rôles auxquels appartient UserName.
LoginName	sysname	Connexion de UserName.
DefDBName	sysname	Base de données par défaut de UserName.
DefSchemaName	sysname	Schéma par défaut de l'utilisateur de la base de données.
UserID	smallint	ID de UserName dans la base de données en cours.
SID	smallint	Numéro d'identification de sécurité (SID) de l'utilisateur.

Le tableau ci-dessous indique l'ensemble de résultats obtenu, lorsqu'aucun compte d'utilisateur n'est spécifié et que des alias existent dans la base de données en cours.

Nom de colonne	Type de données	Description
LoginName	sysname	Connexions affectées comme alias aux utilisateurs de la base de données en cours.
UserNameAliasedTo	sysname	Nom d'utilisateur dans la base de données en cours dont la connexion est affectée comme alias.

Le tableau ci-dessous indique l'ensemble de résultats obtenu lorsqu'un rôle est spécifié pour security_account.

Nom de colonne	Type de données	Description
Group_name	sysname	Nom du rôle dans la base de données en cours
Group_id	smallint	ID du rôle dans la base de données en cours.
Users_in_group	sysname	Membre du rôle dans la base de données en cours.
Userid	smallint	ID d'utilisateur du membre du rôle.

Exemples

A. Répertorier tous les utilisateurs

L'exemple ci-dessous répertorie tous les utilisateurs dans la base de données en cours.

EXEC sp_helpuser

B. Répertorier des informations sur un utilisateur unique

Dans l'exemple ci-dessous, des informations sont répertoriées sur le propriétaire de la base de données utilisateur (dbo).

EXEC sp_helpuser 'dbo'

C. Répertorier des informations sur un rôle de base de données

Dans l'exemple ci-dessous, des informations sont répertoriées sur le rôle de base de données fixe db_securityadmin.

EXEC sp_helpuser 'db_securityadmin'

Voir aussi

Historique des modifications

Version	Historique
14 avril 2006	Nouveau contenu : Ajout de la colonne DefSchemaName