DATABASE_PRINCIPAL_ID (Transact-SQL)DATABASE_PRINCIPAL_ID (Transact-SQL)

SE APLICA A: síSQL Server (a partir de 2008) síAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Esta función devuelve el número de Id. de una entidad de seguridad de la base de datos actual.This function returns the ID number of a principal in the current database. Vea Entidades de seguridad (motor de base de datos) para obtener más información sobre las entidades de seguridad.See Principals (Database Engine) for more information about principals.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

DATABASE_PRINCIPAL_ID ( 'principal_name' )  

ArgumentosArguments

principal_nameprincipal_name
Una expresión de tipo sysname que representa la entidad de seguridad.An expression of type sysname, that represents the principal. Si se omite principal_name, DATABASE_PRINCIPAL_ID devuelve el identificador del usuario actual.When principal_name is omitted, DATABASE_PRINCIPAL_ID returns the ID of the current user. DATABASE_PRINCIPAL_ID requiere los paréntesis.DATABASE_PRINCIPAL_ID requires the parentheses.

Tipos de valores devueltosReturn types

intint
NULL si la entidad de seguridad de base de datos no existe.NULL if the database principal does not exist.

NotasRemarks

Use DATABASE_PRINCIPAL_ID en una lista de selección, en una cláusula WHERE o en cualquier lugar que permita una expresión.Use DATABASE_PRINCIPAL_ID in a select list, a WHERE clause, or any place that allows an expression. Para más información, vea Expresiones (Transact-SQL).See Expressions (Transact-SQL) for more information.

EjemplosExamples

A.A. Recuperar el Id. del usuario actualRetrieving the ID of the current user

En este ejemplo se devuelve el identificador de la entidad de seguridad de base de datos del usuario actual.This example returns the database principal ID of the current user.

SELECT DATABASE_PRINCIPAL_ID();  
GO  

B.B. Recuperar el Id. de la entidad de seguridad de base de datos especificadaRetrieving the ID of a specified database principal

En este ejemplo se devuelve el identificador de la entidad de seguridad de base de datos del rol de base de datos db_owner.This example returns the database principal ID for the database role db_owner.

SELECT DATABASE_PRINCIPAL_ID('db_owner');  
GO  

Vea tambiénSee also

Entidades de seguridad (motor de base de datos)Principals (Database Engine)
Jerarquía de permisos (motor de base de datos)Permissions Hierarchy (Database Engine)
sys.database_principals (Transact-SQL)sys.database_principals (Transact-SQL)