SYS_CONTEXT

📖 Описание

Функция Oracle/PLSQL SYS_CONTEXT используется для получения информации о состоянии окружения Oracle и значений контекста приложения.


🧩 Синтаксис

SYS_CONTEXT(namespace, parameter [, length])

⚙️ Параметры и аргументы

namespace — пространство имён контекста. Встроенное USERENV описывает текущий сеанс; пользовательское пространство должно быть создано заранее.

parameter — имя атрибута. Для контекста приложения значение задаётся через доверенный пакет с DBMS_SESSION.SET_CONTEXT; встроенные атрибуты USERENV предоставляет сама Oracle.

length — необязательная максимальная длина результата в байтах, от 1 до 4000; по умолчанию 256. Некорректное значение заменяется значением по умолчанию. Результат имеет тип VARCHAR2.

Параметры USERENV

Ниже перечислены используемые в справочнике атрибуты по документации Oracle 19c. Доступность зависит от версии; для специализированных атрибутов аудита нужен соответствующий обработчик, а не обычный SELECT из DUAL.

Параметр Описание
ACTION Текущее действие приложения, заданное через DBMS_APPLICATION_INFO или OCI.
AUDITED_CURSORID Курсор SQL, вызвавшего аудит; при детальном аудите FGA возвращается NULL.
AUTHENTICATED_IDENTITY Идентификатор, использованный при аутентификации.
AUTHENTICATION_DATA Данные аутентификации; для сертификата — его шестнадцатеричное представление.
AUTHENTICATION_METHOD Способ аутентификации, например PASSWORD, OS или KERBEROS.
BG_JOB_ID Номер задания для соответствующего фонового сеанса, иначе NULL.
CLIENT_IDENTIFIER Идентификатор клиента, установленный приложением, например через DBMS_SESSION.SET_IDENTIFIER.
CLIENT_INFO Дополнительная информация приложения о сеансе (до 64 байт).
CURRENT_BIND Значения переменных связывания; доступны в обработчике FGA.
CURRENT_SCHEMA Схема по умолчанию для разрешения неквалифицированных имён объектов.
CURRENT_SCHEMAID Идентификатор текущей схемы по умолчанию.
CURRENT_SQL Начало SQL, вызвавшего FGA; доступно внутри его обработчика.
CURRENT_SQL_LENGTH Длина соответствующего SQL; атрибут доступен в обработчике FGA.
CURRENT_USER Пользователь, чьи права сейчас действуют; может отличаться от SESSION_USER внутри кода с правами владельца.
CURRENT_USERID Идентификатор пользователя, чьи права сейчас действуют.
DB_DOMAIN Домен базы из параметра DB_DOMAIN.
DB_NAME Имя базы из параметра DB_NAME.
DB_UNIQUE_NAME Уникальное имя базы из параметра DB_UNIQUE_NAME.
ENTRYID Номер текущей записи аудита; корректное значение считывают в обработчике аудита.
ENTERPRISE_IDENTITY Корпоративный или внешний идентификатор пользователя; для обычного локального входа — NULL.
FG_JOB_ID Идентификатор задания DBMS_JOB в соответствующем сеансе; вне такого задания — 0.
GLOBAL_CONTEXT_MEMORY Объём памяти SGA, занятый глобальным контекстом.
GLOBAL_UID Глобальный идентификатор пользователя каталога для соответствующего корпоративного подключения, иначе NULL.
HOST Имя клиентского компьютера.
IDENTIFICATION_TYPE Способ определения пользователя в базе, например LOCAL или EXTERNAL.
INSTANCE Номер экземпляра базы.
INSTANCE_NAME Имя экземпляра базы.
IP_ADDRESS IP-адрес клиентского подключения.
ISDBA Строка 'TRUE' при административной аутентификации через ОС или файл паролей, иначе 'FALSE'.
LANG Сокращённое имя языка сеанса.
LANGUAGE Язык, территория и набор символов базы: language_territory.characterset.
MODULE Имя модуля приложения, установленное через DBMS_APPLICATION_INFO или OCI.
NETWORK_PROTOCOL Протокол подключения.
NLS_CALENDAR Календарь сеанса.
NLS_CURRENCY Обозначение валюты сеанса.
NLS_DATE_FORMAT Формат DATE по умолчанию.
NLS_DATE_LANGUAGE Язык названий месяцев и дней.
NLS_SORT Правило сортировки, например BINARY.
NLS_TERRITORY Территория сеанса.
OS_USER Пользователь ОС клиентского процесса.
POLICY_INVOKER Пользователь, вызвавший функцию политики построчной безопасности.
PROXY_ENTERPRISE_IDENTITY DN корпоративного пользователя-посредника в Oracle Internet Directory.
PROXY_USER Пользователь БД, открывший сеанс от имени SESSION_USER.
PROXY_USERID Идентификатор такого пользователя-посредника.
SERVER_HOST Имя сервера экземпляра БД.
SERVICE_NAME Имя сервиса подключения.
SESSION_USER Имя пользователя сеанса; см. также функцию USER.
SESSION_USERID Идентификатор пользователя сеанса.
SESSIONID Идентификатор сеанса аудита.
SID Идентификатор сеанса базы данных.
STATEMENTID Номер оператора в аудите данного сеанса.
TERMINAL Идентификатор клиентского терминала в ОС.

SESSIONID, ENTRYID и STATEMENTID не используются в распределённом SQL. Для USERENV изменение length применяется только к AUTHENTICATION_DATA. CURRENT_SCHEMA может меняться через ALTER SESSION и не обязательно совпадает с пользователем входа.

Совместимость старого кода

AUTHENTICATION_TYPE и EXTERNAL_NAME отмечены как устаревшие ещё в документации 11g: вместо них используются AUTHENTICATION_METHOD вместе с IDENTIFICATION_TYPE, а также AUTHENTICATED_IDENTITY и ENTERPRISE_IDENTITY. PROXY_GLOBAL_UID описан в 11g как глобальный идентификатор EUS-пользователя-посредника, но в перечень 19c выше не включён; его наличие следует сверять с документацией своей версии.


💻 Примеры

SELECT SYS_CONTEXT('USERENV', 'LANG') AS language_code,
       SYS_CONTEXT('USERENV', 'LANGUAGE') AS language_details,
       SYS_CONTEXT('USERENV', 'NLS_CALENDAR') AS calendar_name,
       SYS_CONTEXT('USERENV', 'NLS_DATE_FORMAT') AS date_format,
       SYS_CONTEXT('USERENV', 'NLS_TERRITORY') AS territory
FROM dual;

Значения определяются настройками сеанса. Например, при AMERICAN, AMERICA, GREGORIAN, формате YYYY-MM-DD и кодировке базы AL32UTF8 результат будет: US, AMERICAN_AMERICA.AL32UTF8, GREGORIAN, YYYY-MM-DD, AMERICA. В другой среде вывод отличается.

Имя пользователя и схему по умолчанию удобно сравнить отдельно:

SELECT SYS_CONTEXT('USERENV', 'SESSION_USER') AS login_name,
       SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA') AS default_schema
FROM dual;

При обычном входе WORKSHOP_APP и неизменённой схеме оба значения равны WORKSHOP_APP. См. также USER, UID и устаревшую функцию USERENV.

См. документацию Oracle: SYS_CONTEXT.

Исторические параметры: Oracle 11g: SYS_CONTEXT.