GET_ENTITY_STATISTICS

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

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

Поддерживается в версиях:  6.9 / 6.8 / 6.7 / 6.6 / 6.5 / 6.4 / 6.3 / 6.2 / 6.1 / 6.0 / 5.8 / 5.7.

Запрос возвращает статистику по логическим сущностям. Описание возвращаемых параметров см. в секции Параметры статистики.

Статистика доступна по сущностям, перечисленным в разделе О статистике > Поддерживаемые сущности.

Режимы получения статистики

Получить статистику можно по следующим срезам:

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

Категории запросов в статистике

Статистика делится по следующим категориям запросов:

• READ — запросы чтения данных;
• UPLOAD — запросы загрузки данных;
• WRITE — запросы обновления данных;
• DOWNLOAD — запросы выгрузки данных.

Статистика не включает запросы к внешним таблицам загрузки и выгрузки, поэтому запросы категории UPLOAD учитываются только в статистике логических таблиц, прокси-таблиц и внешних writable-таблиц, а запросы категории DOWNLOAD — в статистике логических таблиц, прокси-таблиц, логических и материализованных представлений, а также внешних readable-таблиц.

Синтаксис

Запрос статистики по сущностям всех логических БД окружения:

GET_ENTITY_STATISTICS()

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

GET_ENTITY_STATISTICS(db_name | db_name.entity_name)

Параметры:

db_name

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

entity_name

Имя логической сущности, по которой запрашивается статистика.
Возможные значения:

• имя логической таблицы,
• имя прокси-таблицы,
• имя логического представления,
• имя материализованного представления,
• имя внешней readable-таблицы,
• имя внешней writable-таблицы.

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

Успешный ответ содержит объект ResultSet, где каждая строка — это статистика по одной логической сущности. Неуспешный ответ содержит исключение.

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

Под неуспешным подразумевается запрос, который прошел первичную проверку синтаксиса, но позже вернул ошибку. Примеры неуспешных запросов:

• запрос, вернувший ошибку из датасорса;
• запрос на вставку некорректных данных;
• запрос к несуществующей сущности.

Параметры статистики

Запрос возвращает следующие параметры статистики:

ENTITY_CATALOG

Каталог, которому принадлежит сущность. Всегда имеет значение null.

ENTITY_SCHEMA

Имя логической базы данных, к которой относится сущность.

ENTITY_NAME

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

READ_COUNT

Количество успешных запросов на чтение данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

READ_DURATION

Общее время выполнения (в миллисекундах) успешных запросов на чтение данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

READ_ERROR_COUNT

Количество неуспешных запросов на чтение данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

FIRST_READ

Дата и время первого запроса на чтение данных из этой сущности. Для внешних writable-таблиц значение всегда равно null.

LAST_READ

Дата и время последнего запроса на чтение данных из этой сущности. Для внешних writable-таблиц значение всегда равно null.

UPLOAD_COUNT

Количество успешных запросов на загрузку данных в эту сущность. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

UPLOAD_DURATION

Общее время выполнения (в миллисекундах) успешных запросов на загрузку данных в эту сущность. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

UPLOAD_ERROR_COUNT

Количество неуспешных запросов на загрузку данных в эту сущность. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

FIRST_UPLOAD

Дата и время первого запроса на загрузку данных в эту сущность. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно null.

LAST_UPLOAD

Дата и время последнего запроса на загрузку данных в эту сущность. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно null.

WRITE_COUNT

Количество успешных запросов на обновление данных в этой сущности. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

WRITE_DURATION

Общее время выполнения (в миллисекундах) успешных запросов на обновление данных в этой сущности. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

WRITE_ERROR_COUNT

Количество неуспешных запросов на обновление данных в этой сущности. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно 0.

FIRST_WRITE

Дата и время первого запроса на обновление данных в этой сущности. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно null.

LAST_WRITE

Дата и время последнего запроса на обновление данных в этой сущности. Для логических представлений, материализованных представлений и внешних readable-таблиц значение всегда равно null.

DOWNLOAD_COUNT

Количество успешных запросов на выгрузку данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

DOWNLOAD_DURATION

Общее время выполнения (в миллисекундах) успешных запросов на выгрузку данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

DOWNLOAD_ERROR_COUNT

Количество неуспешных запросов на выгрузку данных из этой сущности. Для внешних writable-таблиц значение всегда равно 0.

FIRST_DOWNLOAD

Дата и время первого запроса на выгрузку данных из этой сущности. Для внешних writable-таблиц значение всегда равно null.

LAST_DOWNLOAD

Дата и время последнего запроса на выгрузку данных из этой сущности. Для внешних writable-таблиц значение всегда равно null.

ROWS_COUNT

Количество записей в логической сущности по состоянию на последнюю закрытую дельту ROWS_COUNT_DELTA.
Значение рассчитывается и выводится для обычных логических таблиц, партициций, логических представлений и материализованных представлений (кроме построенных на базе партиционированных таблиц), для которых включен расчет этого значения. Для партиционированных таблиц, прокси-таблиц, материализованных представлений на базе партиционированных таблиц, а также для внешних readable- и writable-таблиц значение равно null.

Значение ROWS_COUNT для материализованного представления рассчитывается по подзапросу, на котором построено представление, а не текущему состоянию представления. Поэтому значение может отличаться от фактического количества строк представления, если представление еще не успело синхронизироваться с источником.

ROWS_COUNT_DELTA

Номер дельты, по состоянию на которую рассчитано значение ROWS_COUNT. Для партиционированных таблиц, прокси-таблиц, а также для внешних readable- и writable-таблиц значение равно null.

Ограничения

Общие ограничения

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

Ограничения значений ROWS_COUNT и ROWS_COUNT_DELTA

• Значения рассчитываются для сущностей, размещенных в СУБД ADB, ADP и (или) ADQM и имеющих следующие типы: обычная логическая таблица, партиция, логическое представление, материализованное представление (кроме материализованных представлений, построенных на базе партиционированных таблиц).
• После обнуления статистики значения остаются равными null до момента закрытия ближайшей дельты.
• Значения для материализованного представления рассчитывается по исходному запросу представления, а не его текущему состоянию. Поэтому значения могут отличаться от фактических, если представление не успело синхронизироваться с источником.

Примеры

Статистика логической таблицы

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

GET_ENTITY_STATISTICS(marketing.sales)

На рисунке ниже показан фрагмент ответа GET_ENTITY_STATISTICS по логической таблице sales.

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

Статистика прокси-таблицы

Запрос статистики по прокси-таблице:

GET_ENTITY_STATISTICS(marketing.payments_proxy)

Статистика материализованного представления

Запрос статистики по материализованному представлению:

GET_ENTITY_STATISTICS(marketing.sales_by_stores)

Статистика сущностей логической БД

Запрос статистики по сущностям логической базы данных:

GET_ENTITY_STATISTICS(marketing)

На рисунке ниже показан фрагмент ответа GET_ENTITY_STATISTICS по сущностям логической базы данных marketing.

Фрагмент ответа по сущностям логической БД

Статистика сущностей окружения

Запрос статистики по сущностям всех логических баз данных окружения:

GET_ENTITY_STATISTICS()