Обновление и удаление Шлюз данных Qlik — прямой доступ

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

В этой версии добавлены новые и улучшены старые функции, а также исправлен ряд ошибок.

• Улучшен поиск ошибок благодаря функции распространения конфигурации шлюза

  Конфигурации шлюза можно передать в Qlik Cloud, чтобы ускорить устранение ошибок через службу поддержки Qlik.

• Сохранение сеанса Gloo при повторном подключении после перезагрузки

  При повторном подключении после перезагрузки сессия Gloo восстанавливается на тех же серверах. Это позволяет снизить нагрузку на службы и повышает успешность перезагрузок.

Исправленные ошибки

• Сопоставление типов данных при подключениях на основе DSN

  Сопоставление типов данных теперь работает правильно при подключениях на основе DSN.

• Коннектор файлов с маской списка файлов (Filelist)

  Исправлена ошибка, из-за которой коннектор файлов возвращал ошибку при использовании маски списка файлов для несуществующих файлов.

• Проблема с установкой и обновлением распространяемого пакета C++

  Устранены проблемы с установкой и обновлением, связанные с распространяемым пакетом C++.

• Задержка инициализации коннектора файлов

  Снижена частота возникновения периодических ошибок DirectAccess-5000 и DirectAccess-1510, вызванных задержками инициализации коннектора файлов при включенной изоляции процессов.

• Обновления безопасности

  Компонент libcurl.dll обновлен до версии 8.19.0 в драйверах ODBC (Apache Hive, Cloudera Impala, Apache Phoenix и Snowflake). Компонент OpenSSL обновлен до версии 3.0.20 во всех драйверах ODBC, кроме Presto, Spark, Microsoft SQL Server, MySQL и Google BigQuery, для устранения известных уязвимостей.

• Поддержка файлов RTF в коннекторе файлов

  Исправлена опечатка в FileExtensionValidator, которая препятствовала отображению списка и загрузке файлов RTF.

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

В этой версии добавлены новые и улучшены старые функции, а также исправлен ряд ошибок.

• Расширенная поддержка аутентификации

  Аутентификация Single Sign-On (Kerberos) теперь поддерживается в следующих коннекторах:

  • Apache Hive
  • Cloudera Impala
  • Teradata

  • Microsoft SQL Server

  Кроме того, коннектор Teradata теперь поддерживает аутентификацию LDAP.

• Улучшенная обработка перезагрузок файлового коннектора

  Движок Analytics иногда кэшировал подключения из предыдущих сессий и отправлял запрос в под, получивший запрос на выключение. Это приводило к следующей ошибке перезагрузки:

  Connector error: data loading error (DirectAccess-4008)

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

• Улучшенное журналирование метрик перезагрузки

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

  • Время на передачу через Web Socket в процентном соотношении от продолжительности перезагрузки.
  • Приблизительная оценка скорости передачи данных между источником данных и Direct Access Gateway.
  • Приблизительная оценка скорости передачи данных между Direct Access Gateway и Qlik Cloud.

• Возможность задать число строк, включаемых в один пакет, при использовании коннектора ODBC (через Direct Access Gateway).

  В коннектор ODBC добавлен параметр Число строк, включаемых в один пакет (через Direct Access Gateway). Хотя значение по умолчанию оптимально для большинства сценариев, изменение этого параметра может помочь при возникновении значительных проблем с производительностью.

• Проверка числа строк при перезагрузках

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

• Улучшена обработка ошибок асинхронных команд

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

Исправленные ошибки

• Обновленный распространяемый пакет C++

  Распространяемый пакет C++ обновлен до последней версии.

• Коннектор SAP BW

  Иногда возникала следующая ошибка синтаксического анализа:

  Invalid character: ':' for the timestamp data type.

• Безопасность

  Для устранения известных уязвимостей следующие компоненты Direct Access Gateway были обновлены или удалены:

  • Файл e_sqlite3.dll обновлен до версии 3.50.4.

  • Файл package-lock.json удален из каталога dcaas_gs, так как он не требуется.

• Коннектор ODBC (через Direct Access Gateway) — проблема с предварительным просмотром данных

  При использовании коннектора ODBC (через Direct Access Gateway) предварительный просмотр данных для столбцов, содержащих двойные кавычки, был невозможен.

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

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

• Новые раскрывающиеся списки в диалоговом окне «Выбрать данные для загрузки»

  В редакторе загрузки данных в диалоговом окне Выбрать данные для загрузки (<отображаемое имя коннектора>) теперь можно выбрать базу данных, владельца, роль, каталог и схему. Это относится к следующим коннекторам:

  • Athena Drill (через Direct Access Gateway)

    • Добавлены списки База данных и Владелец.

  • Databricks (через Direct Access Gateway)

    • Добавлены списки Каталог и Схема.

  • Presto (через Direct Access Gateway)

    • Добавлены списки База данных и Владелец.

  • Snowflake (через Direct Access Gateway)

    • Добавлены списки Роль, База данных и Схема.

• Удаление опции Включить чтение большого объема

  Опция Включить чтение большого объема включена по умолчанию и больше не отображается в пользовательском интерфейсе. Ее можно отключить только с помощью внутреннего свойства.

• Минимальная версия TLS

  В раскрывающийся список Минимальный TLS в следующих коннекторах была добавлены версия 1.3:

  • Apache Drill (через Direct Access Gateway)

  • Google Big Query (через Direct Access Gateway)

  • Microsoft SQL Server (через Direct Access Gateway)

Исправленные ошибки

• Непонятное сообщение об ошибке

  В предыдущих версиях при попытке зарегистрировать шлюз в неподдерживаемом регионе Qlik Cloud возникала следующая непонятная ошибка: «SYS-E-ERRMSG, INVALID QCS HOST». Теперь в сообщении об ошибке явно указывается, что ошибка может быть вызвана неподдерживаемым регионом Qlik Cloud.

• Безопасность

  Шлюз данных Qlik — прямой доступ поставляется с уязвимым компонентом SQLite. Для решения этой проблемы System.Data.SQLite обновлен до версии 2.0.2.

• Коннектор ODBC (через Direct Access Gateway)

  Добавление нового сопоставления типов данных через пользовательский интерфейс конфигурации Direct Access Gateway приводило к установке неверного драйвера/идентификатора.

• Сбои подключения Oracle Wallet

  При одновременных перезагрузках подключение Oracle Wallet к базе данных Oracle Cloud иногда завершалось сбоем.

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

Улучшение коннектора ODBC (через Direct Access Gateway)

Вновь открыты параметры конфигурации

Следующие параметры ранее можно было настроить только вручную, изменив файл конфигурации. Теперь они доступны в диалоговом окне Настройки шлюза для <gateway-name>:

• Разрешение только определенных DSN

• Разрешение только определенных драйверов

• Настройка сопоставления типа данных

Поддержка разделения имен таблиц

Если имена таблицы содержат заглавные буквы или специальные символы, некоторые источники данных требуют разделения таких имен в скрипте загрузки. В противном случае произойдет ошибка. Новая опция Delimit table names устраняет необходимость вручную добавлять разделители в скрипт загрузки при загрузке или предварительном просмотре данных.

Подробнее см. Создание подключения ODBC (через Direct Access Gateway) (только английский язык).

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

По соображениям безопасности стандартное сообщение об ошибке, возвращаемое драйвером ODBC, содержит минимум информации. Однако в некоторых случаях для устранения проблемы необходимо больше информации. Ранее это можно было сделать в диалоговом окне коннектора, добавив свойство ShowErrorDetailMessage в раздел Расширенные со значением True. Теперь можно установить флажок Показать подробное сообщение об ошибке в диалоговом окне Настройки шлюза.

Подробнее см. Показать подробное сообщение об ошибке.

Поддержка изменения настроек изоляции процессов без перезапуска службы шлюза

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

Улучшения журналирования

• Уменьшено избыточное журналирование, если не заданы параметры AGENT_LOG_LEVEL=DEBUG и AGENT_LOG_OPTIONS.

• Журналы агента-коннектора, регистрирующие перезагрузки файлового коннектора, теперь показывают фактическое значение AppId вместо AppId=dummyDocId.

Расширенная поддержка асинхронных команд

Поддержка асинхронных команд повышает эффективность, так как Direct Access Gateway может обрабатывать несколько команд одновременно, а не по одной за раз. Ранее, если целевой командный модуль (command pod) на Qlik Cloud был недоступен для обработки запроса, Direct Access Gateway продолжал отправлять запрос на тот же модуль вместо того, чтобы завершиться с ошибкой. После 10 неудачных попыток выводилась общая ошибка; фактическая причина сбоя оставалась неясной.

Телеметрия Qlik

Ко всем ответам команды агента-коннектора (через HTTP POST) был добавлен заголовок UserAgent. Это позволит повысить эффективность тегов при использовании шлюза Direct access gateway в телеметрии Qlik.

Формат заголовка:

qlik-direct-access-gateway/version

Пример:

qlik-direct-access-gateway/1.7.10

Исправленные ошибки

Безопасность

• Возможное выполнение произвольного кода программами установки WIX из-за перехвата COM-объектов с помощью HKCU\Software\Classes\WOW6432Node. Исправление проверяет разделы реестра перед запуском программы установки.

• Версия zlib, установленная с Qlik Data Gateway, содержит известные уязвимости. Проблема решена путем обновления до версии без известных уязвимостей.

Сбой коннектора SAP BW

Коннектор SAP BW завершался сбоем, если входной параметр Infoprovider был закомментирован в скрипте выбора и использовался в качестве фильтра условий.

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

Новая опция «Delimit column names» для коннектора ODBC (через Direct Access Gateway)

Некоторые источники данных требуют разделения в скрипте загрузки имен столбцов, содержащих заглавные буквы или специальные символы. В противном случае произойдет ошибка. Новая опция Delimit column names устраняет необходимость вручную добавлять разделители в скрипт загрузки при загрузке или предварительном просмотре данных.

Подробнее: Создание подключения ODBC (через Direct Access Gateway) (только английский язык).

Поддержка квоты для данных метрик, хранящихся на машине Direct Access Gateway

Новое свойство localDataRetentionDatabaseSizeInMb в коллекторе метрик позволяет установить квоту на общий размер данных метрик, хранящихся на машине шлюза (в МБ). Старые данные будут удалены, чтобы не допустить превышения квоты.

Коллектор метрик можно настроить локально в файле JSON или через публичный API.

Более полное описание см. в разделе Коллектор метрик.

Исправленные проблемы безопасности

• Среда выполнения Node.js обновлена до версии 22.x из-за известной уязвимости в версии 20.19.5.

• Файл libcurl.dll обновлен до версии 8.16.0 из-за известных уязвимостей в версии 8.7.0.

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

Поддержка механизма авторизации Application Default Credentials OAuth через Google BigQuery

В этой версии добавлена поддержка механизма OAuth Application Default Credentials при использовании коннектора Google BigQuery (через Direct Access Gateway).

Подробное описание см. в разделе Создание подключения Google BigQuery (только английский язык).

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

Добавлены две новые опции к свойству конфигурации Изоляция процессов: Все и Метаданные. Опция Все позволяет включить изоляцию процессов как для команд перезагрузки, так и для команд метаданных, в то время как опция Метаданные позволяет включить изоляцию процессов только для команд метаданных. Это может быть полезно в ситуации, когда команды метаданных должны выполняться параллельно (как правило, для предварительного просмотра), но драйвера ODBC не поддерживают многопоточность, .

Новые параметры доступны в пользовательском интерфейсе конфигурации или через публичный API.

См. также: Изоляция процессов

Поддержка регионов Бразилия (br) и Франция (fr)

Теперь Direct Access Gateway можно использовать в регионах клиента Qlik Cloud «Бразилия» (br) и «Франция» (fr).

Коллектор метрик

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

Новый коллектор метрик (который работает в фоновом режиме на машине Direct Access Gateway) предлагает базовые инструменты для журналирования и мониторинга ресурсов, используемых Direct Access Gateway, коннекторами и операционной системой. Коннектор метрик можно настроить локально в файле JSON или через публичный API.

Более полное описание см. в разделе Коллектор метрик.

Исправленные ошибки

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

Requested endpoint could not be provisioned due to failure to acquire a load slot: The load slot request could not be decrypted. The load slot request could not be decrypted (DirectAccess-1707)

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

Поддержка обновленных параметров аутентификации Databricks OAuth

Коннектор Databricks был дополнен двумя дополнительными механизмами аутентификации, которые теперь поддерживаются в Direct Access Gateway:

• Databricks OAuth Service Principal

• Databricks OAuth User Account

Эти механизмы используют стандартный поток OAuth 2.0, который поддерживается учетными записями, управляемыми через Databricks или Microsoft Entra ID.

Более подробную информацию см. в разделе Создание подключения Databricks (только английский язык).

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

Если активен механизм изоляции процессов, можно переопределить стандартный порт запуска (49152), через который Direct Access Gateway обменивается данными со всеми изолированными процессами коннектора. Это может быть полезно, когда стандартный порт используется другим процессом. Чтобы переопределить порт, укажите в свойстве DATA_PORT_RANGE_START нужный порт, отредактируйте файл configuration.properties или же измените порт через публичный API.

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

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

• SAP SQL коннектор: ошибка при загрузке таблицы, содержащей элемент данных UTCL

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

  Status (StatusCode="InvalidArgument", Detail="Input string was not in a correct format.

• Периодические возникали ошибки при использовании механизма восстановления блоков (чанков)

  При перезагрузке периодически возникали сбои со следующей ошибкой:

  Object reference not set to an instance of an object. (DirectAccess-1513))

• Коннектор SAP BW: проблема с извлечением данных

  При извлечении данных из SAP BW InfoProvider/ADSO возвращалось ноль строк, если в операторе WHERE было указано два значения.

• Ошибки подключения gRPC, из-за которых возникали ошибки в Direct Access-1510

  В редких случаях возникали ошибки подключения gRPC, которые приводили к ошибкам в Direct Access-1510. Для устранения этой проблемы было реализовано следующее:

  • Был добавлен вызов gRPC, проверяющий, что порт доступен для подключения gRPC

  • Канал gRPC создается сначала, если соединение было отклонено коннектором

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

Поддержка коннектора SAP Report

Начиная с этой версии, пользователи могут обращаться к коннектору SAP Report через Шлюз данных Qlik — прямой доступ.

Использование коннектора SAP Report (только английский язык)

Поддержка Direct Access Gateway с Qlik Cloud Government DoD

В этой версии добавлена поддержка для использования Direct Access Gateway с Qlik Cloud Government DoD.

Устранение задержек, вызванных преобразованием DNS

Начиная с этой версии, связь между сервисами теперь будет осуществляться с использованием loopback в IPv4-адресе (127.0.0.1) вместо localhost. Это должно эффективно устранить любые задержки, возникающие при преобразовании DNS.

Настройка параметров запуска коннектора

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

Настройка запуска коннектора

Запрос слотов загрузки в асинхронном режиме

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

Запрос слотов загрузки в асинхронном режиме

Новое место хранения журналов установки

Теперь файлы журнала установки хранятся в <папке установки Direct Access Gateway>\data\logs — там же, где и другие файлы журналов Direct Access Gateway.

В предыдущих версиях файлы журнала установки хранились в C:\Users\<пользователь>\AppData\Local\Temp. Все журналы, которые хранятся в этой папке, будут скопированы в новую папку во время обновления.

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

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

• Поддержка уменьшения размера столбца при определении специальных сопоставлений типов в коннекторе ODBC (через шлюз Direct Access)

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

• Время ожидания команды

  Длительное выполнение команд, превышающее установленное по умолчанию время ожидания 45 секунд, приводит к отключению командного канала. Эта проблема была решена путем блокировки срабатывания по истечении времени ожидания, если в этот момент брокер подключений Qlik Cloud Service передает команду агенту коннектора Direct Access Gateway.

• Пользовательский интерфейс конфигурации — кнопка сохранения отключена

  Кнопка Сохранить была отключена из-за неверного значения MAX_PROCESSES_COUNT. Проблема была решена путем автоматической подстановки в поле правильного значения.

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

  • Начальное значение поля Количество параллельных процессов перезагрузки отличалось от значения по умолчанию, отображаемого в пользовательском интерфейсе, в следующих коннекторах: ODBC, SAP BW, SAP SQL, SAP ODP и REST.

  • Начальное значение в режиме Изоляция процесса для коннектора типа «Файл» отличалось от значения по умолчанию, отображаемого в пользовательском интерфейсе.

• Режим аутентификации Microsoft SQL Server NTLM не работает

  Режим аутентификации Microsoft SQL Server NTLM не работает при использовании версии Direct Access Gateway 1.7.6.

• Ошибки перезагрузки при большой нагрузке

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

  Connector error: The gRPC connection to the connector failed. ... (DirectAccess-1510)

  Эта проблема была решена путем добавления механизма повторной попытки.

• Периодические ошибки перезагрузки в некоторых сценариях

  Перезагрузки иногда завершались со следующими ощибками:

  • DirectAccess-4002: проблема была решена путем уменьшения значения по умолчанию свойства AGENT_DATA_PING_SKIP_THRESHOLD_SECONDS с 60 до 15 секунд.

  • DirectAccess-2208: проблема была решена путем добавления механизма повторной попытки.

Коннектор файлов (через Direct Access Gateway): Ограничение доступа к файловой системе для определенных пространств

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

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

Общедоступный API

Коннектор файлов (через Direct Access Gateway) (только английский язык)

Поддержка применения изменений без перезапуска шлюза

Начиная с этой версии, при обновлении разрешенных путей/URL-адресов для коннекторов файлов (через Direct Access Gateway) и REST (через Direct Access Gateway) вам больше не нужно перезапускать службу Direct Access Gateway для применения изменений. Это также относится к изменениям следующих свойств ODBC (через Direct Access Gateway):

• Разрешенные драйверы

• Разрешенные DSN

• Пользовательские сопоставления типов

Коннектор Oracle (через Direct Access Gateway): поддержка метода подключения Oracle TNS Names

Эта версия добавляет поддержку доступа к Oracle с использованием TNS Names.

Создание подключения Oracle (только английский язык)

Коннектор File (через Direct Access Gateway): изоляция процессов включена по умолчанию

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

Изоляция процессов

Разрешение подключений к localhost с использованием коннектора REST (через Direct Access Gateway)

Теперь вы можете разрешить коннектору REST (через Direct Access Gateway) подключаться к localhost. Это упрощает использование локальных (для сервера шлюза) конечных точек REST, например, использование конечной точки connector-agent/ status для определения активного количества загрузок на агенте.

Это также настраивается с помощью общедоступного API при добавлении локальных URL-адресов (например, http://localhost:5050/status) в файл restconnector_allowed_urls.txt.

Разрешение подключений к localhost с помощью REST-коннектора (через Direct Access Gateway)

Общедоступный API

Поддержка использования общедоступного API для асинхронного выполнения запросов "загрузки данных"

Асинхронное выполнение запроса на загрузку данных в агенте значительно сокращает время ожидания облачным сервисом ответов от агента.

Эта функциональность, представленная в Direct Access Gateway 1.7.5, теперь доступна через общедоступный API с использованием параметра OPTIONAL_CAPABILITIES.

Общедоступный API

Улучшения изоляции процессов в сценариях с высокой нагрузкой

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

• Конфликты портов коннектора при включенной изоляции процессов

• Чрезмерно частые попытки запустить процесс коннектора

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

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

• Коннекторы Oracle (через Direct Access Gateway) или ODBC (через Direct Access Gateway): Избыточные вызовы метаданных

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

• Снижение производительности из-за чрезмерного времени получения метрик шлюза

  Для каждого запроса на перезагрузку получаются метрики шлюза. Время, затраченное на получение метрик (~200 мс), влияло на длительность перезагрузки. Проблема была решена путем получения метрик каждые 15 секунд вместо каждого запроса на загрузку.

• Коннектор AWS Athena (через Direct Access Gateway): Сбой перезагрузки при попытке перезагрузить имена таблиц или столбцов с японскими символами

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

  Unable to show the preview column data. User does not have permission to access data, or column data type is not supported.

• Коннектор Google BigQuery (через Direct Access Gateway): Невозможность добавить данные с помощью Data Manager

  При использовании коннектора Google BigQuery (через Direct Access Gateway) возникала ошибка «Не удалось добавить данные» при попытке добавить данные с помощью Data Manager.

• Уточнение пароля при установке Direct Access Gateway под учетной записью LocalSystem

  Поле Пароль в установщике Direct Access Gateway заставляло некоторых клиентов думать, что пароль всегда требовался при установке Direct Access Gateway под учетной записью пользователя LocalSystem. Для решения этой проблемы следующий уточняющий текст был добавлен в установщик:

  A password is only required if you are not using the default local system account.

Добавлен контекст ведения журнала для вызовов предварительного просмотра метаданных

Для помощи в устранении неполадок при перезагрузке в журналы вызовов предварительного просмотра метаданных добавлены следующие поля: requestguid, sessionid и datasourceid.

Добавлена поддержка поля «Определяемые пользователем учетные данные» в коннекторы MongoDB (посредством Direct Access Gateway) и Google BigQuery (посредством Direct Access Gateway).

В коннекторы MongoDB (посредством Direct Access Gateway) и Google BigQuery (посредством Direct Access Gateway) добавлено поле «Определяемые пользователем учетные данные», в результате чего они были соотнесены с соответствующими коннекторами, не относящимися к Direct Access Gateway.

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

Поддержка AsyncCommand с запросами на загрузку данных

Асинхронное выполнение запроса на загрузку данных в агенте значительно сокращает время ожидания облачным сервисом ответов от агента.

Асинхронное выполнение запросов на загрузку данных

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

Теперь можно изменять свойство AGENT_LOG_OPTIONS без перезапуска службы Direct Access Gateway. Это свойство должно изменяться только по запросу службы поддержки Qlik.

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

В выпуске Direct Access Gateway 1.7.5 решены указанные далее проблемы.

• Ошибки, возвращаемые для допустимых операций

  Агент коннектора иногда возвращал ошибку «500» для действительных вызовов загрузки и событий.

• API конфигурации.

  • Свойство «Максимальное количество процессов» для коннекторов REST и FILE обновлено для охвата значений в диапазоне от 2 до 100.

  • В свойство AGENT_LOG_OPTIONS добавлено значение по умолчанию

  • Обновлены значения уровня журнала DCaaS

• События, связанные с поддержанием активности.

  • События, связанные с поддержанием активности, иногда не шифруются

  • Если сеанс в агенте уже неактивен, отправляется неправильный ответ на освобождение ресурсов облака

Возможность переопределения стандартной учетной записи службы Windows во время установки

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

Для получения дополнительной информации см. Этап два. Установка Direct Access Gateway на сервер за брандмауэром, защищающим источники данных

Поддержка Windows Server 2025

Direct Access Gateway версии 1.7.0 и выше были сертифицированы для установки на Windows Server 2025.

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

В Direct Access Gateway 1.7.4 решены следующие проблемы:

• Усиление безопасности

  При использовании коннектора Файл (через Direct Access Gateway) все операции с файлами выполнялись из учетной записи службы Windows "NT AUTHORITY\SYSTEM". Проблема была решена за счет того, что теперь при установке можно переопределить учетную запись службы Windows, используемую по умолчанию.

• Коннектор Google BigQuery (через Direct Access Gateway): ошибка при обработке данных меток времени (TIMESTAMP), не входящих в заданный диапазон

  При обработке данных TIMESTAMP, не входящих в диапазон 1400-9999 (лет), возникала следующая ошибка:

  The data contains unsupported data type or row content. Invalid row status.

• Настраиваемая учетная запись службы Windows не поддерживается после обновления

  После обновления назначенная учетная запись службы Direct Access Gateway будет изменена на локальную учетную запись по умолчанию (LocalSystem).

• Ошибка перезагрузки

  Во время перезагрузки, из-за проблемы, связанной с шифрованием событий keepAlive (отправленных с Qlik Cloud на шлюз), иногда возникала следующая ошибка:

  Internal error. (Connector error: Reload web socket was aborted due to a failure (DirectAccess-1103))

Улучшения процедуры поиска и устранения неполадок

• Direct Access Gateway Метрики машины (ядра, дисковое пространство, память, процессор и т.д.) теперь будут передаваться в удаленную систему ведения журнала, что позволит использовать эти данные в диагностике и устранении неполадок.
• Метка времени в сообщения журнала теперь имеет формат UTC для всех журналов, кроме журналов для коннекторов SAP.
• Имя журнала коннектора File (через Direct Access Gateway) теперь включает номер порта (вместо ID процесса).
• В сообщения журнала коннектора File (через Direct Access Gateway) был добавлен столбец Process ID.

Улучшение коннектора ODBC (через Direct Access Gateway)

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

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

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

• Коннектор REST (через Direct Access Gateway): сбой при перезагрузке

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

  Received message exceeds the maximum configured message size.

• Коннектор REST (через Direct Access Gateway): Overly restrictive URL allowed list (Слишком строгий  список разрешенных URL)

  URL-адреса без завершающего слэша неправильно блокируются, в то время как те же URL-адреса с завершающим слэшем разрешены.

• Коннектор ODBC (через Direct Access Gateway): чрезмерный расход памяти

  При использовании в скрипте загрузки нескольких SELECT память VRAM в исходной системе не освобождается, увеличиваясь при каждой перезагрузке.

• Коннектор MySQL (через Direct Access Gateway): проблема с типом данных

  При использовании коннектора MySQL (через Direct Access Gateway) для загрузки таблицы с типом данных "int(9) unsigned" данные для соответствующего столбца будут возвращаться как -1.

• Коннектор SAP SQL (через Direct Access Gateway): MixedMode не работает

  Свойство строки подключения MixedMode работает не так, как ожидается.

• Источник данных с типом SQL: проблема со скриптом загрузки

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

• Коннектор Databricks (через Direct Access Gateway): усиление безопасности

  Для связи и передачи данных, загружаемых через коннектор Databricks (через Direct Access Gateway), теперь всегда будет использоваться SSL. Предыдущая опция включения или отключения SSL была удалена.

• Усиление безопасности

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

Установка порога возобновления восстановления блоков

Теперь можно установить порог (в минутах) для продолжительности восстановления блоков. Если перезагрузка не возобновилась к моменту достижения порога продолжительности восстановления, она завершится ошибкой с соответствующим сообщением.

Эта функция полезна для перезагрузок, которые в противном случае могут продолжаться дольше трехчасового предела в рамках длительного восстановления. Например, на извлечение данных из базы данных уходит 90 минут, но когда начинается перезагрузка, один из блоков оказывается поврежденным. В этом случае все блоки будут храниться в кэше и отправляться из кэша. При таком сценарии весь процесс перезагрузки (сохранение в кэше + собственно перезагрузка) может занять три часа.

См. также раздел Установка порога возобновления восстановления блоков.

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

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

• Отсутствует конфигурация для коннектора REST (через Direct Access Gateway).

  Параметр REST_MAX_PROCESS_COUNT отсутствовал в файле configuration.properties в Direct Access Gateway 1.7.1.

• Автоматический перезапуск процессов Direct Access Gateway работает не так, как ожидалось.

  Иногда процессы Direct Access Gateway не перезапускались автоматически после сбоя или прекращения иным образом.

• Папки кэша восстановления блоков создавались в неправильном местоположении

  Когда не был задан параметр OVERRIDE_CHUNKS_CACHE_DIR в файле configuration.properties, папки кэша восстановления блоков создавались в папке [папка установки]\ConnectorAgent вместо C:\ProgramData\Qlik\Gateway\tmp (папка по умолчанию).

• Сбой перезагрузки в режиме восстановления блоков

  При работе в режиме восстановления блоков перезагрузка иногда заканчивалась ошибкой DirectAccess-4021. Проблема была вызвана тем, что EODAck поступал агенту немного позже таймаута EODAck. Проблема решена путем незначительного увеличения таймаута EODAck.

• Проблема с уровнем журнала коннектора File (через Direct Access Gateway)

  Уровень журнала DEBUG для коннектора File (через Direct Access Gateway) игнорировался.

• Содержимое папки [папка установки Direct Access Gateway]\data\logs\reloads никогда не удалялось.

  Старые файлы JSON никогда не удалялись из папки [папка установки Direct Access Gateway]\data\logs\reloads. В результате накопления большого количества журналов папка может со временем занимать значительное количество дискового пространства. Кроме того, резервное копирование этой папки (которая может содержать тысячи журнальных файлов) также представляет сложность.

• Усиление безопасности

  Это улучшение добавляет дополнительный уровень шифрования для событий и сообщений, отправляемых между Qlik Cloud и Direct Access Gateway, которые содержат конфиденциальные данные, такие как IP-адрес пода и ID шлюза.

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

• Коннектор REST

  Новый коннектор REST (через Direct Access Gateway) обеспечивает безопасный доступ к частным конечным точкам API REST через Direct Access Gateway, позволяя передавать поток данных непосредственно в приложение Qlik Sense.

  Для получения дополнительной информации см. раздел Источники данных REST (только английский язык).

  Примечание к информации

  Коннектор REST (через Direct Access gateway) будет разворачиваться в регионах Qlik Cloud в четыре этапа, последний из них планируется завершить к 17 февраля.

  • Этап 1: JP (Япония) и UK (Великобритания)
  • Этап 2: DE (Германия), SG (Сингапур), AP (Азиатско-Тихоокеанский регион) и IN (Индия)

  • Этап 3: US (Соединенные Штаты) и Qlik Cloud для правительства

  • Этап 4: ЕС (Европейский Союз)
    

• Переопределение каталога кэша блоков по умолчанию

  Для каждой операции перезагрузки Direct Access Gateway может кэшировать блоки данных в памяти и выгружать их на диск (при превышении размера, выделенного для кэширования). Можно переопределить каталог кэша блоков по умолчанию(C:\ProgramData\Qlik\Gateway\tmp), если на системном диске недостаточно места.

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

• Переопределение количества таблиц, получаемых по умолчанию при работе с коннектором ODBC (через Direct Access Gateway).

  По умолчанию для выборки будет получено 10 000 таблиц, что может быть недостаточно при работе с очень большими базами данных. В этой версии появилась возможность переопределить значение по умолчанию, увеличив свойство ODBC_TABLES_LIMIT_FOR_GENERICODBC в файле Direct Access Gateway configuration.properties.

  Дополнительные сведения см. в разделе Максимальное количество таблиц для выгрузки.

• Поддержка нескольких каталогов в Google BigQuery (via Direct Access Gateway) Connector

  Теперь Google BigQuery (via Direct Access Gateway) Connector поддерживает доступ к нескольким каталогам (эквивалент проектов Google BigQuery) в одном подключении.

  Для получения дополнительной информации см. раздел Создание подключения Google BigQuery (только английский язык).

• Поддержка Unity Catalog в Databricks (via Direct Access Gateway) Connector

  Теперь Databricks (via Direct Access Gateway) Connector поддерживает доступ к данным в Unity Catalog в источнике данных Databricks.

  Для получения дополнительной информации см. раздел Создание подключения Databricks (только английский язык).

• Устранение ошибок данных, вызванных драйвером ODBC, при использовании коннектора ODBC (через Direct Access Gateway).

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

  Для получения дополнительной информации см. раздел Переопределение типа данных Qlik Cloud по умолчанию при работе с коннектором ODBC (через Direct Access Gateway).

• Перемещение журнала событий запуска, выхода и перезапуска коннектора

  Начиная с Direct Access Gateway 1.7.1 события запуска, выхода и перезапуска коннектора будут записываться в файл журнала Direct Access Gateway(DirectAccessAgent). В предыдущих версиях они записывались в файл журнала Журналы агента коннектора (connector-agent_logs_<дата>).

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

В Direct Access Gateway версии 1.7.1 решены следующие проблемы:

• В некоторых сценариях производительность перезагрузки может снизиться при включении параметра RELOAD_CACHE_MEMORY_MB (который кэширует данные для перезагрузки в случае возникновения проблем).

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

  (Connector error: data loading error (DirectAccess-4008) (DirectAccess-4001))

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

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

• Ошибка «Could not find file» иногда возникала, когда агент коннектора пытался прочитать блок с диска после того, как он был загружен в память.

• При работе с коннектором SAP BW возникает следующая ошибка:

  Error when parsing '0TCT_C03': The given key 'CHABASNM' was not present in the dictionary.

  Проблема исправлена путем добавления поддержки старых переносов без поля метаданных CHABASNM.

• Когда файл configuration.properties содержал дубликаты записей, запуск службы Direct Access Gateway был невозможен.

• При попытке подключения к источнику данных Azure SQL Database (через Direct_Access Gateway) с помощью метода проверки подлинности Azure Active Directory операция «Проверка подключения» завершалась следующей ошибкой:

  Communication link failure - ERROR [08S01] [Qlik][SqlServer] Connection broken unexpectedly

• В некоторых случаях, когда прерывалось подключение Direct Access Gateway к Qlik Cloud, на восстановление подключения уходило до 10 минут. В течение этого времени перезагрузка не начиналась. Это время было сокращено до 45 секунд.

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

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

• Коннектор File

  Новый коннектор File (через Direct Access Gateway) обеспечивает безопасный доступ к файловой системе через Direct Access Gateway, позволяя передавать поток данных непосредственно в приложение Qlik Sense.

  Для получения дополнительной информации см. раздел Коннектор File (через Direct Access Gateway) (только английский язык).

• Улучшенная производительность благодаря поддержке асинхронных команд

  Поддержка асинхронных команд повышает эффективность, позволяя Direct Access Gateway обрабатывать несколько команд одновременно, а не по одной за раз.

   

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

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

• Коннектор Snowflake

  Загрузка данных, содержащих специальные символы, завершалась ошибкой компиляции SQL.

• Установка без взаимодействия с пользователем

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

• Производительность коннектора Oracle (через Direct Access Gateway)

  Загрузка данных с помощью коннектора Oracle (через Direct Access gateway) была значительно медленнее, чем при использовании драйвера ODBC напрямую.

• Сбои коннектора ODBC (через Direct Access Gateway)

  Коннектор ODBC (через Direct Access Gateway) иногда неожиданно завершал работу из-за ошибки в драйвере SQL Server Simba.

• Периодические сбои при перезагрузке

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

  Connector Datagateway Space:SQLCLUSTER01 not found (Requested endpoint could not be provisioned due to failure to acquire a load slot: The response body of the connector load info request was empty.

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

• Изоляция процессов теперь включена по умолчанию

  В предыдущих версиях режим изоляции процессов был отключен по умолчанию. Начиная с версии Direct Access gateway 1.6.9, он будет включен по умолчанию, но только при чистой установке. При обновлении существующая конфигурация изоляции процессов будет сохранена (выключена или включена, в зависимости от ее состояния до обновления).

  Чтобы узнать больше об изоляции процессов, см. раздел Изоляция процессов.

• Удален файл configuration.properties

  Чтобы предотвратить ошибочное изменение пользователем неправильного файла configuration.properties, файл шаблона configuration.properties удален из папки установки Direct Access Gateway. Теперь будет только один файл configuration.properties, расположенный в C:\ProgramData\Qlik\Gateway.

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

Direct Access Gateway 1.6.9 устраняет следующие проблемы благодаря функции восстановления блоков:

• Блоки не удалялись после перезагрузки

  Обработанные блоки иногда не удалялись с диска после перезагрузки.

• Блоки не удалялись после сбоя

  Обработанные блоки иногда не удалялись с диска после сбоя Direct Access Gateway.

• Большой расход памяти

  Большой расход памяти иногда возникал при перезагрузке сохраненных блоков.

Более подробную информацию о функциональности восстановления блоков см. в разделе Память для кэшированных фрагментов данных.

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

• Механизм восстановления блоков данных

  В этой версии добавлена поддержка для отправки отсутствующих или поврежденных блоков данных. Для управления размером, занимаемым в памяти блоками перезагруженных данных, добавлено новое свойство в файл configuration.properties: RELOAD_CACHE_MEMORY_MB

  Для получения дополнительной информации о функциональности восстановления фрагментов, см. Память для кэшированных фрагментов данных

• .NET 6.0.x больше не требуется

  Начиная с этой версии для запуска Direct Access Gateway больше не требуется .NET 6.0.x. Перед установкой Direct Access Gateway новым пользователям требуется установить только .NET 4.8 (необходим для установки), а также .NET 8.0 и ASP.NET Core Runtime (для работы с Direct Access Gateway).

  Для получения дополнительной информации о предварительных требованиях для Direct Access Gateway см. раздел Предварительные требования к системе.

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

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

  Чтобы узнать больше об изоляции процессов, см. Изоляция процессов

• Улучшенная процедура поиска и устранения неисправностей

  В журналах добавлен дополнительный контекст (например, process ID (идентификатор процесса) и commit size (размер фиксации)) в предупреждения об использовании ресурсов.

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

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

• Сообщение об ошибке, вводящее в заблуждение

  После перезагрузки шлюза (вручную или в результате сбоя) запросы могли отправляться агенту коннектора (ConnectorAgent.exe) до завершения его инициализации. В этом случае сообщение об ошибке вводило пользователя в заблуждение. Теперь сообщение об ошибке будет означать, что шлюз отключен.

• Ошибки при перезагрузке из-за отключения

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

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload

  Ошибки при перезагрузке из-за отключения модуля

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

  Connector error: data loading error (DirectAccess-4008)

• Зависание перезагрузки после перезапуска службы Direct Access Gateway

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

  Reload web socket was aborted due to a failure (DirectAccess-1103)

• Коннектор Amazon Redshift: таблица SELECT заполняла дубликаты столбцов

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

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

• Поддержка автоматического распределения портов при работе с изоляцией процессов

  Ранее в поле Максимальное количество параллельных процессов перезагрузки (Maximum number of concurrent reload processes) было невозможно задать значение больше 10 при использовании номера порта и диапазона по умолчанию. Начиная с этой версии порты будут распределяться автоматически, благодаря чему количество одновременных процессов перезагрузки может быть больше 10.

• Улучшенная разбивка метаданных на страницы при работе с коннектором SAP SQL (через Direct Access Gateway)

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

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

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

• Истекшие сесссии перезагрузки не освобождаются при использовании изоляции процессов

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

• Сессии Amazon Redshift продолжаются несмотря на закрытие приложения

  Сессии Amazon Redshift продолжаются до окончания обработки запроса, даже если работа аналитического приложения QCS была завершена ранее.

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

  • Коннекторы Direct Access Gateway связывают все службы с 0.0.0.0, разрешая подключения с каждого IP-адреса на локальном компьютере, в результате чего сервер становится открытым для всех возможных сетей.
  • Direct Access Gateway попытается загрузить MPR.dll из несуществующего динамически создаваемого каталога в папке временных файлов пользователя. По причине отсутствия MPR.dll в ожидаемом местоположении злоумышленник может поместить вредоносный файл DLL в эту папку, который впоследствии может быть загружен и выполнен программой установки.

• Зависание перезагрузки после перезапуска службы Direct Access Gateway

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

• Проблемы с предварительным просмотром и перезагрузкой данных

  Проблемы с предварительным просмотром и перезагрузкой данных иногда возникают при использовании коннектора ODBC (через Direct Access Gateway) для доступа к Microsoft Fabric.

• Ошибка при добавлении предложения ORDER BY

  Добавление предложения ORDER BY может приводить к ошибке, когда используется коннектор ODBC (через Direct Access Gateway) и SQL Anywhere 17.

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

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

• Поддержка доступа к ServiceNow через Direct Access Gateway

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

• Поддержка новых методов проверки подлинности при использовании следующих коннекторов Direct Access Gateway:

  • Azure Synapse Analytics: Azure OAuth и Azure Active Directory
  • Azure SQL Database: Azure OAuth и Azure Active Directory
  • Snowflake: OAuth
  • Databricks: Azure OAuth
  • MongoDB: SCRAM-SHA-256 и LDAP

• Улучшенная разбивка метаданных на страницы при работе с коннекторами ODBC

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

• Требуется .NET 8.x

  Начиная с этой версии клиенты должны установить и .NET 6, и .NET 8.x, чтобы работать с Direct Access Gateway. Если это еще не сделано, они автоматически устанавливаются в процессе установки или обновления.

• Улучшены возможности поддержки

  Чтобы упростить поиск и устранение неполадок, добавлена дополнительная функция журнала, которая измеряет длительность запросов Direct Access Gateway.

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

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

• Если подключение между Direct Access Gateway и Qlik Cloud бездействует в течение 30 секунд или более, иногда операция перезагрузки завершается следующей ошибкой: «Недопустимое имя объекта '#<TempTableName>'» (указывает на то, что временные таблицы Direct Access Gateway недоступны).

  Для устранения этой проблемы был добавлен новый параметр Тайм-аут запроса загрузки. Этот новый параметр задает длительность сеанса перезагрузки для коннекторов ODBC и имеет значение по умолчанию 20.

• Отмена перезагрузки иногда приводит к созданию процесса ODBC и цикла завершения.
• Подключение между Direct Access Gateway и Qlik Cloud Services иногда внезапно обрывается без видимой причины.

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

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

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

В 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 в файле C:\ProgramData\Qlik\Gateway\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)

  Чтобы решить эту проблему, в настройки Direct Access Gateway был добавлен параметр Тайм-аут запроса на загрузку (для увеличения времени ожидания запроса на загрузку).

  Пользователям, у которых часто возникают эти ошибки, следует задать значение 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).