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; номер сеанса аудита нельзя задать заранее.