CONTEXT_INFO (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Deze functie geeft de context_info waarde terug, ofwel ingesteld voor de huidige sessie of batch, of afgeleid door gebruik te maken van de SET CONTEXT_INFO-instructie .

Transact-SQL syntaxis-conventies

Syntaxis

CONTEXT_INFO()  

Retourwaarde

De context_info waarde.

Als context_info niet vaststond:

• SQL Server geeft NULL terug.
• SQL Database geeft een unieke sessie-specifieke GUID terug.

Opmerkingen

De functie Multiple Active Result Sets (MARS) stelt applicaties in staat om meerdere batches of verzoeken tegelijkertijd op dezelfde verbinding uit te voeren. Wanneer een van de MARS-verbindingsbatches SET CONTEXT_INFO uitvoert, geeft de CONTEXT_INFO functie de nieuwe contextwaarde terug, wanneer de CONTEXT_INFO functie in dezelfde batch draait als de SET-instructie. Als de CONTEXT_INFO functie in een of meer van de andere verbindingsbatches draait, retourneert de CONTEXT_INFO functie de nieuwe waarde niet tenzij die batches zijn gestart na voltooiing van de batch die de SET-instructie uitvoerde.

Permissions

Vereist geen speciale toestemming. De volgende systeemweergaven slaan de contextinformatie op, maar het direct opvragen van deze weergaven vereist SELECT- en VIEW SERVER STATE-rechten:

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

Voorbeelden

Dit eenvoudige voorbeeld zet de context_info-waarde op 0x1256698456, en gebruikt vervolgens de CONTEXT_INFO functie om de waarde op te halen.

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

Zie ook

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