SUSER_NAME (Transact-SQL)
Aplicável a:SQL ServerInstância Gerenciada de SQL do AzureAzure Synapse Analytics (somente pool de SQL sem servidor)Ponto de extremidade de análise do SQL no Microsoft FabricWarehouse no Microsoft Fabric
Retorna o nome de identificação de logon do usuário.
Convenções de sintaxe de Transact-SQL
Sintaxe
SUSER_NAME ( [ server_user_id ] )
Observação
Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.
Argumentos
server_user_id
O número de identificação de logon do usuário. server_user_id, que é opcional, é int. server_user_id pode ser o número de identificação de logon de qualquer logon do SQL Server ou usuário/grupo do Windows que tenha permissão para se conectar a uma instância do SQL Server. Quando server_user_id não for especificado, o nome de identificação de logon do usuário atual será retornado. Se o parâmetro contiver a palavra NULL
, ele retornará NULL
.
Tipo de retorno
nvarchar(128)
Comentários
SUSER_NAME
retorna um nome de login somente para um login que tenha uma entrada nas exibições de catálogo sys.server_principals
ou sys.sql_logins
.
SUSER_NAME
pode ser usado em uma lista de seleção, em uma cláusula WHERE ou em qualquer local em que uma expressão seja permitida. Use parênteses após SUSER_NAME
, mesmo se nenhum parâmetro for especificado.
Observação
Embora a função SUSER_NAME
tenha suporte no Banco de Dados SQL do Azure, não há suporte para o uso de EXECUTE AS com SUSER_NAME
no Banco de Dados SQL do Azure.
Exemplos
R. Usar SUSER_NAME
O exemplo a seguir retorna o nome de identificação de logon do usuário com um número de identificação de logon de 1
.
SELECT SUSER_NAME(1);
B. Usar SUSER_NAME sem um ID
O exemplo a seguir localiza o nome do usuário atual sem especificar um ID.
SELECT SUSER_NAME();
GO
No SQL Server, este é o conjunto de resultados para um login autenticado do Microsoft Entra ID:
contoso\username
No Banco de Dados SQL do Azure e no Microsoft Fabric, este é o conjunto de resultados para um login autenticado pelo Microsoft Entra ID:
username@contoso.com
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de