RDB$GET_CONTEXT( «пространство имён», переменная)

Встроенная функция Дает доступ к информации о текущем подключении и текущей транзакции. Так же позволяет получать пользовательские переменые внутри транзакции или подключения заданые с помощью RDB$SET_CONTEXT.

«Пространства имен» и переменые являются регистро зависимыми

Для продотвращения DoS атак, существует ограничение на 1000 переменых в одном «пространстве имен».

RDB$GET_CONTEXT возращает текущее значение переменой, если переменой нет то возращается NULL.

в настоящий момент есть всего 3 «пространства имен» которые можно использовать:

USER_SESSION для пользовательских переменых, заданые через RDB$SET_CONTEXT в течении подключения.

USER_TRANSACTION для пользовательских переменых, заданые через RDB$SET_CONTEXT в течении транзакции.

SYSTEM предостовляют доступ к определеным переменым, описанных в следующей таблице

-- Получить текущую версию сервера
SELECT RDB$GET_CONTEXT('SYSTEM','ENGINE_VERSION') FROM RDB$DATABASE
 
-- Создание пользовательской переменной в рамках контекста
SELECT RDB$SET_CONTEXT('USER_SESSION','MY','Значение Моей Переменной') FROM RDB$DATABASE
-- Получить потом значение этой переменной
SELECT RDB$GET_CONTEXT('USER_SESSION','MY') FROM RDB$DATABASE
-- Но вот таким образом получить потом значение этой переменной нельзя,
-- т.к. пространство имен регистро-зависимое
SELECT RDB$GET_CONTEXT('USER_SESSION','My') FROM RDB$DATABASE

С помощью контекстных переменных можно сделать нумерацию строк в запросе

SELECT RDB$GET_CONTEXT('USER_TRANSACTION','ROW') AS ROWNUM,
       E.*,
       RDB$SET_CONTEXT('USER_TRANSACTION','ROW', CAST(COALESCE(RDB$GET_CONTEXT('USER_TRANSACTION','ROW'),0) AS INTEGER)+1) AS X
FROM   EMPLOYEE E

Чтобы перезапуск вышеприведенного запроса (без commit'a или rollback'a) не приводил к увеличению счетчика строк, можно «проинициализировать» CONTEXT-переменную холостой выборкой из rdb$database с null-значениями всех полей. Эта «null-строка» далее отсеивается where-предикатом. Чтобы не отображался столбец 'X', нельзя удалять его из select-списка. Вместо этого надо включить его в выражение вычисления другого числового столбца, но так, чтобы это не повлияло на итоговый результат. Например, можно умножить 'X' на ноль и добавить к rownum - на результат это не повлияет:

SELECT rownum+0*x rownum, emp_no, emp_name
FROM(
  SELECT 
    rdb$set_context('USER_TRANSACTION','row',0) rownum,
    NULL emp_no,
    NULL emp_name,
    NULL x
  FROM rdb$database
 
  UNION ALL
 
  SELECT 
    1+CAST(rdb$get_context('USER_TRANSACTION','row') AS INT) AS rownum,
    e.emp_no,
    e.last_name emp_name,
  rdb$set_context('USER_TRANSACTION','row', CAST(COALESCE(rdb$get_context('USER_TRANSACTION','row'),0) AS INTEGER)+1) AS x
  FROM   
  employee e
)t
WHERE emp_no IS NOT NULL
;

RDB$SET_CONTEXT

%Firebird%\doc\sql.extensions\README.context_variables2.txt