Поделиться через

  • Статья

Объект SqlContext

На сервере управляемый код запускается при вызове процедуры, функции или метода для определяемого пользователем типа среды CLR или когда действие вызывает срабатывание триггера, определенного на одном из языков платформы Microsoft .NET Framework. Так как выполнение этого кода необходимо как часть соединения пользователя, требуется доступ к контексту участника из кода, работающего на сервере. Кроме того, определенные операции доступа к данным могут быть допустимы, только если они выполняются в контексте участника. Например, доступ к вставленным или удаленным псевдотаблицам, применяемым в операциях триггеров, допустим только в контексте участника.

Контекст участника извлекается из объекта SqlContext. Дополнительные сведения о методах и свойствах SqlTriggerContext см. разделе Microsoft.SqlServer.Server.SqlTriggerContext справочной документации по пакету SDK платформы .NET Framework.

Объект SqlContext обеспечивает доступ к следующим компонентам.

  • SqlPipe: SqlPipe объект представляет канал, по которому результаты передаются на клиент. Дополнительные сведения об объекте SqlPipe см. в разделе Объект SqlPipe.

  • SqlTriggerContext: объект SqlTriggerContext может быть получен только в триггере CLR. Он предоставляет сведения об операции, которая вызвала срабатывание триггера, а также карту столбцов, которые были обновлены. Дополнительные сведения об объекте SqlTriggerContext см. в разделе Объект SqlTriggerContext.

  • IsAvailable: свойство IsAvailable используется для определения доступности контекста.

  • WindowsIdentity: свойство WindowsIdentity используется для получения удостоверения Windows участника.

Определение доступности контекста

Выполните запрос к классу SqlContext, чтобы определить, работает ли выполняемый в данный момент код в процессе. Чтобы сделать это, проверьте свойство IsAvailable объекта SqlContext. Свойство IsAvailable предназначено только для чтения; оно возвращает значение True, если вызывающий код выполняется внутри SQL Server, а также если можно получить доступ к другим членам объекта SqlContext. Если свойство IsAvailable возвращает значение False, все остальные члены SqlContext, если они используются, формируют исключение InvalidOperationException. Если свойство IsAvailable возвращает значение False, любая попытка открыть объект соединения, имеющий в строке соединения текст «context connection=true», закончится неудачей.

Извлечение удостоверения Windows

Код CLR, выполняющийся внутри SQL Server, всегда запускается в контексте учетной записи процесса. Если код должен выполнить определенные действия с использованием удостоверения вызывающего пользователя, а не удостоверения процесса SQL Server, то необходимо получить маркер олицетворения при помощи свойства WindowsIdentity объекта SqlContext. Свойство WindowsIdentity возвращает экземпляр WindowsIdentity, представляющий удостоверение Microsoft Windows участника или значение NULL, если проверка подлинности клиента выполнялась при помощи проверки SQL Server. Доступ к этому свойству могут получить только сборки, имеющие разрешения EXTERNAL_ACCESS или UNSAFE.

Получив объект WindowsIdentity, вызывающие могут олицетворять учетную запись клиента и выполнять действия от их имени.

Если инициировавший выполнение хранимой процедуры или функции клиент соединился с сервером при помощи проверки подлинности Windows, удостоверение участника доступно только через метод SqlContext.WindowsIdentity. Если использовалась проверка подлинности SQL Server, это свойство имеет значение NULL, а код не может олицетворять участника. Образец олицетворения в CodePlex демонстрирует использование олицетворения; дополнительные сведения см. в разделе Образцы компонента SQL Server Database Engine.

Пример

В следующем примере показано, как получить удостоверение Windows вызывающего клиента и олицетворить этого клиента.

C#

[Microsoft.SqlServer.Server.SqlProcedure]
public static void WindowsIDTestProc()
{
    WindowsIdentity clientId = null;
    WindowsImpersonationContext impersonatedUser = null;

    // Get the client ID.
    clientId = SqlContext.WindowsIdentity;

    // This outer try block is used to thwart exception filter 
    // attacks which would prevent the inner finally 
    // block from executing and resetting the impersonation.
    try
    {
        try
        {
            impersonatedUser = clientId.Impersonate();
            if (impersonatedUser != null)
            {
                // Perform some action using impersonation.
            }
        }
        finally
        {
            // Undo impersonation.
            if (impersonatedUser != null)
                impersonatedUser.Undo();
        }
    }
    catch
    {
        throw;
    }
}

Visual Basic

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub  WindowsIDTestProcVB ()
    Dim clientId As WindowsIdentity
    Dim impersonatedUser As WindowsImpersonationContext

    ' Get the client ID.
    clientId = SqlContext.WindowsIdentity

    ' This outer try block is used to thwart exception filter 
    ' attacks which would prevent the inner finally 
    ' block from executing and resetting the impersonation.

    Try
        Try

            impersonatedUser = clientId.Impersonate()

            If impersonatedUser IsNot Nothing Then
                ' Perform some action using impersonation.
            End If

        Finally
            ' Undo impersonation.
            If impersonatedUser IsNot Nothing Then
                impersonatedUser.Undo()
            End If
        End Try

    Catch e As Exception

        Throw e

    End Try
End Sub