SUSER_SID (T-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Mengembalikan nomor identifikasi keamanan (SID) untuk nama masuk yang ditentukan.

Konvensi sintaks transact-SQL

Sintaksis

SUSER_SID ( [ 'login' ] [ , Param2 ] )   

Catatan

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

Argumen

'login'
Berlaku untuk: SQL Server 2008 (10.0.x) dan yang lebih baru

Adalah nama login pengguna. login adalah sysname. login, yang bersifat opsional, dapat berupa login SQL Server atau pengguna atau grup Microsoft Windows. Jika login tidak ditentukan, informasi tentang konteks keamanan saat ini dikembalikan. Jika parameter berisi kata NULL akan mengembalikan NULL.

Param2
Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru

Menentukan apakah nama masuk divalidasi. Param2 berjenis int dan bersifat opsional. Ketika Param2 adalah 0, nama login tidak divalidasi. Ketika Param2 tidak ditentukan sebagai 0, nama login Windows diverifikasi persis sama dengan nama masuk yang disimpan di SQL Server.

Jenis Kembalian

varbinary(85)

Keterangan

SUSER_SID dapat digunakan sebagai batasan DEFAULT di ALTER TABLE atau CREATE TABLE. SUSER_SID dapat digunakan dalam daftar pilih, dalam klausa WHERE, dan di mana saja ekspresi diizinkan. SUSER_SID harus selalu diikuti oleh tanda kurung, meskipun tidak ada parameter yang ditentukan.

Saat dipanggil tanpa argumen, SUSER_SID mengembalikan SID dari konteks keamanan saat ini. Saat dipanggil tanpa argumen dalam batch yang telah beralih konteks dengan menggunakan EXECUTE AS, SUSER_SID mengembalikan SID dari konteks yang ditiru. Ketika dipanggil dari konteks yang ditiru, SUSER_SID(ORIGINAL_LOGIN()) mengembalikan SID konteks asli.

Ketika kolase SQL Server dan kolase Windows berbeda, SUSER_SID dapat gagal ketika SQL Server dan Windows menyimpan login dalam format yang berbeda. Misalnya, jika Komputer Windows TestComputer memiliki Pengguna login dan SQL Server menyimpan login sebagai TESTCOMPUTER\User, pencarian TestComputer\User login mungkin gagal menyelesaikan nama login dengan benar. Untuk melewati validasi nama masuk ini, gunakan Param2. Kolase yang berbeda sering menjadi penyebab kesalahan SQL Server 15401:

Windows NT user or group '%s' not found. Check the name again.

Keterangan Azure SQL Database

SUSER_SID selalu mengembalikan SID login untuk konteks keamanan saat ini. Gunakan sys.database_principals untuk mendapatkan SID dari login yang berbeda.

Pernyataan SUSER_SID tidak mendukung eksekusi menggunakan konteks keamanan yang ditiru melalui EXECUTE AS.

Contoh

J. Menggunakan SUSER_SID

Contoh berikut mengembalikan nomor identifikasi keamanan (SID) untuk konteks keamanan saat ini.

SELECT SUSER_SID();  

B. Menggunakan SUSER_SID dengan login tertentu

Contoh berikut mengembalikan nomor identifikasi keamanan untuk login SQL Server sa .

Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru

SELECT SUSER_SID('sa');  
GO  

C. Menggunakan SUSER_SID dengan nama pengguna Windows

Contoh berikut mengembalikan nomor identifikasi keamanan untuk pengguna London\Workstation1Windows .

Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru

SELECT SUSER_SID('London\Workstation1');  
GO  

D. Menggunakan SUSER_SID sebagai batasan DEFAULT

Contoh berikut menggunakan SUSER_SID sebagai DEFAULT batasan dalam pernyataan CREATE TABLE .

USE AdventureWorks2022;  
GO  
CREATE TABLE sid_example  
(  
login_sid   VARBINARY(85) DEFAULT SUSER_SID(),  
login_name  VARCHAR(30) DEFAULT SYSTEM_USER,  
login_dept  VARCHAR(10) DEFAULT 'SALES',  
login_date  DATETIME DEFAULT GETDATE()  
);   
GO  
INSERT sid_example DEFAULT VALUES;  
GO  

E. Membandingkan nama masuk Windows dengan nama masuk yang disimpan di SQL Server

Contoh berikut menunjukkan cara menggunakan Param2 untuk mendapatkan SID dari Windows dan menggunakan SID tersebut sebagai input ke SUSER_SNAME fungsi. Contoh menyediakan login dalam format di mana ia disimpan di Windows (TestComputer\User), dan mengembalikan login dalam format di mana ia disimpan di SQL Server (TESTCOMPUTER\User).

Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru

SELECT SUSER_SNAME(SUSER_SID('TestComputer\User', 0));  

Lihat Juga

ORIGINAL_LOGIN (T-SQL)
BUAT TABEL (Transact-SQL)
biner dan varbinary (Transact-SQL)
Fungsi Sistem (Transact-SQL)