USER (Transact-SQL)

Permite um valor fornecido pelo sistema para o nome de usuário de banco de dados do usuário atual a ser inserido em uma tabela quando nenhum valor padrão é especificado.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

USER

Tipos de retorno

char

Comentários

USER fornece a mesma funcionalidade como a função de sistema USER_NAME.

Use USER com restrições DEFAULT nas instruções CREATE TABLE ou ALTER TABLE, ou use como qualquer função padrão.

USER sempre retorna o nome do contexto atual. Quando chamado depois de uma instrução EXECUTE AS, USER retorna o nome do contexto representado.

Se um principal do Windows acessar o banco de dados específico por meio da associação em um grupo, USER retornará o principal do Windows em vez do nome do grupo.

Exemplos

A. Usando USER para retornar o nome de usuário de banco de dados

O exemplo a seguir declara uma variável como char, atribui o valor atual de USER a ela e imprime a variável com uma descrição de texto.

DECLARE @usr char(30)
SET @usr = user
SELECT 'The current user''s database username is: '+ @usr
GO

Conjunto de resultados.

----------------------------------------------------------------------- 
The current user's database username is: dbo                            

(1 row(s) affected)

B. Usando USER com restrições DEFAULT

O exemplo a seguir cria uma tabela usando a restrição USER as a DEFAULT para o vendedor de uma linha de vendas.

USE AdventureWorks;
GO
CREATE TABLE inventory22
(
 part_id int IDENTITY(100, 1) NOT NULL,
 description varchar(30) NOT NULL,
 entry_person varchar(30) NOT NULL DEFAULT USER 
)
GO
INSERT inventory22 (description)
VALUES ('Red pencil')
INSERT inventory22 (description)
VALUES ('Blue pencil')
INSERT inventory22 (description)
VALUES ('Green pencil')
INSERT inventory22 (description)
VALUES ('Black pencil')
INSERT inventory22 (description)
VALUES ('Yellow pencil')
GO

Esta é a consulta para selecionar todas as informações da tabela inventory22:

SELECT * FROM inventory22 ORDER BY part_id;
GO

Este é o conjunto de resultados (observe o valor entry-person):

part_id     description                    entry_person                   
----------- ------------------------------ -------------------------
100         Red pencil                     dbo                            
101         Blue pencil                    dbo                            
102         Green pencil                   dbo                            
103         Black pencil                   dbo                            
104         Yellow pencil                  dbo                            

(5 row(s) affected)

C. Usando USER em combinação com EXECUTE AS

O exemplo a seguir ilustra o comportamento de USER quando chamado em uma sessão representada.

SELECT USER;
GO
EXECUTE AS USER = 'Mario';
GO
SELECT USER;
GO
REVERT;
GO
SELECT USER;
GO

Conjunto de resultados.

DBO
Mario
DBO