CONTEXT_INFO (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Tato funkce vrací hodnotu context_info buď nastavenou pro aktuální relaci nebo dávku, nebo odvozenou pomocí SET CONTEXT_INFO příkazu.

Transact-SQL konvence syntaxe

Syntaxe

CONTEXT_INFO()  

Návratová hodnota

Hodnota context_info .

Pokud context_info nebylo nastaveno:

• SQL Server vrací NULL.
• SQL Database vrací unikátní GUID specifické pro relaci.

Poznámky

Funkce Multiple Active Result Sets (MARS) umožňuje aplikacím spouštět více dávek nebo požadavků současně na stejném připojení. Když jedna z MARS spojovacích skupin vykoná SET CONTEXT_INFO, CONTEXT_INFO funkce vrátí novou kontextovou hodnotu, když funkce CONTEXT_INFO běží ve stejné dávce jako příkaz SET . Pokud CONTEXT_INFO funkce běží v jedné nebo více dalších spojovacích dávkách, nevrátí CONTEXT_INFO novou hodnotu, pokud tyto dávky nezačaly po dokončení dávky, která příkaz SET spustila.

Povolení

Nevyžaduje žádná zvláštní povolení. Následující systémové pohledy uchovávají kontextové informace, ale pro přímé dotazování těchto pohledů jsou potřeba oprávnění SELECT a VIEW SERVER STATE:

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

Examples

Tento jednoduchý příklad nastaví hodnotu context_info na 0x1256698456, a poté použije CONTEXT_INFO funkci k získání této hodnoty.

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

Viz také

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