Обновление Qlik Data Gateway — Direct Access

Новые функции и улучшения

В Direct Access Gateway 1.6.5 добавлены следующие новые функции и улучшения:

• Поддержка коннектора SAP ODP

  В этой версии добавлена возможность доступа к SAP ODP через Direct Access Gateway. Для упрощения доступа добавлено новое поле Шлюз данных в коннектор SAP ODP. Новое поле позволяет выбирать, какой шлюз использовать для доступа к источнику SAP ODP.

  См. также: Коннектор SAP ODP (только английский язык)

• Расширенные функции ведения журнала

  В этой версии представлено новое средство ведения журнала, которое служба поддержки Qlik может использовать для поиска и устранения неполадок с определенными компонентами шлюза.

• Новый поддерживаемый регион

  Япония теперь поддерживается в качестве региона клиента Qlik Cloud.

• Повышение производительности

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

Устранение проблем

Direct Access Gateway 1.6.5 устраняет следующие проблемы:

• Уязвимость системы безопасности

  При работе с коннектором ODBC секреты записываются в журнал DCAAS.

• Производительность изоляции процессов

  При большой нагрузке требуется много времени на запуск процесса.

• Неправильный путь установки

  При установке Direct Access Gateway в качестве корневой папки всегда используется Qlik, даже если пользователь выбирает другую папку в мастере установки.

Новые функции и улучшения

• Поддержка просмотра и загрузки файлов журналов из Консоль управления

  В этой версии реализована возможность просматривать файлы журнала Direct Access Gateway в Консоль управления и при необходимости отправлять их в службу поддержки Qlik. В нормальных обстоятельствах нет причин просматривать файлы журналов, но если возникают повторяющиеся сбои или другие проблемы, то журналы часто помогают выявить их причину.

  См. также: Просмотр и загрузка файлов журналов

• Поддержка установки Direct Access Gateway без взаимодействия с пользователем

  Теперь появилась возможность установки Direct Access Gateway без взаимодействия с пользователем. Это удобно, если требуется установить Direct Access Gateway на несколько компьютеров в организации.

  См. также: Установка Direct Access Gateway без взаимодействия с пользователем

• Улучшена непрерывность сеанса

  Когда истекает время сеанса перезагрузки, иногда появляется ошибка DirectAccess-1012. Теперь Direct Access Gateway будет предпринимать попытку подлить сеанс перезагрузки путем более частой проверки связи с Qlik Cloud.

Устранение проблем

Direct Access Gateway 1.6.4 устраняет следующие проблемы:

• Неправильное имя параметра в файле configuration.properties

  При выполнении новой установки Direct Access Gateway имя параметра EXTEND_FIRST_REQUEST_TIMEOUT в файле configuration.properties неправильно указывалось как FIRST_REQUEST_TIME_EXTENSION.

• Доступность объекта pod перезагрузки

  Когда несколько перезагрузок имеют одинаковый идентификатор перезагрузки, количество объектов pod перезагрузки в QCS достигает максимума.

Direct Access Gateway 1.6.3 включает следующие улучшения и исправления ошибок:

• Предотвращение потери данных

  В предыдущих версиях с целью предотвращения потенциальной потери данных Direct Access Gateway не выполнял автоматическое переподключение к источнику данных во время перезагрузки. Начиная с этой версии Direct Access Gateway автоматически восстанавливает подключение к источнику данных при необходимости. С целью предотвращения потери данных перед повторным подключением проверяется сводка выполненной перезагрузки. В случае обнаружения потери данных перезагрузка завершится ошибкой.

• Тайм-аут для сеансов перезагрузки

  В редких сценариях сеанс перезагрузки остается активным бесконечно. С целью предотвращения этого в данной версии введен трехчасовой тайм-аут для сеансов перезагрузки.

• Продление тайм-аута для запросов загрузки

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

  Connector error: The session does not exist (DirectAccess-1509)

  Connector error: The stream session expired for the load data request (DirectAccess-1012)

  Чтобы решить эту проблему, добавлен параметр EXTEND_FIRST_REQUEST_TIMEOUT в файл configuration.properties (для продления тайм-аута запроса загрузки). Значение по умолчанию ― 0. Пользователям, у которых часто возникают эти ошибки, следует задать тайм-аут 5-10 минут.

• Поддержка подробных сообщений об ошибках подключения

  Добавлена поддержка для просмотра подробных сообщений об ошибках подключения при использовании коннекторов на базе ODBC через Direct Access Gateway. Теперь пользователи могут задать параметру ShowErrorDetailMessage значение true (истина) в расширенных параметрах коннектора, чтобы посмотреть полный текст ошибки, возвращенный драйвером ODBC. Подробное сообщение об ошибке отображается в редакторе загрузки данных.

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

• Обработка нескольких перезагрузок с одним ИД перезагрузки

  Начиная с этой версии идентификатор сеанса подсистемы будет использоваться, чтобы различать несколько перезагрузок с одинаковым идентификатором перезагрузки. Это предотвратит потенциальные конфликты, которые могут приводить к следующей ошибке перезагрузки:

  Connector error: data loading error (DirectAccess-4008

Direct Access Gateway 1.6.2 решает проблему, в результате которой иногда происходил сбой агента коннектора при работе в режиме изоляции процесса.

Новые функции и улучшения

В Direct Access Gateway 1.6.1 добавлено несколько важных функций и улучшений, которые повышают уровень стабильности и производительности.

• Поддержка распространения перезагрузок в рамках нескольких процессов коннектора

  В Direct Access Gateway добавлена изоляция процессов коннектора. Эта функция включается по выбору, то есть по умолчанию она не работает. Изоляция процессов позволяет администраторам, которые имеют прямой доступ к операционной системе сервера шлюза, контролировать количество процессов, доступных для перезагрузок по типу коннекторов. Распространение перезагрузок по нескольким процессам коннектора повышает степень изоляции путем уменьшения количества перезагрузок, выполняемых одновременно для каждого процесса коннектора. Это, в свою очередь, улучшает общую стабильность Direct Access Gateway в случаях, когда коннектор неожиданно завершает работу.

  См. также: Сокращение случаев сбоя коннектора во время перезагрузки

• Добавлена возможность отключать разделение данных на блоки при работе с коннектором SAP BW (через Direct Access Gateway)

  Данная версия включает параметр приложения BEX_ONE_CHUNK для коннектора SAP BW (через Direct Access Gateway). При прямом обращении к SAP BW через Qlik Cloud (то есть не через Direct Access Gateway) с целью оптимизации производительности набор результатов делится на блоки в серверной части SAP и считывается в виде отдельных потоков. Однако при обращении к SAP BW через Direct Access Gateway разделение набора результатов на блоки не обеспечивает реального преимущества. Напротив, в результате этого потребляется больше общей памяти в SAP, так как необходимо создавать дополнительную временную таблицу, которая существует в течение всего времени передачи данных. Можно (хотя обычно не требуется) включить деление на блоки, настроив BEX_ONE_CHUNK:false в файле appsettings.json, который находится в папке binaries коннектора SAP.

• Улучшения диагностики для SAP SQL (через Direct Access Gateway) и SAP BW (через Direct Access Gateway)

  Для журналов коннекторов SAP BW (через Direct Access Gateway) и SAP SQL (через Direct Access Gateway) добавлялся суффикс _port после имени файла журнала перед расширением, и в файлы журнала коннектора добавлялось сообщение ProcessID=###, чтобы отличать события новых экземпляров коннектора, прослушивающих тот же порт.

• Улучшения повторного подключения

  Механизм повторного подключения во время перезагрузки улучшен, благодаря чему Direct Access Gateway больше не нужно подключаться к объекту pod, который запускал перезагрузку (как было раньше). Сейчас вместо многократных попыток подключения к объекту pod, запустившему перезагрузки (что часто приводило к ошибкам перезагрузки), он будет подключаться к первому доступному объекту pod.

Устранение проблем

Direct Access Gateway 1.6.0 устраняет следующие проблемы:

• Журнал коннектора ODBC (через Direct Access Gateway):

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

• Отсутствие файла при настройке

  Файл configuration.properties не скопирован во время установки Direct Access Gateway.

• Ошибка перезагрузки при масштабировании ресурса Qlik Cloud

  Масштабирование ресурсов Qlik Cloud иногда приводит к ошибке DirectAccess-1006. Улучшена обработка определенных сценариев масштабирования ресурсов Qlik Cloud, которые имеют место во время перезагрузки приложений через Direct Access Gateway.

• Ошибка подключения Snowflake

  Не удается установить подключение к Snowflake через ODBC (через Direct Access Gateway).

• Ошибка отладки скрипта приложения в DLE

  Отладка скриптов приложения в редакторе загрузки данных (DLE) с включенным параметром Ограничить результаты иногда завершается следующей ошибкой:

  Connector error: Invalid load request (DirectAccess-1006).

Решенные проблемы:

• Коннектор ODBC (через шлюз Direct Access Gateway): коннектор иногда неожиданно завершает работу при отмене перезагрузки больших таблиц. Реализовано улучшение для предотвращения такого поведения.

• Коннектор Microsoft SQL Server (через шлюз Direct Access Gateway): попытка установить подключение к серверу SQL Server, размещенному на более ранних версиях сервера Windows Server, завершается неудачно из-за проблемы совместимости TLS, при этом возвращается следующее сообщение об ошибке:

  Please check the values for Username‚ Password‚ Host and other properties. Description: Client unable to establish connection - ERROR [08001] [Qlik][SqlServer] Problem establishing connection to the server.

  С целью устранения этой проблемы обновлен драйвер SQL Server.

• Коннектор SAP SQL (через Direct Access Gateway): при попытке предварительного просмотра таблицы иногда появляется следующее сообщение об ошибке:

  Exception of Type System.OutOfMemoryException

• Коннектор SAP SQL (через шлюз Direct Access Gateway): иногда попытка предварительного просмотра таблицы завершается тайм-аутом спустя несколько минут, при этом появляется следующее сообщение об ошибке:

  Request could not be completed.

• Коннекторы SAP SQL (через шлюз Direct Access Gateway) и SAP BW (через шлюз Direct Access Gateway): в журналы добавлена диагностическая информация для упрощения поиска и устранения неисправностей при обработке нескольких параллельных запросов.

Новые функции и улучшения:

• Обеспечена поддержка нового коннектора ODBC (через шлюз Direct Access Gateway) (только английский язык).

• В столбце Версия в Консоль управления теперь отображается версия Direct Access Gateway, а не версия RepAgent (один из субкомпонентов).

Решенные проблемы:

• При обновлении шлюза Direct Access Gateway восстанавливаются настройки журналов коннектора ODBC по умолчанию (например, период хранения и максимальный размер файлов журнала).
• В редких случаях коннектор ODBC неожиданно завершает работу, и агент Direct Access Gateway не может его перезагрузить.
• Когда не удается установить подключение или запрос SQL недействительный, вместо сообщения с указанием фактической причины ошибки возвращается общее сообщение об ошибке «Смещение и длина были за пределами...».
• В редких сценариях перезагрузка хаба завершается ошибкой DirectAccess-4008 для приложений размером больше 3 ГБ, у которых были длительные периоды задержки или обработки после первоначального запроса шлюза. Добавлены расширенные функции журнала для идентификации связанных проблем.

Решенные проблемы:

• Изменение значения ODBC_LOG_LEVEL в файле C:\ProgramData\Qlik\Gateway\configuration.properties не будет иметь силы.

• Перезагрузка завершится следующей ошибкой, если активное подключение к шлюзу прямого доступа не использовалось в течение нескольких минут:

  Connector error: Invalid load request (DirectAccess-1006)

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

• Иногда загрузка таблиц, содержащих много столбцов, из MySQL и PostgreSQL завершается следующей ошибкой:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Если у пользователей не было привилегий в управляемом пространстве, содержащем шлюз прямого доступа, появлялась следующая нечетко сформулированная ошибка:

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Object reference not set to an instance of an object.

  Сообщение об ошибке было доработано с использованием более точного описания проблемы.

• Многократные попытки перезагрузки иногда завершаются ошибкой из-за чрезмерного потребления памяти.

Функции и улучшения:

Direct Access Gateway периодически проверяет работоспособность. Начиная с этой версии при проверке работоспособности выполняется перезапуск службы Direct Access Gateway, если она не отвечает в течение пяти минут.

Решенные проблемы:

• Когда запускается перезагрузка с использованием запроса, который возвращает метаданные немедленно, но при этом возвращает первый блок данных через несколько минут, иногда появляется следующая ошибка:

  Connector error: data loading error (DirectAccess-4008)

• В определенных сценариях, Direct Access Gateway не восстанавливает подключение к Qlik Cloud после того, как прерывается перезагрузка данных.

• В редких ситуациях во время перезагрузки возникает следующая ошибка:

  No connection could be made because the target machine actively refused it.

• При подключении к серверу SQL Server специальные символы в паролях кодируются неправильно, в результате чего возникает следующая ошибка:

  Command test connection returned non-success: Error message: Please check the values for Username‚ Password‚ Host and other properties. Description: Access credentials are not valid for this connection.

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

• В редких сценариях, связанных с большой нагрузкой, иногда перезагрузка данных завершается следующей ошибкой:

  Connector error: Unknown reason:. Index was outside the bounds of the array. (DirectAccess-1500)

Обновлены сертификаты ЦС, необходимые для проверки подлинности клиента Qlik Cloud.

В данной версии устранена следующая проблема.

Qlik Data Gateway — Direct Access 1.3.1 имеет предрасположенность к чрезмерному потреблению ресурсов ЦП в определенных сценариях. Версия 1.3.2 решает эту проблему и не содержит других изменений. Чтобы предотвратить сбои, связанные с ЦП, всем пользователям рекомендуется немедленно выполнить обновление до версии.

Эта версия включает пакет ЦС для Qlik Cloud для правительства и исправляет несколько проблем.

Файл пакета ЦС для Qlik Cloud для правительства

Пакет ЦС проверяет подлинность удостоверения клиента Qlik Cloud, тем самым обеспечивая доверенное подключение.

В предыдущих версиях Direct Access Gateway файл пакета ЦС для пользователей Qlik Cloud для правительства предоставлялся Qlik по необходимости. Начиная с этой версии файл пакета ЦС включен в установку.

При установке по умолчанию файл пакета ЦС устанавливается в следующее местоположение: C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Устранение проблем

• Обнаружена уязвимость системы безопасности, при которой HTTP-клиент, используемый для подключения к прокси-серверу, мог следовать перенаправлению.

• Иногда агент Direct Access Gateway аварийно завершает работу со следующей ошибкой:

  Unable to write data to the transport connection: An established connection was aborted by the software in your host machine

• При инициализации журнала иногда возникает исключение, что приводит к зависанию Direct Access Gateway при перезапуске.
• Улучшена обработка сеансов перезагрузки, чтобы избежать излишнего времени ожидания.
• Столбец Версия Direct Access Gateway в Консоль управления указывает на неправильную версию.
• Агент продолжал отправлять данные в шлюз после остановки выполнения задачи пользователем или после достижения предела ограничения квоты.
• Сквозное шифрование для шлюза данных не включалось по умолчанию и контролировалось с помощью флагов времени выполнения.

В данной версии устранены проблемы, приведенные ниже.

• При установке версии 1.2 Qlik Data Gateway – Direct Access может возникнуть проблема с цифровой подписью.
• Файлы конфигурации перезаписывались во время обновления, что приводило к потере изменений

Функции и улучшения:

• Добавлена поддержка для источников SAP BW и SAP SQL. Для получения информации о настойке подключения к этим источникам см. SAP NetWeaver (только английский язык).

Решенные проблемы:

• Улучшенная стабильность и восстанавливаемость службы Qlik Data Gateway — Direct Access, исключающая необходимость ручного перезапуска службы
• Поддержка перезаписи параметров установки и конфигурации Direct Access Gateway по умолчанию

Функции и улучшения:

• Добавлена поддержка Windows Server 2022

Решенные проблемы:

• Решена потенциальная проблема стабильности, связанная с выбором пользовательского пути во время установки

1.1.0

18 октября 2022 года

Функции и улучшения:

• Поддержка кошельков Oracle
• Поддержка Google BigQuery
• Улучшенные сообщения об ошибках

Решенные проблемы:

• Улучшена возможность восстановления системы после сбоев драйверов
• Служба Qlik Data Gateway — Direct Access иногда неожиданно останавливалась