Partilhar via


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).

Ícone de vínculo de tópicoConvenções de 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 um principal de 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