CONTEXT_INFO (T-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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

Konvensi sintaks transact-SQL

Sintaksis

CONTEXT_INFO()  

Catatan

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

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 menjalankan SET CONTEXT_INFO, CONTEXT_INFO fungsi mengembalikan nilai konteks baru, ketika CONTEXT_INFO fungsi berjalan dalam batch yang sama dengan pernyataan SET. CONTEXT_INFO Jika fungsi berjalan dalam satu atau beberapa batch koneksi lainnya, CONTEXT_INFO fungsi tidak mengembalikan nilai baru kecuali batch tersebut dimulai setelah penyelesaian batch yang menjalankan pernyataan SET.

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  

Baca juga

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