История изменений ====================== .. table:: История изменений +---------+------------------------------------------------------------------------------------------------------------------+ | Версия | Изменения документа | +=========+==================================================================================================================+ | 2.11.0 | 1. Требования к УВ актуализированы и распределены по разделам соответствующих обменов | | | | | | - 1.4.1.2, 1.4.2.2, 1.4.3.2 Требования к участникам взаимодействия | | | | | | 2. Добавлена рекомендация по работе с новыми версиями Витрин и РЗ (предупреждение об автоматическом | | | предоставлении доступа к новой версии) | | | | | | - 1.5.1. Модель данных Витрины Поставщика данных | | | | | | - 1.5.3. Определения Регламентированных запросов | | | | | | 3. Актуализирован перечень заголовков | | | | | | - 2.3.1. Перечень заголовков сообщений в Apache Kafka | | | | | | 4. Добавлен новый топик для передачи ТП в Витрину с бинарным разбиением на чанки | | | (<мнемоника Витрины>.query.tp.bin) | | | | | | - 2.3.2. Перечень топиков брокера сообщений Apache Kafka | | | | | | 5. Изменен порядок атрибутов в сообщении с табличными параметрами для Витрины | | | | | | - 2.3.5.3.1.2. Передача чанков табличных параметров (<мнемоника Витрины>.query.tp / | | | <мнемоника Витрины>.query.tp.bin) | | | | | | 6. Удален атрибут priority из запроса БЛОБ по ссылке | | | | | | - 2.3.5.3.2.1. Запрос на получение БЛОБ по ссылке от Витрины (<мнемоника Витрины>.blob.rq) | +---------+------------------------------------------------------------------------------------------------------------------+ | 2.12.0 | 1. Добавлена информация о расширении модели данных Витрины массивом уникальных ключей | | | | | | - 1.5.1. Модель данных Витрины Поставщика данных | | | | | | 2. Добавлены идентифицирующие атрибуты customerId, customerOgrn, queryMnemonic в структуру сообщений для | | | взаимодействия с Поставщиком | | | | | | - 2.3.5.3.1.1. Запрос данных из Витрины (<мнемоника Витрины>.query.rq / | | | <мнемоника Витрины>.procedure.query.rq) | | | | | | - 2.3.5.3.1.2. Передача чанков табличных параметров (<мнемоника Витрины>.query.tp / | | | <мнемоника Витрины>.query.tp.bin) | | | | | | 3. Актуализированы ограничения на загружаемые метаданные (на формат и бизнес ограничения) | | | | | | - 1.5.1. Поддерживаемые форматы | | | | | | - 1.5.2. Модель данных Витрины Поставщика данных | | | | | | - 1.5.4. Определения Регламентированных запросов | | | | | | 4. Скорректирован пример выполнения РЗ (в рамках отказа от ``*`` в SQL РЗ): | | | | | | - 3.2.6. Регламентированные запросы | +---------+------------------------------------------------------------------------------------------------------------------+ | 2.15.0 | 1. Добавлена информация о поддержке FOR SYSTEM_TIME без TIMESTAMP и вычисления интервала в указанной единице | | | времени, символ * удален из примеров поддерживаемых SQL-запросов: | | | | | | - 3.1. Поддерживаемые возможности SQL-синтаксиса | | | | | | 2. Актуализация информация о работе с моделью данных Витрины | | | | | | - 1.5.2. Модель данных Витрины Поставщика данных | | | | | | 3. Добавлено исключение по использованию ``*`` внутри операторов для SQL-выражения РЗ | | | | | | - 1.5.4. Определения Регламентированных запросов | | | | | | 4. Произвольные SQL-запросы доступны только для владельцев Витрин данных | | | | | | - 1.5.6.1. Полномочия на выполнение произвольных SQL-запросов | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.1.0 | 1. Добавлены требования к УВ для отправки запросов к REST-сервису ИС Ответчика более 5 Мб: | | | | | | - 1.4.3.2.1. Требования к Ответчикам | | | | | | - 1.4.3.2.2. Требования к Инициаторам запросов | | | | | | 2. Обновлена терминология по запросам к REST-сервису ИС Ответчика: | | | | | | - 1.3. Участники информационного обмена с использованием СМЭВ4 | | | | | | - 1.4.3. Обмен с использованием запросов к REST-сервису ИС Ответчика | | | | | | - 1.5. Метаданные СМЭВ4 | | | | | | 3. Добавлено описание механизма прохождения запросов к REST-сервису ИС Ответчика более 5 Мб: | | | | | | - 1.4.3.3. Взаимодействие участников обмена | | | | | | - 1.4.3.4.3. Информационный обмен для механизма с возможностью отправки большого запроса | | | | | | 4. Добавлена информация об именованных параметрах Регламентированных SQL-запросов | | | | | | - 1.5.4. Определения Регламентированных SQL-запросов | | | | | | - 3.3.3. Примеры вызова и преобразования исходного запроса | | | | | | - 3.3.4. Выполнение запроса с системным параметром | | | | | | 5. Обновлено описание информационного обмена по рассылкам с учётом возможности распределённой подписки, | | | применена согласованная терминология | | | | | | - 1.4.2. Обмен с использованием Рассылок | | | | | | - 1.5.3. Подписки Потребителей данных СМЭВ4 | | | | | | - 1.5.6.4. Полномочия на Рассылку | | | | | | - 2.3. Протокол взаимодействия Агента СМЭВ4 и Витрины Поставщика данных | | | | | | - 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.2.0 | 1. Добавлена информация о возможности использования общего набора топиков протокола взаимодействия Агент СМЭВ4 | | | - Витрина: | | | | | | - 2.3. Протокол взаимодействия Агента СМЭВ4 и Витрины Поставщика данных | | | | | | - 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных | | | | | | 2. Добавлена возможность вызова РЗ через CALL | | | | | | - 3.3. Выполнение регламентированных SQL-запросов | | | | | | 3. Запрещено использование зарезервированных ключевых слов SQL в мнемонике Витрины и Регламентированного | | | SQL-запроса | | | | | | - 1.5.1. Поддерживаемые форматы | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.3.0 | 1. Добавлены возможные коды возврата СМЭВ4 при ошибках выполнения запроса к REST-сервису ИС Ответчика | | | | | | - 2.4.1.3. Выполнение запросов к REST-сервису ИС Ответчика | | | | | | 2. Добавлена информация о работе и задании лимитов для запросов к REST-сервису ИС Ответчика | | | | | | - 1.4.3.2.1. Требования к Ответчикам | | | | | | - 1.4.3.4.3. Информационный обмен для механизма с возможностью отправки большого запроса | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.4.0 | 1. Добавлена информация о понятии Диагностический запрос и его использовании | | | | | | - 3.6. Использование диагностического запроса к Витрине данных | | | | | | - ТЕРМИНЫ И СОКРАЩЕНИЯ | | | | | | 2. Добавлена информация о времени жизни запроса (таймауте) по умолчанию | | | | | | - 2.4.1.1.1. HTTP-запрос (метод POST) (синхронный режим) | | | | | | - 2.4.1.2.1.1. HTTP-запрос (метод POST) (асинхронный режим) | | | | | | - 2.4.1.2.1.2. HTTP-запрос с табличным параметром (метод POST) (асинхронный режим) | | | | | | 3. Добавлены дополнительные сведения по использованию подписок на Рассылку: | | | | | | - 1.4.2.1. Общее описание информационного обмена (подписка не может быть поставлена на паузу) | | | | | | - 1.5.3. Подписки Потребителей данных СМЭВ4 на регламентированный запрос типа «Рассылка» (При | | | перерегистрации подписки требуется указывать новый идентификатор) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.5.0 | 1. Добавлена информация о статической и динамической регистрации Витрин: | | | | | | - 2.3.3. Настройка Агента СМЭВ4 для работы с несколькими Витринами | | | | | | 2. Добавлена информация по запросу BLOB по ссылке через REST-интерфейс: | | | | | | - 2.4.1. REST-интерфейс Агента СМЭВ4 | | | | | | - 2.4.1.3. Выполнение запроса на получение BLOB по ссылке | | | | | | - 3.3.6. Получение двоичных объектов в результатах запроса | | | | | | 3. Добавлена информация по запросам через REST-интерфейс при подключении к брокеру: | | | | | | - 2.4.1. REST-интерфейс Агента СМЭВ4 | | | | | | 4. Добавлено требование к использованию лимитов (limit), при вызове запросов не являющихся аналитическими: | | | | | | - 3.3.1. Правила выполнения | | | | | | 5. Добавлены примеры вызова Регламентированных SQL-запросов с параметрами типов TIMESTAMP и DATE: | | | | | | - 3.3.3. Примеры вызова и преобразования исходного запроса | | | | | | 6. Добавлена информация о сквозной идентификации запросов в СМЭВ4: | | | | | | - 3.7. Сквозная идентификация запросов | | | | | | - 2.4. Протокол взаимодействия Агента СМЭВ4 и ИС Потребителя данных (формат передачи клиентского | | | идентификатора) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.6.0 | 1. Добавлены требования к алиасам возвращаемого Потребителю атрибута: | | | | | | - 1.5.1. Поддерживаемые форматы | | | | | | - 1.5.4. Определения Регламентированных SQL-запросов | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.7.0 | 1. Обновлены метаданные подписки и инструменты для управления ими; термин «отмена подписки» заменён на | | | «удаление подписки»; добавлены топики для удаления подписки на потребителе: | | | | | | - 1.4.2. Обмен с использованием Рассылок; | | | | | | - 1.5.3. Подписки Потребителей данных СМЭВ4 на регламентированный запрос типа «Рассылка»; | | | | | | - 1.5.4. Определения Регламентированных SQL-запросов; | | | | | | - 2.5. Протокол взаимодействия Агента СМЭВ4 и Хранилища данных по подписке Потребителя данных; | | | | | | - Приложение 3 2.5. Удаление подписки. | | | | | | 2. Расширено описание процесса получении двоичных объектов в результатах запросов: | | | | | | - 3.3.6. Получение двоичных объектов в результатах запроса | | | | | | 3. Добавлен топик scl.signal для Хранилища данных по подписке и добавлены атрибуты для событий связанных с | | | подписками: | | | | | | - 2.5.1. Перечень топиков брокера сообщений Apache Kafka | | | | | | - Приложение 2 - 3.6. Получение событий от Витрины | | | | | | - Приложение 3 - 2.6. Получение событий от Витрины | | | | | | 4. Убрана информация о кодах событий СЦЛ в сообщениях Витрины, в связи с расширением их перечня и | | | неконтролируемостью на стороне СМЭВ4: | | | | | | - Приложение 2. - 3.6. Получение событий от Витрины | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.8.0 | 1. Добавлена информация о системных параметрах ``settings_for_system_time_started`` и | | | ``settings_for_system_time_finished``: | | | | | | - :numref:`system_param_query` | | | | | | 2. Добавлена информация о запросах с получением печатной формы: | | | | | | - :numref:`sql_request_definition` | | | | | | - :numref:`printable_form_output` | | | | | | - :numref:`terms` | | | | | | 3. Изменено максимальное значение таймаута, задаваемого в SQL-запросе, корректировка терминологии в части | | | вызова запроса с надстройками и без надстроек: | | | | | | - :numref:`consumer_sql_rest_interface` | | | | | | 4. Изменено время хранения результата запроса, вызванного в асинхронном режиме: | | | | | | - :numref:`consumer_sql_rest_interface` | | | | | | 5. Корректировка процесса выполнения запросов к REST-сервису Ответчика: валидация осуществляется Ядром | | | | | | - :numref:`rest_respondent_registration` | | | | | | - :numref:`interaction_without_large_request` | | | | | | 6. Оптимизация документа. Удалены разделы с описанием технических деталей: | | | | | | - 2.1. Протокол СМЭВ4 | | | | | | - 2.3.1 Перечень заголовков сообщений в Apache Kafka | | | | | | - 2.3.4 Последовательность исполнения SQL-запроса в контуре Поставщика данных | | | | | | - 2.5.2 Структуры сообщений для взаимодействия с Потребителем данных | | | | | | - 3.3.2 Преобразование исходного запроса | | | | | | - 3.5. Формирование и передача статистики атрибутов Витрины данных Агенту СМЭВ4 | | | | | | - Приложение 2 Структуры сообщений для взаимодействия с Поставщиком | | | | | | - Приложение 3 Структуры сообщений для взаимодействия с Потребителем данных | | | | | | 7. Оптимизация документа. Подготовлено описание без технических деталей: | | | | | | - :numref:`rz_exchange_description` | | | | | | - :numref:`terms` | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.9.1 | 1. Добавлена информация о лимитировании запросов в СМЭВ4: | | | | | | - :numref:`limiting_requests` | | | | | | 2. Убрана информация об управлении подписками через ВС: | | | | | | - :numref:`distribution_subscription` | | | | | | 3. Доработка документа. Скорректировано описание типов атрибутов и параметров: | | | | | | - :numref:`supported_formats` | | | | | | 4. Доработка документа. Указан заголовок с версией протокола REST-интерфейса Агента СМЭВ4 для SQL-запросов: | | | | | | - :numref:`consumer_sql_rest_interface` | | | | | | 5. Удален раздел "Приложение 1 Пример проекта для реализации взаимодействия с Агентом СМЭВ4" | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.10.0 | 1. Добавлена информация об ограничении на использование запросов с надстройками: | | | | | | - :numref:`sql_request_definition` | | | | | | - :numref:`consumer_protocol` | | | | | | - :numref:`executing_rules` | | | | | | 2. Оптимизация и актуализация документа: | | | | | | - Удалён раздел "Примеры реализации взаимодействия с Агентом СМЭВ4 с использованием брокера | | | сообщений Apache Kafka" | | | | | | - Введены термины "право доступа" и "полномочие". Текст приведён в соответствие с этими терминами. | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.11.0 | 1. Добавлена информация о возможности приостановки обмена по подписке: | | | | | | - :numref:`distribution_interaction_description` | | | | | | 2. Добавлена информация о возможности передачи мнемоники ИС Инициатора запроса Ответчику: | | | | | | - :numref:`respondent_rest_services` | | | | | | - :numref:`respondent_response` | | | | | | 3. Добавлена информация об ограничении времени исполнения запросов на получение BLOB по ссылке и к REST-сервису: | | | | | | - :numref:`blob_sql_request` | | | | | | - :numref:`respondent_request` | | | | | | 4. Оптимизация и актуализация документа: | | | | | | - Удалён раздел "Настройка Агента СМЭВ4 для работы с Витринами данных" | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.12.0 | 1. Обновлены схемы: | | | | | | - на схемах заменено название Агент ПОДД на Агент СМЭВ4 | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.12.1 | 1. Добавлена рекомендация по использованию запроса на удаление результата асинхронно вызванного запроса | | | и его структура: | | | | | | - :numref:`consumer_sql_async_request` | | | | | | - :numref:`consumer_async_sql_delete_response` | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.13.0 | 1. Обновлено описание и схема процесса обработки запроса к REST-сервису Ответчика с учётом возможности проверки | | | полномочий (см :numref:`interaction_with_large_request`) | | | | | | 2. Расширено описание поддерживаемых системных параметров с номерами операций (см :numref:`system_param_query`) | | | | | | 3. Добавлена спецификация REST-интерфейса Агента СМЭВ4 для выполнения запросов к Витринам Поставщиков данных, а | | | также обновлены примеры запросов в формате curl (см :numref:`consumer_sql_rest_interface`) | | | | | | 4. Добавлено описание возможности по сохранению запросов и ответов при запросах к REST-сервису Ответчика: | | | | | | - (см :numref:`respondent_rest_services`) | | | | | | - (см :numref:`storage_request_response_access`) | | | | | | 5. Перечень типовых ошибок, коды возврата и пути решения вынесены отдельно в :numref:`annex_at` | | | | | | 6. Добавлено описание профиля витрины | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.15.0 | Оформление документа, минорные исправления | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.16.0 | 1. Добавлена функция полнотекстового поиска, при информационных обменах | | | с использованием Регламентированных SQL-запросов (см :numref:`full_text_search_output`) | | | | | | 2. Добавлена функция задания последовательности выполнения подзапросов, | | | при информационных обменах с использованием распределенных Регламентированных SQL-запросов | | | (задается в ЕИП НСУД) (см :numref:`rz_exchange_description` и :numref:`sql_request_definition`) | | | | | | 3. Удалено описание информационного обмена с использованием REST-РЗ по старому протоколу взаимодействия | | | (без возможности отправки запросов более 5 Мб) для Агентов старше 3.8.0 | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.17.0 | 1. Добавлено описание возможности по сохранению SQL-запросов (см :numref:`rz_exchange_description`) | | | | | | 2. Удалено описание устаревших топиков kafka в описании взаимодействия Агент-Витрина | | | (см :numref:`tab_broker_topics_name`) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.18.0 | 1. Поддержка дополнительных вариантов синтаксиса FOR SYSTEM_TIME в SQL-РЗ (см :numref:`sql_syntax`) | | | | | | 2. Оформление документа, минорные исправления | | | | | | 3. Поддержка функции LISTAGG в SQL-РЗ (см :numref:`sql_syntax`) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.19.0 | 1. Указаны требования к версиям типового ПО для обеспечения работоспособности новых функций СМЭВ4 | | | | | | 2. Добавлено правило создания представлений (см :numref:`view_create_rule`) | | | | | | 3. Минорные исправления оформления документа | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.20.0 | 1. Детализировано описание запросов печатных форм (см. :numref:`distribution_providers_requirements`, | | | :numref:`sql_rz_content`, :numref:`rules_use` и :numref:`printable_form_output`) | | | | | | 2. Добавлено описание пользовательского таймаута, задаваемого в конфигурации Агента Потребителя | | | (см. :numref:`consumer_sql_rest_interface`) | | | | | | 3. Добавлено описание пользовательского таймаута в запросах к REST-сервису ИС Ответчика | | | (см. :numref:`rest_service_output`) | | | | | | 4. Изменено описание версии в запросе выполнения SQL-РЗ (см. :numref:`sync_broker_connect`) | | | | | | 5. Исключен раздел 1.5.7.5 | | | | | | 6. Минорные исправления оформления документа | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.20.1 | 1. Удалены дублирующиеся сноски | | | | | | 2. Исправлены орфографические и синтаксические ошибки | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.21.0 | 1. Удалены упоминания протокола взаимодействия между Агентом СМЭВ4 и Ядром СМЭВ4 Apache Pulsar | | | | | | 2. Добавлен параметр для определения формата возвращаемых в ответе на запрос данных при взаимодействии ИС и | | | Агента СМЭВ4 через REST-интерфейс (см. :numref:`consumer_sql_rest_interface`) | | | | | | 3. Добавлено описание оптимизации SQL-запросов (см. :numref:`sql_rz_content` и :numref:`rules_use`) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.22.0 | 1. Уточнено определение запроса с надстройками: | | | | | | - (см. :numref:`terms`) | | | | | | - (см. :numref:`rules_use`) | | | | | | - (см. :numref:`executing_rules`) | | | | | | - (см. :numref:`sync_pulsar_connect`) | | | | | | - (см. :numref:`async_post_pulsar_connect`) | | | | | | - (см. :numref:`tp_pulsar_connect`) | | | | | | 2. Добавлена необходимость установки настройки subQueryParamSupport: "DYNAMIC_PARAM_SUPPORT" профиля Витрины | | | при использовании Агента СМЭВ4 совместно с Сервисом проверки полномочий Prohibitor | | | (см. :numref:`datamart_profile`) | | | | | | 3. Добавлено описание времени жизни для ссылок на двоичные объекты (см. :numref:`binary_objects_output`) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.23.0 | 1. Добавлены типовые ошибки при блокировке участников взаимодействия (см. :numref:`annex_at`) | | | | | | 2. Поддержка ``FOR SYSTEM_TIME RAW`` синтаксиса SQL-РЗ (см :numref:`sql_syntax`) | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.24.0 | Изменений нет | +---------+------------------------------------------------------------------------------------------------------------------+ | 3.25.0 | 1. Удалена оптимизация для простых запросов: | | | | | | - (см. :numref:`sql_rz_content`) | | | | | | - (см. :numref:`rules_use`) | | | | | | 2. Добавлена возможность обеспечения юридической значимости обменов: | | | | | | - (см. :numref:`rz_exchange_description`) | | | | | | - (см. :numref:`rest_exchange_description`) | | | | | | - (см. :numref:`sql_rz_content`) | | | | | | - (см. :numref:`respondent_rest_services`) | | | | | | 3. Добавлено описание нового типа информационного обмена Регламентированный SQL-запрос с категорией «Рассылка | | | (для Компонента «Витрина данных» версии 2.x)» | +---------+------------------------------------------------------------------------------------------------------------------+