Сообщения оператору =================== Действия оператора в случае аварии и сбоев ------------------------------------------ Программа «Витрина данных НСУД» является сложным программным продуктом, установка и настройка которого осуществляется системным программистом. Надежность аппаратной платформы сервера и рабочих станций, операционных систем серверов и рабочих станций, систем управления базами данных обеспечивается их производителями. При эксплуатации программы возможны аварийные ситуации и сбои в работе. **Таблица** **Возможные аварийные ситуации** +----------------+----------------+----------------+----------------+ | Аварийная | Возможные | Способ | Способ | | ситуация | причины | избежания | ликвидации | | | | | последствий | +----------------+----------------+----------------+----------------+ | Отключение | Внешние или | При вводе | Повторный ввод | | питания | внутренние | большого | и сохранение | | аппаратных | проблемы с | количества | информации | | средств | э | данных, | | | | лектропитанием | выполнять | | | | | сохранение в | | | | | процесса ввода | | +----------------+----------------+----------------+----------------+ | Сбой | Нехватка | Мониторинг | Обратится к | | операционной | системных | системных | системному | | системы | ресурсов | ресурсов | программисту | | сервера | | | | +----------------+----------------+----------------+----------------+ | Сбой при | Ошибка в | Мониторинг | Просмотр в | | передаче | работе | раб | системе | | данных | программного | отоспособности | мониторинга | | | обеспечения | серверного | раб | | | | оборудования и | отоспособности | | | Один или | программного | серверного | | | несколько | обеспечения | оборудования и | | | серверов | | программного | | | системы | | обеспечения. В | | | недоступны. | | случае | | | | | корректной | | | | | работы | | | | | выполнить | | | | | повторную | | | | | отправку | | | | | данных. | | | | | | | | | | В случае | | | | | повторения | | | | | ошибки | | | | | обратиться к | | | | | системному | | | | | программисту | +----------------+----------------+----------------+----------------+ | При попытке | Ошибка ввода. | Вводить | Проверить и | | подключения к | | корректные | повторно | | серверу по ssh | | данные | ввести данные | | подключения не | | | для | | происходит | | | подключения. | | | | | Проверить | | | | | раскладку | | | | | клавиатуры, | | | | | проверить и | | | | | при | | | | | необходимости | | | | | отключить | | | | | клавишу «Caps | | | | | | | | | | Lock» | | | | | Обратится к | | | | | системному | | | | | программисту | +----------------+----------------+----------------+----------------+ «Витрина данных НСУД» объединяет несколько программных продуктов. Это, особенно в первое время эксплуатации, может являться причиной возникновения аварийных ситуаций. Аварийные ситуации могут возникать как из-за ошибок в программных продуктах, так и из-за неправильной настройки. Признаками аварийной ситуации являются: - Отсутствие связи с серверами или другими компонентами системы, например с Адаптером СМЭВ. - Окна с сообщениями о нештатной ситуации. - Окна с сообщениями на английском языке. - Сообщение об отсутствии прав на действия. В случае нештатного поведения программного обеспечения необходимо в первую очередь проверить корректность всех настраиваемых параметров системы. Если после проверки настроек работа по-прежнему некорректна, то необходимо выслать разработчикам лог-файл. Классификатор ошибок -------------------- При работе с программой через JDBC-клиента оператору могут выводиться сообщения, указанные в таблице 1. Все сообщения, формируемые в процессе функционирования компонентов программы, журналируются соответствующими компонентами, а именно: 1) Ядро витрины :term:`ProStore` в ходе выполнения формирует сообщения и выводит их в стандартный порт вывода, перенаправленный в лог-файл в директории var/log/dtm-core; 1) Сервис мониторинга статусов Kafka в ходе выполнения формирует сообщения и выводит их в стандартный порт вывода, перенаправленный в лог-файл в директории var/log/status-monitor. Дополнительно, сервис исполнения запросов принимает сообщения от внешних по отношению к нему компонентов Витрины в ходе их выполнения и также выводит их в стандартный порт вывода, перенаправленный в лог-файл в директории var/log/dtm-core. Формируемые сообщения делятся на следующие категории, определяющие уровень важности сообщения: 1) ``INFO`` – информирующее сообщение о статусе запроса, выполненного или полученного Сервисом исполнения запросов. Сообщение имеет базовый уровень важности; 2) ``TRACE``, ``DEBUG`` – подробные сообщения о состояниях внутренних компонентов Сервиса исполнения запросов. Сообщения предназначены для отладки и имеют повышенный уровень важности; 3) ``WARN`` – сообщение от ADTM о некритичном сбое, имеет повышенный уровень важности; 4) ``ERR`` – сообщение от ADTM о критичном сбое, имеет высокий уровень важности. Сообщения содержат: 1) метки даты-времени с миллисекундной точностью; 2) категорию сообщения; 3) уровень иерархической вложенности сообщения в рамках одного компонента-отправителя; 4) идентификатор потока в многопоточном исполнении; 5) идентификатор компонента-отправителя; 6) тело текстового сообщения. Таблица 1. Классификатор ошибок +----------------------+----------------------+----------------------+ | Выдаваемое сообщения | Описание сообщения | Действия | | | | программиста | +======================+======================+======================+ | Database | Неуспешная попытка | Указать другое | | <имя_логической\_ | создания логической | наименование | | базы_данных> already | базы данных: | логической базы | | exists   | указанное | данных и повторить | | | наименование уже | SQL-запрос | | | используется для | | | | другой логической | | | | базы данных в рамках | | | | окружения | | +----------------------+----------------------+----------------------+ | Database < | Неуспешная попытка | Исправить | | имя_логической\_  | обращения к | наименование | | базы_данных> does | логической базе | логической базы | | not exist | данных: логическая | данных на корректное | | | база данных с | и повторить | | | указанным | SQL-запрос. | | | наименованием | | | | отсутствует в рамках | Для получения | | | окружения | перечня существующих | | | | логических баз | | | | данных можно | | | | использовать | | | | SQL-запрос: SELECT | | | | \* FROM | | | | informat | | | | ion_schema.schemata  | +----------------------+----------------------+----------------------+ | System database | Неуспешная попытка | Действия не | | INFORMATION_SCHEMA | удаления логической | требуются | | is non-deletable | базы данных | | | | INFORMATION_SCHEMA: | | | | данная логическая | | | | база данных | | | | используется | | | | служебных целях и не | | | | может быть удалена | | +----------------------+----------------------+----------------------+ | Table | Неуспешная попытка | Указать другое | | <имя | создания логической | наименование для | | _логической_таблицы> | таблицы: указанное | логической таблицы и | | already exists | наименование уже | повторить SQL-запрос | | | используется для | | | | другой логической | | | | таблицы в рамках | | | | логической базы | | | | данных | | +----------------------+----------------------+----------------------+ | Table | Неуспешная попытка | Исправить | | <имя | обращения к | наименование | | _логической_таблицы> | логической таблице: | логической таблицы | | does not exist | логическая таблица с | на корректное и | | | указанным | повторить исходный | | | наименованием | SQL-запрос. | | | отсутствует в рамках | | | | логической базы | Для получения | | | данных | перечня существующих | | | | логических таблиц и | | | | представлений можно | | | | использовать | | | | SQL-запрос: SELECT | | | | \* FROM | | | | infor | | | | mation_schema.tables | +----------------------+----------------------+----------------------+ | Entity | Неуспешная попытка | Указать другое | | <имя_логического\_ | создания логического | наименование | | представления> | представления: | логического | | already exists | указанное | представления  и | | | наименование уже | повторить SQL-запрос | | | используется для | | | | другого логического | | | | представления в | | | | рамках логической | | | | базы данных | | +----------------------+----------------------+----------------------+ | View | Неуспешная попытка | Исправить | | <имя_логического\_ | обращения к | наименование | | представления> does | логическому | логического | | not exist | представлению: | представления на | | | логическое | корректное | | | представление с | наименование и | | | указанным | повторить | | | наименованием | SQL-запрос. | | | отсутствует в рамках | | | | логической базы | Для получения | | | данных | перечня существующих | | | | логических таблиц и | | | | представлений можно | | | | использовать | | | | SQL-запрос: SELECT | | | | \* FROM | | | | infor | | | | mation_schema.tables | +----------------------+----------------------+----------------------+ | External Table | Неуспешная попытка | Указать другое | | <имя_внешней\_ | создания внешней | наименование внешней | | таблицы> already | таблицы: указанное | таблицы и повторить | | exists | наименование уже | SQL-запрос | | | используется для | | | | другой внешней | | | | таблицы в рамках | | | | логической базы | | | | данных | | +----------------------+----------------------+----------------------+ | External table | Неуспешная попытка | Исправить | | <имя_внешней\_ | обращения к внешней | наименование  | | таблицы> does not | таблице: внешняя | внешней таблицы на | | exist | таблица с указанным | корректное и | | | наименованием | повторить SQL-запрос | | | отсутствует в рамках | | | | логической базы | | | | данных | | +----------------------+----------------------+----------------------+ | Column <имя_столбца> | Неуспешная попытка | Исправить | | does not exist | обращения к столбцу | наименование столбца | | | логической таблицы | на корректное и | | | или логического | повторить | | | представления: | SQL-запрос. | | | столбец с указанным | | | | наименованием | Для получения | | | отсутствует | перечня существующих | | | | столбцов логических | | | | таблиц и | | | | представлений можно | | | | использовать | | | | SQL-запрос: SELECT | | | | \* FROM | | | | inform | | | | ation_schema.columns | +----------------------+----------------------+----------------------+ | Disallowed view or | Неуспешная попытка | Скорректировать | | directive in a | создания или | SQL-запрос таким | | subquery | изменения | образом, чтобы в нем | | < | логического | отсутствовали | | SQL-запрос_типа_DML> | представления: в | системные и другие | | | SQL-запросе | логические | | | использованы | представления, а | | | системные | также инструкция | | | представления, | FOR_SYSTEM_TIME | | | другие логические | | | | представления или | | | | инструкция | | | | FOR_SYSTEM_TIME, | | | | которые недоступны | | | | для логического | | | | представления | | +----------------------+----------------------+----------------------+ | Delta is not | Неуспешная попытка | Если нет | | committed | открытия дельты: | необходимости в | | | дельта уже открыта | открытии новой | | | | дельты, действия не | | | | требуются.  | | | | | | | | Если есть | | | | необходимость в | | | | открытии новой | | | | дельты, следует | | | | закрыть текущую | | | | открытую дельту и | | | | затем открыть новую | | | | дельту | +----------------------+----------------------+----------------------+ | The delta number | Неуспешная попытка | Скорректировать | | <номер_дельты> is | открытия дельты: | номер дельты или | | not next to an | использована | удалить инструкцию | | actual delta | инструкция SET с | SET и некорректный | | | номером, который не | номер, после чего | | | соответствует | повторить | | | формату | SQL-запрос. | | | <номе | | | | р_последней_закрытой | Номер последней | | | \_дельты> + 1 | закрытой дельты | | | | можно узнать с | | | | помощью SQL-запроса | | | | GET_DELTA_OK()  | +----------------------+----------------------+----------------------+ | Delta is already | Неуспешная попытка | Действия не | | committed | закрытия дельты: | требуются | | | дельта уже закрыта | | +----------------------+----------------------+----------------------+ | Unable to set the | Неуспешная попытка | Скорректировать | | date-time | закрытия дельты: | указанные дату и | | <дата_и_время> | использована | время дельты или | | | инструкция SET с | удалить инструкцию | | | датой и временем, | SET и некорректные | | | которые предшествуют | дату и время, после | | | дате и времени | чего повторить | | | последней закрытой | SQL-запрос. | | | дельты | | | | | Дату и время | | | | последней закрытой | | | | дельты можно узнать | | | | с помощью | | | | SQL-запроса | | | | GET_DELTA_OK()  | +----------------------+----------------------+----------------------+ | Location is | Неуспешная попытка | Скорректировать | | unreachable | загрузки/выгрузки | указанный путь к | | | данных: внешний | внешнему приемнику | | | приемник данных | данных | | | отсутствует по пути, | | | | указанному для | | | | внешней таблицы | | +----------------------+----------------------+----------------------+ | Queried entity is | Неуспешная попытка | Скорректировать | | missing for the | обращения к явно | указанный источник | | specified | заданному источнику | данных или перечень | | DATASOURCE_TYPE | данных: | запрашиваемых | | < | запрашиваемая | сущностей, после | | тип_источника_данных | сущность отсутствует | чего повторить | | > | в источнике данных | SQL-запрос | +----------------------+----------------------+----------------------+ | No single datasource | Неуспешная попытка | Скорректировать | | contains all queried | обращения к | указанные источники | | entities | нескольким | данных или перечень | | | источникам данных: | запрашиваемых | | | нет ни одного | сущностей, после | | | источника данных, | чего повторить | | | который бы содержал | SQL-запрос | | | все запрашиваемые | | | | сущности | | +----------------------+----------------------+----------------------+