SUSER_NAME(Transact-SQL)

적용 대상: Microsoft Fabric의 Microsoft FabricWarehouse에 있는 SQL ServerAzure SQL Managed InstanceAzure Synapse Analytics(서버리스 SQL 풀에만 해당)SQL 분석 엔드포인트

사용자의 로그인 ID 이름을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

SUSER_NAME ( [ server_user_id ] )

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

server_user_id

사용자의 로그인 ID입니다. server_user_id는 선택 사항이며 int입니다. server_user_id는 SQL Server 인스턴스에 연결할 수 있는 권한을 가진 SQL Server 로그인 또는 Windows 사용자나 그룹의 로그인 ID 번호일 수 있습니다. server_user_id가 지정되지 않은 경우 현재 사용자에 대한 로그인 ID 이름이 반환됩니다. 매개 변수에 단어가 NULLNULL포함되어 있으면 .

반환 형식

nvarchar(128)

설명

SUSER_NAME 는 또는 카탈로그 뷰에 항목이 있는 로그인에 sys.server_principalssys.sql_logins 대해서만 로그인 이름을 반환합니다.

SUSER_NAME는 SELECT 목록, WHERE 절 및 식을 사용할 수 있는 곳이면 어디에서나 사용할 수 있습니다. 매개 변수를 지정하지 않더라도 SUSER_NAME 뒤에 괄호를 사용합니다.

참고

SUSER_NAME 함수는 Azure SQL Database에서 지원되지만, Azure SQL Database에서 SUSER_NAME과 함께 EXECUTE AS를 사용할 수는 없습니다.

예제

A. SUSER_NAME 사용

다음 예에서는 로그인 ID가 1인 사용자의 로그인 ID 이름을 반환합니다.

SELECT SUSER_NAME(1);

B. ID 없이 SUSER_NAME 사용

다음 예에서는 ID를 지정하지 않고 현재 사용자의 이름을 찾습니다.

SELECT SUSER_NAME();  
GO  

SQL Server에서 Microsoft Entra ID 인증 로그인에 대한 결과 집합은 다음과 같습니다.

contoso\username  

Azure SQL Database 및 Microsoft Fabric에서 Microsoft Entra ID 인증 로그인에 대한 결과 집합은 다음과 같습니다.

username@contoso.com