USERENV

📖 Описание

Функция Oracle/PLSQL USERENV используется для получения информации о текущем сеансе Oracle. Она сохранена для обратной совместимости; для новых запросов рекомендуется SYS_CONTEXT с пространством имён USERENV.


🧩 Синтаксис

USERENV(parameter)

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

parameter — запрашиваемый атрибут сеанса. Документированные параметры Oracle 19c:

Параметр Описание
CLIENT_INFO Сведения, заданные приложением через DBMS_APPLICATION_INFO (до 64 байт).
ENTRYID Номер текущей записи аудита; недоступен в распределённом SQL.
ISDBA Строка 'TRUE' при административной аутентификации через ОС или файл паролей, иначе 'FALSE'.
LANG Сокращённое обозначение языка сеанса.
LANGUAGE Язык, территория и набор символов базы: language_territory.characterset.
SESSIONID Идентификатор сеанса аудита; недоступен в распределённом SQL.
SID Идентификатор сеанса базы данных.
TERMINAL Идентификатор клиентского терминала в ОС.

SESSIONID, SID и ENTRYID возвращают NUMBER, остальные параметры — VARCHAR2. USERENV нельзя использовать в ограничении CHECK. Для номера экземпляра используйте SYS_CONTEXT('USERENV', 'INSTANCE').


💻 Примеры

SELECT USERENV('LANGUAGE') AS session_language FROM dual;
SELECT USERENV('ISDBA') AS administrative_login FROM dual;
SELECT USERENV('SESSIONID') AS audit_session FROM dual;
SELECT USERENV('LANG') AS language_code FROM dual;

Результаты зависят от подключения. Например, в сеансе с языком AMERICAN, территорией AMERICA и базой AL32UTF8 первый запрос вернёт AMERICAN_AMERICA.AL32UTF8, а последний — US. Для обычного подключения ISDBA вернёт FALSE; номер сеанса аудита нельзя задать заранее.

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