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.