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

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

GET-метод возвращает метку времени (Unix и UTC) для соответствующей успешно завершенной операций записи:

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

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

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

Запрос без номера операции

Запрос возвращает:

  • [если нет завершенных операций] NULL;
  • [иначе] метку времени последней успешно завершенной операции в сущности или логической БД (в зависимости от URL).

Запрос с номером операции

Запрос возвращает:

  • [если номер превышает номера операций сущности] 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/1744983131164721' \
  -H 'x-request-id: 667592e2-50a7-46ef-8aca-e18e71ea2a7d'

Ответ:

{
  "ts": 1744983131164721,
  "datetime": "2025-04-18 13:32:11.164"
}

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

Запрос:

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

Ответ:

{
  "ts": 1744983131164721,
  "datetime": "2025-04-18 13:32:11.164"
}

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

Запрос:

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

Ответ:

{
  "ts": 1744983131164721,
  "datetime": "2025-04-18 13:32:11.164"
}

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

Запрос:

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

Ответ:

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