Partager via


DATABASE_PRINCIPAL_ID (Transact-SQL)

Retourne le numéro d'ID d'une entité de sécurité dans la base de données active. Pour plus d'informations sur les entités de sécurité, consultez Entités de sécurité (moteur de base de données).

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

DATABASE_PRINCIPAL_ID ( 'principal_name' )

Arguments

  • principal_name
    Expression de type sysname qui représente l'entité de sécurité.

    Lorsque principal_name est omis, l'ID de l'utilisateur actuel est retourné. Les parenthèses sont obligatoires.

Types de retour

int

NULL lorsque l'entité de sécurité de la base de données n'existe pas

Notes

DATABASE_PRINCIPAL_ID peut être utilisé dans une liste de sélection, une clause WHERE ou partout où une expression est autorisée. Pour plus d'informations, consultez Expressions (Transact-SQL).

Exemples

A. Extraction de l'ID de l'utilisateur actuel

L'exemple suivant retourne l'ID d'entité de sécurité de base de données de l'utilisateur actuel.

SELECT DATABASE_PRINCIPAL_ID();
GO

B. Extraction de l'ID d'une entité de sécurité de base de données spécifique

L'exemple suivant retourne l'ID d'entité de sécurité de base de données du rôle de base de données db_owner.

SELECT DATABASE_PRINCIPAL_ID('db_owner');
GO