Compartilhar 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ópico 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)