SUSER_NAME (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed InstanceAzure Synapse Analytics (solo grupo de SQL sin servidor)Punto de conexión de análisis SQL en Microsoft FabricAlmacén en Microsoft Fabric

Devuelve el nombre de identificación de inicio de sesión del usuario.

Convenciones de sintaxis de Transact-SQL

Sintaxis

SUSER_NAME ( [ server_user_id ] )

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

server_user_id

El número de identificación de inicio de sesión del usuario. server_user_id, que es opcional, es de tipo int. server_user_id puede ser el número de identificación de inicio de sesión de cualquier inicio de sesión de SQL Server o de cualquier usuario o grupo de Windows que tenga permiso para conectarse a una instancia de SQL Server. Cuando no se especifica server_user_id, se devuelve el nombre de identificación de inicio de sesión para el usuario actual. Si el parámetro contiene la palabra NULL, se devuelve NULL.

Tipo de valor devuelto

nvarchar(128)

Comentarios

SUSER_NAME devuelve un nombre de un inicio de sesión que tenga una entrada en las vistas de catálogo sys.server_principals o sys.sql_logins.

Se puede utilizar SUSER_NAME en una lista de selección, en una cláusula WHERE y en cualquier lugar en el que se permita una expresión. Use paréntesis después de SUSER_NAME, aunque no se especifique ningún parámetro.

Nota

Aunque la función SUSER_NAME se admita en Azure SQL Database, no se admite el uso de Ejecutar como con SUSER_NAME en Azure SQL Database.

Ejemplos

A Uso de SUSER_NAME

En el ejemplo siguiente se devuelve el nombre de identificación de inicio de sesión del usuario con el número de identificación de inicio de sesión 1.

SELECT SUSER_NAME(1);

B. Usar SUSER_NAME sin un identificador

En el siguiente ejemplo se busca el nombre del usuario actual sin especificar un identificador.

SELECT SUSER_NAME();  
GO  

En SQL Server, este es el conjunto de resultados de un inicio de sesión autenticado de Microsoft Entra ID:

contoso\username  

En Azure SQL Database y Microsoft Fabric, este es el conjunto de resultados de un inicio de sesión autenticado de Microsoft Entra ID:

username@contoso.com