sp_helpuser (Transact-SQL)

  • Article

S’applique à :SQL Server

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’informations sur les éléments sécurisables introduits dans SQL Server 2005 (9.x). Utilisez sys.database_principals à la place.

Conventions de la syntaxe 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 actuelle. security_account doit exister dans la base de données active. security_account est sysname, avec la valeur par défaut NULL. Si security_account n’est pas spécifié, sp_helpuser retourne des informations sur tous les principaux de base de données.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Le tableau suivant montre le jeu de résultats quand ni un compte d’utilisateur, ni un SQL Server ou un utilisateur Windows n’est spécifié pour security_account.

Nom de la colonne Type de données Description
UserName sysname Utilisateurs dans la base de données en cours.
RoleName sysname Rôles auxquels UserName appartient.
LoginName sysname Connexion de UserName.
DefDBName sysname Base de données par défaut userName.
DefSchemaName sysname Schéma par défaut de l'utilisateur de la base de données.
l'UserId smallint ID de UserName dans la base de données active.
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 la 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 suivant montre le jeu de résultats lorsqu’un rôle est spécifié pour security_account.

Nom de la 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.

Remarques

Pour afficher des informations sur l’appartenance aux rôles de base de données, utilisez sys.database_role_members. Pour afficher des informations sur les membres de rôle serveur, utilisez sys.server_role_members et pour afficher des informations sur les principaux au niveau du 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'autorisation n'apparaissent pas. Pour plus d'informations, consultez Metadata Visibility Configuration.

Exemples

R. Création de la liste de tous les utilisateurs

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

EXEC sp_helpuser;

B. Création de la liste 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. Création de la liste 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

Procédures stockées liées à la sécurité (Transact-SQL)
Procédures stockées système (Transact-SQL)
Principaux (moteur de base de données)
sys.database_principals (Transact-SQL)
sys.database_role_members (Transact-SQL)
sys.server_principals (Transact-SQL)
sys.server_role_members (Transact-SQL)