SUSER_NAME (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed InstanceAzure Synapse Analytics (hanya kumpulan SQL tanpa server)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric

Mengembalikan nama identifikasi masuk pengguna.

Konvensi sintaks transact-SQL

Sintaksis

SUSER_NAME ( [ server_user_id ] )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

server_user_id

Nomor identifikasi login pengguna. server_user_id, yang bersifat opsional, adalah int. server_user_id dapat berupa nomor identifikasi masuk dari setiap login SQL Server atau pengguna atau grup Windows yang memiliki izin untuk menyambungkan ke instans SQL Server. Ketika server_user_id tidak ditentukan, nama identifikasi masuk untuk pengguna saat ini dikembalikan. Jika parameter berisi kata NULL, parameter akan mengembalikan NULL.

Jenis Pengembalian

nvarchar(128)

Keterangan

SUSER_NAME mengembalikan nama login hanya untuk login yang memiliki entri dalam sys.server_principals tampilan katalog atau sys.sql_logins .

SUSER_NAME dapat digunakan dalam daftar pilih, dalam klausa WHERE, dan di mana saja ekspresi diizinkan. Gunakan tanda kurung setelah SUSER_NAME, bahkan jika tidak ada parameter yang ditentukan.

Catatan

SUSER_NAME Meskipun fungsi ini didukung di Azure SQL Database, menggunakan EXECUTE AS dengan SUSER_NAME tidak didukung di Azure SQL Database.

Contoh

J. Gunakan SUSER_NAME

Contoh berikut mengembalikan nama identifikasi login pengguna dengan nomor identifikasi login .1

SELECT SUSER_NAME(1);

B. Menggunakan SUSER_NAME tanpa ID

Contoh berikut menemukan nama pengguna saat ini tanpa menentukan ID.

SELECT SUSER_NAME();  
GO  

Di SQL Server, berikut adalah hasil yang ditetapkan untuk login terautentikasi ID Entra Microsoft:

contoso\username  

Di Azure SQL Database dan Microsoft Fabric, berikut adalah hasil yang ditetapkan untuk login terautentikasi ID Microsoft Entra:

username@contoso.com