This topic has not yet been rated - Rate this topic

DATABASE_PRINCIPAL_ID (Transact-SQL)

SQL Server 2008 R2

Returns the ID number of a principal in the current database. For more information about principals, see Principals (Database Engine).

Topic link icon Transact-SQL Syntax Conventions

Syntax


DATABASE_PRINCIPAL_ID ( 'principal_name' )

Arguments

principal_name

Is an expression of type sysname that represents the principal.

When principal_name is omitted, the ID of the current user is returned. The parentheses are required.

Return Types

int

NULL when the database principal does not exist

Remarks

DATABASE_PRINCIPAL_ID can be used in a select list, a WHERE clause, or anywhere an expression is allowed. For more information, see Expressions (Transact-SQL).

Examples

A. Retrieving the ID of the current user

The following example returns the database principal ID of the current user.

SELECT DATABASE_PRINCIPAL_ID();
GO

B. Retrieving the ID of a specified database principal

The following example returns the database principal ID for the database role db_owner.

SELECT DATABASE_PRINCIPAL_ID('db_owner');
GO

Reference

sys.database_principals (Transact-SQL)

Concepts

Principals (Database Engine)

Permissions Hierarchy (Database Engine)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD