CONTEXT_INFO (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceDatabase SQL di Microsoft Fabric

Fungsi ini mengembalikan nilai context_info yang ditetapkan untuk sesi atau batch saat ini, atau diturunkan melalui penggunaan SET CONTEXT_INFO pernyataan.

Konvensi sintaks transact-SQL

Sintaks

CONTEXT_INFO()  

Nilai hasil

Nilai context_info .

Jika context_info tidak diatur:

• SQL Server mengembalikan NULL.
• SQL Database mengembalikan GUID khusus sesi yang unik.

Keterangan

Fitur Multiple Active Result Sets (MARS) memungkinkan aplikasi menjalankan beberapa batch, atau permintaan, pada saat yang sama, pada koneksi yang sama. Ketika salah satu batch koneksi MARS berjalan SET CONTEXT_INFO, fungsi mengembalikan CONTEXT_INFO nilai konteks baru, ketika fungsi berjalan CONTEXT_INFO dalam batch yang sama dengan pernyataan SET . Jika fungsi berjalan CONTEXT_INFO dalam satu atau beberapa batch koneksi lainnya, CONTEXT_INFO fungsi tidak mengembalikan nilai baru kecuali batch tersebut dimulai setelah menyelesaikan batch yang menjalankan SET pernyataan.

Izin

Tidak memerlukan izin khusus. Tampilan sistem berikut menyimpan informasi konteks, tetapi mengkueri tampilan ini secara langsung memerlukan izin SELECT dan VIEW SERVER STATE:

• sys.dm_exec_requests
• sys.dm_exec_sessions
• sys.sysprocesses

Contoh

Contoh sederhana ini mengatur nilai context_info ke 0x1256698456, lalu menggunakan CONTEXT_INFO fungsi untuk mengambil nilai.

SET CONTEXT_INFO 0x1256698456;  
GO  
SELECT CONTEXT_INFO();  
GO  

Lihat juga

SET CONTEXT_INFO (Transact-SQL)SESSION_CONTEXT (Transact-SQL)
sp_set_session_context (T-SQL)