GET_TS

Содержание раздела
  1. Синтаксис
  2. Варианты ответа
    1. Содержимое успешного ответа
    2. Особенности возврата метки времени
  3. Ограничения
  4. Примеры
    1. Запрос по указанной операции в таблице
    2. Запрос по последней операции в таблице
    3. Запрос по указанной операции в представлении
    4. Запрос по последней операции в логической БД
    5. Запрос с индексированными параметрами
    6. Запрос с именованными параметрами

Поддерживается в версиях: 7.1 / 7.0 / 6.12 / 6.11 / 6.10.

Запрос возвращает метку времени (Unix и UTC) для успешно завершенной операции записи. Запрос может содержать индексированные и именованные параметры.

Доступно получение метки времени для операции:

Под операцией в простом логическом представлении понимается операция в логической таблице-источнике.

Метку времени операции также можно запросить с помощью GET-методов /ts.

Синтаксис

Запрос по указанной операции в логической таблице или простом логическом представлении:

GET_TS([db_name.]entity_name, sys_cn)

Запрос по последней операции в логической таблице или простом логическом представлении:

GET_TS([db_name.]entity_name)

Запрос по последней операции в логической БД, используемой по умолчанию:

GET_TS()

Любые аргументы запроса могут быть заданы как индексированные и (или) именованные параметры.

Параметры:

db_name (VARCHAR | CHAR | STRING)

Имя логической базы данных, которой принадлежит логическая сущность. Опционально, если выбрана логическая БД, используемая по умолчанию.

entity_name (VARCHAR | CHAR | STRING)

Имя сущности, по которой запрашивается информация.

Возможные значения:

  • имя логической таблицы любого типа;
  • имя простого логического представления, построенного на подзапросе к логической таблице.
sys_cn (BIGINT | INT64 | LONG)

Номер операции записи, по которой запрашивается информация.

Допустимые значения: целые числа с 0 до максимального номера операции записи в указанной таблице или таблице-источнике (для представления), включая обе границы.

Варианты ответа

В ответе возвращается:

  • объект ResultSet c одной записью при успешном выполнении запроса;
  • исключение при неуспешном выполнении запроса.

Содержимое успешного ответа

Успешный ответ содержит столбцы:

  • ts — метка времени операции в Unix-формате, равная целому числу микросекунд с 00:00:00 UTC 1 января 1970 года;
  • datetime — метка времени операции в UTC-формате YYYY-MM-DD hh:mm:ss.SSSSSS.

Особенности возврата метки времени

  • Если завершенных операций нет, возвращается NULL.
  • Если операции с указанным номером нет в сущности, возвращается:
    • метка времени следующей существующей операции — если номер входит в диапазон номеров операций в сущности;
    • NULL — иначе.

Ограничения

  • Запрос доступен для сущностей:
    • логических таблиц;
    • простых логических представлений, построенных на подзапросе к логической таблице;
    • логических БД.
  • Если в запросе есть именованные параметры, их имена должны соответствовать соглашениям об именах.

Примеры

Запрос по указанной операции в таблице

Запрос с предварительным выбором логической БД:

USE marketing;
GET_TS(sales, 12);

Запрос с указанием логической БД:

GET_TS(marketing.sales, 12)

Запрос по последней операции в таблице

Запрос с предварительным выбором логической БД:

USE marketing;
GET_TS(sales);

Запрос с указанием логической БД:

GET_TS(marketing.sales)

Запрос по указанной операции в представлении

Запрос с предварительным выбором логической БД:

USE marketing;
GET_TS(sales_view_with_condition, 12);

Запрос с указанием логической БД:

GET_TS(marketing.sales_view_with_condition, 12)

Запрос по последней операции в логической БД

USE marketing;
GET_TS();

Запрос с индексированными параметрами

-- запрос по указанной операции в таблице
GET_TS(?, ?)

Запрос с именованными параметрами

-- запрос по указанной операции в таблице
GET_TS(:table_name_with_db_name, :op_cn)