SUSER_NAME (Transact-SQL)

  • Статья

Применимо к: SQL Server Управляемый экземпляр SQL Azure Azure Synapse Analytics (только бессерверный пул SQL) конечная точка аналитики SQL в хранилище Microsoft Fabric в Microsoft Fabric

Возвращает идентификационное имя учетной записи пользователя.

Соглашения о синтаксисе Transact-SQL

Синтаксис

SUSER_NAME ( [ server_user_id ] )

Аргументы

server_user_id

Идентификационный номер входа пользователя. server_user_id, который является необязательным, является int. server_user_id может быть идентификационный номер входа любого пользователя SQL Server или группы Windows, имеющего разрешение на подключение к экземпляру SQL Server. Если аргумент server_user_id не указан, возвращается идентификационное имя для входа текущего пользователя. Если параметр содержит слово NULL, возвращается NULL.

Возвращаемый тип

nvarchar(128)

Замечания

SUSER_NAME возвращает имя входа только для имени входа, имеющего запись в представлениях sys.server_principals каталога или sys.sql_logins представлениях каталога.

SUSER_NAME можно использовать в списке выбора в предложении WHERE и в любом месте, где разрешено выражение. Используйте скобки после SUSER_NAME, даже если параметр не указан.

Примечание.

SUSER_NAME Хотя функция поддерживается в База данных SQL Azure, использование EXECUTE AS с SUSER_NAME не поддерживается в База данных SQL Azure.

Примеры

А. Использование SUSER_NAME

Следующий пример иллюстрирует получение идентификационного имени учетной записи с идентификационным номером 1.

SELECT SUSER_NAME(1);

B. Использование SUSER_NAME без идентификатора

Следующий пример демонстрирует поиск имени текущего пользователя без указания его идентификатора.

SELECT SUSER_NAME();  
GO

В SQL Server ниже приведен результирующий набор для входа, прошедшего проверку подлинности идентификатора Microsoft Entra:

contoso\username

В База данных SQL Azure и Microsoft Fabric ниже приведен результирующий набор для входа, прошедшего проверку подлинности идентификатора Microsoft Entra:

username@contoso.com

Связанный контент