sp_helpuser (Transact-SQL)sp_helpuser (Transact-SQL)

S’applique à :Applies to: oui SQL ServerSQL Server (toutes les versions prises en charge)yesSQL ServerSQL Server (all supported versions) S’applique à :Applies to: oui SQL ServerSQL Server (toutes les versions prises en charge)yesSQL ServerSQL Server (all supported versions)

Signale des informations sur les principaux de niveau base de données dans la base de données en cours.Reports information about database-level principals in the current database.

Important

sp_helpuser ne retourne pas d’informations sur les éléments sécurisables introduits dans SQL Server 2005 (9.x)SQL Server 2005 (9.x) .sp_helpuser does not return information about securables that were introduced in SQL Server 2005 (9.x)SQL Server 2005 (9.x). Utilisez à la place sys. database_principals .Use sys.database_principals instead.

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

SyntaxeSyntax

  
sp_helpuser [ [ @name_in_db = ] 'security_account' ]  

ArgumentsArguments

[ @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 actuelle.[ @name_in_db = ] 'security_account' Is the name of database user or database role in the current database. security_account doit exister dans la base de données active.security_account must exist in the current database. security_account est de type sysname, avec NULL comme valeur par défaut.security_account is sysname, with a default of NULL. Si security_account n’est pas spécifié, sp_helpuser retourne des informations sur tous les principaux de la base de données.If security_account is not specified, sp_helpuser returns information about all database principals.

Codet de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Le tableau suivant montre le jeu de résultats lorsque ni un compte d’utilisateur SQL ServerSQL Server , ni un utilisateur ou Windows n’est spécifié pour security_account.The following table shows the result set when neither a user account nor a SQL ServerSQL Server or Windows user is specified for security_account.

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
Nom d’utilisateurUserName sysnamesysname Utilisateurs dans la base de données en cours.Users in the current database.
RoleNameRoleName sysnamesysname Rôles auxquels appartient le nom d’utilisateur .Roles to which UserName belongs.
LoginNameLoginName sysnamesysname Connexion du nom d’utilisateur.Login of UserName.
DefDBNameDefDBName sysnamesysname Base de données par défaut du nom d’utilisateur.Default database of UserName.
DefSchemaNameDefSchemaName sysnamesysname Schéma par défaut de l'utilisateur de la base de données.Default schema of the database user.
IDutilisateurUserID smallintsmallint ID du nom d’utilisateur dans la base de données actuelle.ID of UserName in the current database.
SIDSID smallintsmallint Numéro d'identification de sécurité (SID) de l'utilisateur.User security identification number (SID).

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.The following table shows the result set when no user account is specified and aliases exist in the current database.

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
LoginNameLoginName sysnamesysname Connexions affectées comme alias aux utilisateurs de la base de données en cours.Logins aliased to users in the current database.
UserNameAliasedToUserNameAliasedTo sysnamesysname Nom d'utilisateur dans la base de données en cours dont la connexion est affectée comme alias.User name in the current database to which the login is aliased.

Le tableau suivant montre le jeu de résultats lorsqu’un rôle est spécifié pour security_account.The following table shows the result set when a role is specified for security_account.

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
Role_nameRole_name sysnamesysname Nom du rôle dans la base de données en cours.Name of the role in the current database.
Role_idRole_id smallintsmallint ID du rôle dans la base de données en cours.Role ID for the role in the current database.
Users_in_roleUsers_in_role sysnamesysname Membre du rôle dans la base de données en cours.Member of the role in the current database.
IDutilisateurUserid smallintsmallint ID d'utilisateur du membre du rôle.User ID for the member of the role.

RemarquesRemarks

Pour afficher des informations sur l’appartenance aux rôles de base de données, utilisez sys. database_role_members.To see information about membership of database roles, use sys.database_role_members. Pour afficher des informations sur les membres du rôle de serveur, utilisez sys. server_role_memberset pour afficher des informations sur les principaux au niveau du serveur, utilisez sys. server_principals.To see information about server role members, use sys.server_role_members, and to see information about server-level principals, use sys.server_principals.

AutorisationsPermissions

Nécessite l'appartenance au rôle public .Requires membership in the public role.

Les informations retournées sont sujettes à des restrictions d'accès aux métadonnées.Information returned is subject to restrictions on access to metadata. Les entités sur lesquelles le principal ne possède pas d'autorisation n'apparaissent pas.Entities on which the principal has no permission do not appear. Pour plus d'informations, consultez Metadata Visibility Configuration.For more information, see Metadata Visibility Configuration.

ExemplesExamples

R.A. Création de la liste de tous les utilisateursListing all users

L'exemple ci-dessous répertorie tous les utilisateurs dans la base de données en cours.The following example lists all users in the current database.

EXEC sp_helpuser;  

B.B. Création de la liste des informations sur un utilisateur uniqueListing information for a single user

Dans l'exemple ci-dessous, des informations sont répertoriées sur le propriétaire de la base de données utilisateur (dbo).The following example lists information about the user database owner (dbo).

EXEC sp_helpuser 'dbo';  

C.C. Création de la liste des informations sur un rôle de base de donnéesListing information for a database role

Dans l'exemple ci-dessous, des informations sont répertoriées sur le rôle de base de données fixe db_securityadmin.The following example lists information about the db_securityadmin fixed database role.

EXEC sp_helpuser 'db_securityadmin';  

Voir aussiSee Also

Procédures stockées de sécurité ()Transact-SQL Security Stored Procedures (Transact-SQL)
Procédures stockées système ()Transact-SQL System Stored Procedures (Transact-SQL)
Principaux (moteur de base de données) Principals (Database Engine)
sys. database_principals (Transact-SQL) sys.database_principals (Transact-SQL)
sys. database_role_members (Transact-SQL) sys.database_role_members (Transact-SQL)
sys. server_principals (Transact-SQL) sys.server_principals (Transact-SQL)
sys.server_role_members (Transact-SQL)sys.server_role_members (Transact-SQL)