GET_ENTITY_STATISTICS

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

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

Поддерживается в версиях: 7.3 / 7.2 / 7.1 / 7.0 / 6.12 / 6.11 / 6.10 / 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 также можно включить индивидуально для других логических представлений, как описано в разделе Управление статистикой.

Значение равно NULL, если:

• тип сущности не поддерживает расчет ROWS_COUNT;
• расчет ROWS_COUNT отключен для источника (в случае простого представления без условия) или самой сущности (иначе);
• статистика обнулена и еще не пересчитана;
• произошла ошибка при расчете, например, из-за некорректного SELECT-подзапроса в представлении.

ROWS_COUNT_DELTA

Поле не используется (оставлено для обратной совместимости) и всегда имеет значение NULL.

Ограничения

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

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

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

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

Примеры

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

Пример запроса:

GET_ENTITY_STATISTICS(marketing.sales)

Пример ответа показан на рисунке ниже.

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

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

GET_ENTITY_STATISTICS(marketing.payments_proxy)

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

GET_ENTITY_STATISTICS(matview_db.sales_by_stores)

Запрос статистики по логической БД

Пример запроса:

GET_ENTITY_STATISTICS(marketing)

Пример ответа показан на рисунке ниже.

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

Запрос статистики по окружению

GET_ENTITY_STATISTICS()