sp_helpuser (Transact-SQL)

Article
08/20/2013

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

Important

sp_helpuser ne retourne pas d'information sur les éléments 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 actuelle. security_account est de type sysname, avec NULL comme valeur par défaut. Si security_account n'est pas spécifié, sp_helpuser retourne des informations sur tous les principaux de base de donné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.
RoleName	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
Role_name	sysname	Nom du rôle dans la base de données en cours.
Role_id	smallint	ID du rôle dans la base de données en cours.
Users_in_role	sysname	Membre du rôle dans la base de données en cours.
Userid	smallint	ID d'utilisateur du membre du rôle.

Notes

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

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 le principal ne possède pas d'autorisations n'apparaissent pas. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées.