Partager via


SUSER_NAME (Transact-SQL)

S’applique à : point de terminaison d’analytique SQL Server Azure SQL Managed Instance Azure Synapse Analytics (pool SQL serverless uniquement) dans Microsoft Fabric Warehouse

Retourne le nom d'identification de l'utilisateur pour la connexion.

Conventions de la syntaxe Transact-SQL

Syntaxe

SUSER_NAME ( [ server_user_id ] )

Arguments

server_user_id

Numéro d’identification de la connexion de l’utilisateur. server_user_id, facultatif, est de type int. server_user_id peut être le numéro d’identification d’une connexion SQL Server ou d’un utilisateur ou d’un groupe Windows quelconque qui a l’autorisation de se connecter à une instance SQL. Si server_user_id n’est pas spécifié, le nom d’identification de connexion de l’utilisateur actuel est renvoyé. Si le paramètre contient le mot NULL, il retourne NULL.

Type de retour

nvarchar(128)

Notes

SUSER_NAME retourne un nom de connexion seulement pour une connexion comportant une entrée dans les affichages catalogues sys.server_principals ou sys.sql_logins.

SUSER_NAME peut être utilisé dans une liste de sélection, dans une clause WHERE, et partout où une expression est autorisée. Utilisez des parenthèses après SUSER_NAME, même si aucun paramètre n’est spécifié.

Notes

Bien que la fonction SUSER_NAME soit prise en charge sur Azure SQL Database, l’utilisation d’EXECUTE AS avec SUSER_NAME n’est pas prise en charge sur Azure SQL Database.

Exemples

R. Utilisez SUSER_NAME

Dans l'exemple suivant, la procédure retourne le nom d'identification de la connexion utilisateur 1.

SELECT SUSER_NAME(1);

B. Utilisation de SUSER_NAME sans ID

Le code exemple suivant recherche le nom de l'utilisateur actuel sans spécifier un ID.

SELECT SUSER_NAME();  
GO  

Dans SQL Server, voici le jeu de résultats d’une connexion authentifiée Microsoft Entra ID :

contoso\username  

Dans Azure SQL Database et Microsoft Fabric, voici le jeu de résultats d’une connexion authentifiée Microsoft Entra ID :

username@contoso.com