DATABASE_PRINCIPAL_ID (Transact-SQL)

Retorna o número de ID de um principal no banco de dados atual. Para obter mais informações sobre principais, consulte Entidades (Mecanismo de Banco de Dados).

Convenções da sintaxe Transact-SQL

Sintaxe

DATABASE_PRINCIPAL_ID ( 'principal_name' )

Argumentos

• principal_name
  É uma expressão do tipo sysname que representa o principal.

  Quando principal_name é omitido, a ID do usuário atual é retornada. Os parênteses são necessários.

Tipos de retorno

int

NULL quando a entidade de banco de dados não existe

Comentários

DATABASE_PRINCIPAL_ID pode ser usado em uma lista de seleção, cláusula WHERE ou em qualquer local em que uma expressão for permitida. Para obter mais informações, consulte Expressões (Transact-SQL).

Exemplos

A.Recuperando a ID do usuário atual

O exemplo a seguir retorna a ID de principal do banco de dados do usuário atual.

SELECT DATABASE_PRINCIPAL_ID();
GO

B.Recuperando a ID de uma entidade de segurança do banco de dados especificado

O exemplo a seguir retorna a ID de principal do banco de dados para a função de banco de dados db_owner.

SELECT DATABASE_PRINCIPAL_ID('db_owner');
GO

Consulte também

Referência

sys.database_principals (Transact-SQL)

Conceitos

Entidades (Mecanismo de Banco de Dados)

Hierarquia de permissões (Mecanismo de Banco de Dados)