Получение метки времени операции

Содержание раздела

1. Получение метки времени операции
   1. Особенности возврата метки времени
   2. URL
   3. Заголовки запроса
      1. Заголовок x-request-id
   4. Тело запроса
   5. Примеры запросов и ответов
      1. Запрос по указанной операции в таблице
      2. Запрос последней операции в таблице
      3. Запрос последней операции в логической БД
      4. Запрос с неуспешным ответом

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

• с указанным номером;
• последней в сущности — логической таблице или простом логическом представлении на базе логической таблицы;
• последней в логической БД.

Метка возвращается в форматах Unix и UTC.

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

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

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

URL

GET {baseUrl}/api/v1/datamarts/{datamart}/entities/{entity}/ts/{cn}

Получение метки времени для успешно завершенной операции, имеющей номер cn, в логической сущности datamart.entity.

GET {baseUrl}/api/v1/datamarts/{datamart}/entities/{entity}/ts

Получение метки времени для последней успешно завершенной операции в логической сущности datamart.entity.

GET {baseUrl}/api/v1/datamarts/{datamart}/ts

Получение метки времени для последней успешно завершенной операции в логической БД datamart.

Где:

• baseUrl — адрес ноды Prostore, состоящий из IP-адреса или доменного имени и номера порта;
• datamart — имя логической БД, в которой была выполнена операция записи;
• entity — имя логической сущности, для которой запрашивается информация об операции. Можно указать логическую таблицу любого типа или простое логическое представление, построенное на подзапросе к логической таблице;
• cn — номер операции.

Заголовки запроса

Заголовок x-request-id

Опциональный заголовок задает уникальный идентификатор HTTP-запроса. Если не указан, система генерирует UUID-значение и возвращает его в качестве идентификатора в ответе.

Тело запроса

Тело запроса отсутствует.

Примеры запросов и ответов

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

Запрос:

curl -X 'GET' \
  'http://localhost:9090/api/v1/datamarts/marketing/entities/sales/ts/10' \
  -H 'x-request-id: 667592e2-50a7-46ef-8aca-e18e71ea2a7d' 

Ответ:

{
  "ts": 1638271680000000,
  "datetime": "2021-11-30 11:28:00"
}

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

Запрос:

curl -X 'GET' \
  'http://localhost:9090/api/v1/datamarts/marketing/entities/sales/ts' \
  -H 'x-request-id: 8b6f0e91-cc38-46f7-8df5-88edb478a8e6' 

Ответ:

{
  "ts": 1638557640000000,
  "datetime": "2021-12-03 18:54:00"
}

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

Запрос:

curl -X 'GET' \
  'http://localhost:9090/api/v1/datamarts/marketing/ts' \
  -H 'x-request-id: 8120d1d2-282f-48d3-9cae-0f6967e1c7a8'

Ответ:

{
  "ts": 1738576810712676,
  "datetime": "2025-02-03 10:00:10.712676"
}

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

Запрос:

curl -X 'GET' \
  'http://localhost:9090/api/v1/datamarts/marketing/entities/sales34/ts/10' \
  -H 'x-request-id: bc65a249-d405-4de0-94b8-9564103370cd' 

Ответ:

{
  "exceptionMessage": "Entity marketing.sales34 does not exist"
}