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