Общие сведения о таблицах отслеживания использования

В системе данные отслеживания использования хранятся в трех таблицах базы данных.

Процесс отслеживания использования создает эти три таблицы с именами таблиц, указанными в настройках на странице "Системные настройки".

  • Таблица регистрации логических запросов отслеживания использования
  • Таблица регистрации физических запросов отслеживания использования
  • Таблица блоков инициализации отслеживания использования

См. Задание параметров отслеживания использования.

Таблица регистрации логических запросов отслеживания использования

В следующей таблице описаны все столбцы таблицы базы данных, в которой отслеживаются логические запросы. При необходимости указывается тип данных, например поле символа переменной (varchar и varchar2) и длина. При просмотре описаний в этой таблице можно предположить, что определенные, связанные со временем столбцы можно добавлять или вычитать для получения равных точных значений. Например, можно предположить, что TOTAL_TIME_SEC равно END_TS минус START_TS. Столбцы не содержат таких точных значений по следующей причине:
  • Различные процессы выполняются параллельно, и их скорость зависит от нагрузки и производительности баз данных. Серверные операции могут быть легкими или интенсивными.
  • Если все подключения заняты, запрос поступает в очередь и ожидает обработки. Время зависит от нагрузки и конфигурации.

Столбцы, связанные с пользователями, сеансами и идентификаторами

Столбец Описание

ID

В этом столбце таблицы логического запроса указывается уникальный идентификатор строки. Этот столбец таблицы физического запроса помечается именем LOGICAL_QUERY_ID.

NODE_ID

Содержит <hostname>:obis1. Например, examplehost:obis1 (для одного экземпляра).

PRESENTATION_NAME

Указывает имя каталога. По умолчанию установлено значение Null, тип данных — Varchar(128).

IMPERSONATOR_USER_NAME

Указывает имя имперсонированного пользователя. Если запрос не выполняется от имени имперсонированного пользователя, то этот параметр имеет значение None (Нет). По умолчанию установлено значение None (Нет), а тип данных — Varchar(128).

USER_NAME

Указывает имя пользователя, отправившего запрос.
ECID Указывает созданный системой идентификатор контекста выполнения. Тип данных: Varchar2(1024).
TENANT_ID Указывает имя арендатора пользователя, запустившего блок инициализации. Тип данных: Varchar2(128).
SERVICE_NAME Указывает имя сервиса. Тип данных: Varchar2(128).
SESSION_ID Указывает идентификатор сеанса. Тип данных: Number(10).
HASH_ID Указывает значение HASH для логического запроса. Тип данных: Varchar2(128).

Столбцы, связанных с источником запросов

Столбец Описание

QUERY_SRC_CD

Источник запроса.

Обратите внимание, что инициатор запроса может задать переменной QUERY_SRC_CD любое строковое значение, чтобы идентифицировать себя.

Возможные значения:
  • Report — если источником служит анализ или операция экспорта.
  • Drill — если источником служит изменение измерения, вызванное увеличением или уменьшением детализации.
  • ValuePrompt — если источником служит раскрывающийся список Value (Значение) в диалоговом окне фильтра или в строке запросе информационной панели.
  • VisualAnalyzer — если источником служит рабочая книга визуализации данных.
  • DisplayValueMap или MemberBrowserDisplayValues или MemberBrowserPath — если источником служит значение, связанное с отображением анализа.
  • SOAP — если источником служит вызов из веб-сервисов, таких как DataSetSvc.
  • Seed — если источником служит агент, присваивающий начальные значения в кэше сервера аналитики.
  • Null — если источником служит физическая таблица "Средство администрирования", количество строк/столбцов или данные представлений.

SAW_DASHBOARD

Указывает путь к информационной панели. Если запрос не был отправлен через информационную панель, значение равно NULL.

SAW_DASHBOARD_PG

Указывает имя страницы на информационной панели. Если запрос не является запросом информационной панели, значение равно NULL. По умолчанию установлено значение Null, тип данных — Varchar(150).

SAW_SRC_PATH

Указывает путь в каталоге для анализа.

Столбцы, связанные со сведениями о запросах

Столбец Описание

ERROR_TEXT

Содержит сообщение об ошибке из серверной базы данных. Этот столбец применим, только если параметру SUCCESS_FLAG задано значение, отличное от 0 (ноль). Несколько сообщений объединяются и не анализируются в системе. По умолчанию установлено значение Null, тип данных — Varchar(250).

QUERY_BLOB

Содержит всю логическую инструкцию SQL без усечения. Столбец QUERY_BLOB представляет собой строку символов типа Long.

QUERY_KEY

Содержит хеш-ключ MD5, сгенерированный в системе на основе логической инструкции SQL. По умолчанию установлено значение Null, тип данных — Varchar(128).

QUERY_TEXT

Указывает инструкцию SQL, отправленную для запроса. Тип данных: Varchar(1024).

Длину этого столбца Можно изменить (с помощью команды ALTER TABLE), но обратите внимание, что текст, написанный в этом столбце, всегда усечен до размера, определенного в физическом слое. Администратор семантической модели не должен устанавливать для этого столбца длину, превышающую максимальную длину запроса, поддерживаемую серверной физической базой данных. Например, базы данных Oracle позволяют использовать не более 4000 символов типа Varchar, но базы данных Oracle усекаются до 4000 байт, а не 4000 символов. При использовании набора многобайтовых символов фактический максимальный размер строки соответствует различному количеству символов в зависимости от набора символов и используемых символов.

REPOSITORY_NAME

Указывает имя семантической модели, к которой обращается запрос.

SUBJECT_AREA_NAME

Содержит название бизнес-модели, к которой осуществляется доступ.

SUCCESS_FLG

Указывает статус завершения запроса, как определено в следующем списке:

  • 0 — запрос выполнен успешно без ошибок.
  • 1 — время ожидания запроса истекло.
  • 2 — не удалось выполнить запрос из-за превышения ограничений строк.
  • 3 — запрос не выполнен по другой причине.

Столбцы, связанные с временем выполнения

Столбец Описание

COMPILE_TIME_SEC

Содержит время в секундах, необходимое для компиляции запроса. Число COMPILE_TIME_SEC включено в TOTAL_TIME_SEC.

END_DT

Указывает дату завершения логического запроса.

END_HOUR_MIN

Указывает час и минуту завершения логического запроса.

END_TS

Указывает дату и время завершения логического запроса. Метки времени начала и конца также отражают время ожидания доступности ресурсов запросом. Если пользователь, отправляющий запрос, уходит со страницы до завершения обработки запроса, то окончательная выборка не завершается и записывается значение времени ожидания 3600. Однако если пользователь возвращается на страницу до истечения времени ожидания, выборка завершается в этот момент, который записывается как время end_ts.

START_DT

Указывает дату отправки логического запроса.

START_HOUR_MIN

Указывает час и минуту момента отправки логического запрос.

START_TS

Указывает дату и время отправки логического запроса.

TOTAL_TIME_SEC

Указывает время в секундах, затраченное системой на обработку запроса, пока клиент ожидал ответа на анализ. TOTAL_TIME_SEC включает время для COMPILE_TIME_SEC.
RESP_TIME_SEC Указывает время, которое потребовалось, чтобы ответить на запрос. Тип данных: Number(10).

Столбцы, связанные со сведениями о выполнении

Столбец Описание

CUM_DB_TIME_SEC

Содержит совокупное время всех запросов, отправленных в базу данных. Запросы выполняются параллельно, поэтому совокупное время запросов равно или больше общего времени подключения к базе данных. Например, предположим, что логический запрос порождает отправку в базу данных 4 физических инструкций SQL, время обработки 3 инструкций составляет 10 секунд, а время обработки одной инструкции — 15 секунд, CUM_DB_TIME_SEC показывает 45 секунд, так как инструкции выполняются параллельно.

CUM_NUM_DB_ROW

Содержит общее количество строк, возвращенных серверными базами данных.

NUM_DB_QUERY

Указывает количество запросов, отправленных серверным базам данных для выполнения логического запроса. Для успешных запросов (SuccessFlag = 0) это число равно 1 или больше.

ROW_COUNT

Указывает количество строк, возвращенных клиенту запроса. Когда в ответ на запрос возвращается большой объем данных, этот столбец не заполняется до тех пор, пока пользователь не отобразит все данные.
TOTAL_TEMP_KB Указывает общее количество килобайт, полученных для запроса. Тип данных: Number(10).

Столбцы, связанные с кэшем

Столбец Описание

CACHE_IND_FLG

Значение Y указывает на попадание в кэш для запроса; N указывает на промах кэша. По умолчанию: N.

NUM_CACHE_HITS

Указывает, сколько раз возвращался результат кэша для запроса. NUM_CACHE_HITS — 32-разрядное целое число (или 10-значное целое число). Значение по умолчанию: Null.

NUM_CACHE_INSERTED

Указывает, сколько раз запрос создавал запись кэша. Значение по умолчанию: Null. NUM_CACHE_INSERTED — 32-разрядное целое число (или 10-значное целое число).

Таблица регистрации физических запросов отслеживания использования

В следующей таблице описана таблица базы данных, которая отслеживают физические запросы. В этой таблице базы данных регистрируются физические данные SQL для логических запросов, которые хранятся в таблице регистрации логических запросов. Таблица физических запросов связана с таблицей логических запросов посредством отношения внешних ключей.

Столбцы, связанные с пользователями, сеансами и идентификаторами

Столбец Описание

ID

Указывает уникальный идентификатор строки.

LOGICAL_QUERY_ID

Ссылается на логический запрос в таблице регистрации логических запросов. Тип данных: Varchar(250).
HASH_ID Указывает значение HASH для логического запроса. Тип данных: Varchar2(128).
PHYSICAL_HASH_ID Указывает значение HASH для физического запроса. Тип данных: Varchar2(128).

Столбцы, связанные со сведениями о запросах

Столбец Описание

QUERY_BLOB

Содержит всю физическую инструкцию SQL без усечения. Столбец QUERY_BLOB представляет собой строку символов типа Long.

QUERY_TEXT

Содержит инструкцию SQL, отправленную для заданного запроса. Тип данных: Varchar(1024).

Столбцы, связанные с временем выполнения

Столбец Описание

END_DT

Указывает дату завершения физического запроса.

END_HOUR_MIN

Указывает час и минуту завершения физического запроса.

END_TS

Указывает дату и время завершения физического запроса. Метки времени начала и конца также отражают время ожидания доступности ресурсов запросом.

TIME_SEC

Указывает время выполнения физического запроса.

START_DT

Указывает дату отправки физического запроса.

START_HOUR_MIN

Указывает часы и минуты момента отправки физического запроса.

START_TS

Указывает дату и время отправки физического запроса.

Столбцы, связанные со сведениями о выполнении

Столбец Описание

ROW_COUNT

Содержит количество строк, возвращенных клиенту запроса.

Таблица блоков инициализации отслеживания использования

В таблице ниже описана таблица базы данных, которая отслеживает информацию о блоках инициализации.

Примечание.:

В настоящее время таблицы отслеживания использования блоков инициализации включают только блоки инициализации сеансов и не включают блоки инициализации семантической модели.

Столбцы, связанные с пользователями, сеансами и идентификаторами

Столбец Описание
USER_NAME Имя пользователя, запустившего блок инициализации. Тип данных: Varchar2(128).
TENANT_ID Имя арендатора пользователя, запустившего блок инициализации. Тип данных: Varchar2(128).
SERVICE_NAME Имя сервиса. Тип данных: Varchar2(128).
ECID Созданный системой идентификатор контекста выполнения. Тип данных: Varchar2(1024).
SESSION_ID Идентификатор сеанса. Тип данных: Number(10).

Столбцы, связанные со сведениями о запросах

Столбец Описание
REPOSITORY_NAME Имя семантической модели, к которой обращается запрос. Тип данных: Varchar2(128).
BLOCK_NAME Имя запущенного блока инициализации. Тип данных: Varchar2(128).

Столбцы, связанные с временем выполнения

Столбец Описание
START_TS Дата и время запуска блока инициализации.
END_TS Дата и время завершения блока инициализации. Метки времени начала и конца также отражают время ожидания доступности ресурсов запросом.
DURATION Время, которое потребовалось для выполнения блока инициализации. Тип данных: Number(13,3).

Столбцы, связанные со сведениями о выполнении

Столбец Описание
NOTES Примечания о блоке инициализации и его выполнении. Тип данных: Varchar2(1024).