Skip to content
The Chat Archive
gemini-2.5-pro· Google LMArena Human Preference 140K

Co to jest SESSION_CONTEXT w SQL Server?

  1. User

    Co to jest SESSION_CONTEXT w SQL Server?

  2. Assistant

    Jasne, wyjaśnijmy dokładnie, czym jest SESSION_CONTEXT w SQL Server.

    Co to jest SESSION_CONTEXT?

    W najprostszych słowach, SESSION_CONTEXT to mały, prywatny i bezpieczny "schowek" na dane, który istnieje tylko na czas trwania Twojej sesji z bazą danych. Możesz w nim przechowywać pary klucz-wartość (jak w słowniku), aby przekazywać informacje między różnymi zapytaniami lub procedurami w ramach tej samej sesji.

    Każda sesja (połączenie z bazą danych) ma swój własny, odizolowany SESSION_CONTEXT. Oznacza to, że jedna sesja nie może odczytać ani zmodyfikować danych w SESSION_CONTEXT innej sesji.

    Jak to działa?

    Do zarządzania SESSION_CONTEXT używamy dwóch głównych elementów:

    1. Procedura sp_set_session_context: Służy do ustawiania lub modyfikowania wartości dla danego klucza.
    2. Funkcja SESSION_CONTEXT(): Służy do odczytywania wartości przypisanej do danego klucza.

    Składnia:

    • Ustawianie wartości:

      EXEC sp_set_session_context @key = N'nazwa_klucza', @value = 'wartość', @read_only = 1;
      
      • @key: Nazwa Twojego klucza (typu sysname).
      • @value: Wartość, którą chcesz przechować (typu sql_variant, co oznacza, że może to być liczba, tekst, data itp.). Maksymalny rozmiar to 8000 bajtów.
      • @read_only: Flaga (0 lub 1). Jeśli ustawisz na 1, wartości dla tego klucza nie można już zmienić w tej sesji. Jest to kluczowe dla bezpieczeństwa.
    • Odczytywanie wartości:

      SELECT SESSION_CONTEXT(N'nazwa_klucza');
      

      Funkcja zwraca wartość typu sql_variant, więc często trzeba ją zrzutować (CAST lub CONVERT) na odpowiedni typ danych.

      -- Przykład rzutowania na typ integer
      SELECT CAST(SESSION_CONTEXT(N'UserID') AS INT);
      

    Główne zastosowania (Dlaczego jest to tak użyteczne?)

    SESSION_CONTEXT nie jest tylko ciekawostką; jest to potężne narzędzie, szczególnie w nowoczesnych aplikacjach.

    1. Row-Level Security (RLS) - Bezpieczeństwo na poziomie wiersza

    To jest najważniejsze i najczęstsze zastosowanie. RLS pozwala ograniczyć dostęp do wierszy w tabeli w zależności od tego, kto wykonuje zapytanie.

    Jak to działa z SESSION_CONTEXT?

    1. Logowanie użytkownika: Aplikacja po zalogowaniu użytkownika łączy się z bazą danych.
    2. Ustawienie kontekstu: Aplikacja wykonuje sp_set_session_context, zapisując identyfikator użytkownika, np. UserID lub TenantID (w aplikacjach wielodostępnych).
      EXEC sp_set_session_context @key = N'UserID', @value = 123, @read_only = 1;
      
    3. Polityka bezpieczeństwa: Na tabeli (np. Orders) zdefiniowana jest polityka bezpieczeństwa (Security Policy), która używa funkcji filtrującej.
    4. Funkcja filtrująca: Ta funkcja odczytuje UserID z SESSION_CONTEXT i porównuje go z kolumną UserID w tabeli. Zwraca 1 (prawda), jeśli wiersz powinien być widoczny dla użytkownika, i 0 (fałsz) w przeciwnym razie.
    5. Automatyczne filtrowanie: Kiedy użytkownik wykonuje SELECT * FROM Orders, SQL Server automatycznie i transparentnie stosuje filtr, pokazując mu tylko jego własne zamówienia.

    Dzięki temu nie musisz dodawać warunku WHERE UserID = 123 do każdego zapytania w aplikacji. Baza danych robi to za Ciebie w sposób bezpieczny i centralnie zarządzany.

    2. Przechowywanie stanu aplikacji

    Możesz przechowywać inne informacje o stanie sesji, np.:

    • Język interfejsu (LanguageCode), aby procedury zwracały komunikaty w odpowiednim języku.
    • Identyfikator śledzenia (TrackingID) do celów audytowych i debugowania.

    3. Unikanie "Parameter Drilling"

    Wyobraź sobie, że masz skomplikowaną logikę biznesową, w której jedna procedura składowana wywołuje drugą, a ta kolejną. Jeśli każda z nich potrzebuje UserID, musiałbyś przekazywać ten parametr przez całą hierarchię wywołań. Zamiast tego, możesz ustawić UserID raz w SESSION_CONTEXT, a każda procedura w łańcuchu może go sobie po prostu odczytać.


    Przykład praktyczny (Row-Level Security)

    -- Krok 1: Stwórzmy tabelę i dane testowe
    CREATE TABLE Sales (
        OrderID INT PRIMARY KEY,
        Product VARCHAR(50),
        Amount DECIMAL(10, 2),
        EmployeeID INT
    );
    GO
    
    INSERT INTO Sales (OrderID, Product, Amount, EmployeeID) VALUES
    (1, 'Laptop', 4500.00, 101),
    (2, 'Mouse', 150.00, 102),
    (3, 'Keyboard', 250.00, 101),
    (4, 'Monitor', 1800.00, 102);
    GO
    
    -- Krok 2: Stwórzmy funkcję filtrującą, która czyta z SESSION_CONTEXT
    CREATE FUNCTION Security.fn_SalesPredicate(@EmployeeID AS INT)
    RETURNS TABLE
    WITH SCHEMABINDING
    AS
        RETURN SELECT 1 AS a
        WHERE @EmployeeID = CAST(SESSION_CONTEXT(N'EmployeeID') AS INT);
    GO
    
    -- Krok 3: Stwórzmy politykę bezpieczeństwa, która używa tej funkcji
    CREATE SECURITY POLICY Security.SalesFilter
    ADD FILTER PREDICATE Security.fn_SalesPredicate(EmployeeID) ON dbo.Sales
    WITH (STATE = ON);
    GO
    
    
    -- Krok 4: Symulacja sesji różnych użytkowników
    
    -- === SESJA PRACOWNIKA 101 ===
    PRINT '--- Zapytanie jako Pracownik 101 ---';
    EXEC sp_set_session_context @key = N'EmployeeID', @value = 101;
    SELECT * FROM Sales; -- Zwróci tylko wiersze dla pracownika 101
    GO
    
    -- === SESJA PRACOWNIKA 102 ===
    PRINT '--- Zapytanie jako Pracownik 102 ---';
    EXEC sp_set_session_context @key = N'EmployeeID', @value = 102;
    SELECT * FROM Sales; -- Zwróci tylko wiersze dla pracownika 102
    GO
    
    -- === SESJA BEZ KONTEKSTU ===
    PRINT '--- Zapytanie bez ustawionego kontekstu ---';
    EXEC sp_set_session_context @key = N'EmployeeID', @value = NULL;
    SELECT * FROM Sales; -- Nie zwróci żadnych wierszy, bo CAST(NULL AS INT) nie jest równe żadnemu ID
    GO
    
    -- Czyszczenie
    DROP SECURITY POLICY Security.SalesFilter;
    DROP FUNCTION Security.fn_SalesPredicate;
    DROP TABLE Sales;
    DROP SCHEMA Security;
    GO
    

    SESSION_CONTEXT vs. CONTEXT_INFO

    Przed SESSION_CONTEXT (wprowadzonym w SQL Server 2016) istniał mechanizm CONTEXT_INFO. SESSION_CONTEXT jest jego nowoczesnym i znacznie lepszym następcą.

    CechaSESSION_CONTEXTCONTEXT_INFO
    StrukturaPary klucz-wartość. Możesz przechowywać wiele wartości pod różnymi nazwami.Pojedyncza wartość binarna. Musisz samodzielnie pakować i rozpakowywać dane.
    Typ danychKlucz: sysname. Wartość: sql_variant (do 8000 bajtów).binary(128).
    BezpieczeństwoWysokie. Wartości są logicznie odizolowane i niewidoczne dla innych sesji.Niskie. Wartość jest widoczna dla uprawnionych użytkowników w widoku sys.dm_exec_sessions.
    UżytecznośćŁatwy w użyciu. Dedykowane funkcje do odczytu i zapisu.Kłopotliwy. Wymaga ręcznej konwersji danych do i z formatu binarnego.
    ZalecenieNowoczesne, zalecane podejście.Starszy, przestarzały mechanizm (legacy). Unikaj, jeśli to możliwe.

    Podsumowanie

    SESSION_CONTEXT to kluczowy element nowoczesnego programowania w SQL Server, który zapewnia bezpieczny, elastyczny i wydajny sposób zarządzania stanem sesji. Jego główną zaletą jest uproszczenie i wzmocnienie implementacji mechanizmów bezpieczeństwa, takich jak Row-Level Security.

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.