GET_TS

Содержание раздела
  1. Синтаксис
  2. Варианты ответа
  3. Примеры

Поддерживается в версиях:  6.10.

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

Метка возвращается в двух форматах: Unix и UTC. Подробнее см. в секции Варианты ответа.

Запрос поддерживает возврат результата только по номерам, не превышающим максимальный номер операции в логической таблице.

Синтаксис

GET_TS([db_name.]table_name, sys_cn)

Параметры:

db_name

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

table_name

Имя логической таблицы, которой принадлежит запрашиваемая операция. Логическая таблица может быть любого вида.

sys_cn

Номер операции записи. Может принимать любое целое значение с 0 до максимального номера операции записи в логической таблице, включая обе границы.

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

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

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

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

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

Столбцы успешного ответа содержат:

  • метку времени операции, найденной по номеру, — если операция с указанным номером присутствует в таблице;
  • метку времени следующей существующей операции в таблице — если операция с указанным номером отсутствует в таблице и этот номер не превышает максимальный номер операций в таблице;
  • значение null — если операция с указанным номером отсутствует в таблице и этот номер превышает максимальный номер операций в таблице.

Примеры

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

USE marketing;

GET_TS(sales, 12);

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

GET_TS(marketing.sales, 12)