容器化部署支持更多连接器
Direct Access gateway 的容器化安装现在支持 SAP BW、SAP SQL、SAP ODP、SAP Report 和 MySQL 连接器。SAP 连接器需要 SAP NetWeaver RFC SDK。
有关设置说明，请参阅在容器中设置 Qlik Data Gateway - Direct Access 和为 Qlik Data Gateway - Direct Access 安装 SAP NetWeaver RFC SDK （仅提供英文版本）。
异步文件下载设置
文件连接器可以使用可选的 AsyncFileDownloadRequest 功能，在无阻塞的情况下设置文件下载。如果未协商该功能，网关将使用同步设置路径。
有关配置的详细信息，请参阅配置和故障排除 Qlik Data Gateway - Direct Access。
无需重启即可更新文件下载确认超时设置
您可以通过配置 API 更改 FILE_REQUESTDOWNLOAD_ACK_TIMEOUT_SECONDS 的设置，无需重新启动网关。
CLI 命令不再报告 log4net FileOpenFailure 错误
解决了命令行界面命令报告 log4net FileOpenFailure 的问题。
对块缓存目录的验证
解决了未对 OVERRIDE_CHUNKS_CACHE_DIR 属性进行验证的问题。
容器资源指标和环境检测
解决了容器化网关报告主机级 CPU、内存和磁盘指标而非容器指标的问题，以及在 containerd 环境下运行时可能错误检测环境的问题。
并发重新加载请求不再存在数据丢失的风险
解决了网关组件在重叠的加载请求之间共享每个请求的 gRPC 客户端状态的问题，该问题在极少数情况下可能导致静默的数据丢失。
重试重新加载时的文件未找到错误
解决了一个可能导致间歇性 $(MUST_INCLUDE=...) *** file not found 错误的问题，该问题会在重新加载超出 QIX 引擎的重新加载内存限制并使用相同的重新加载 ID 重试时发生。
中止被放弃的 WebSocket 后，重新加载恢复
解决了一个问题，即在重新连接期间中止一个被放弃的重新加载 WebSocket 时，会因 DirectAccess-4002 错误导致重新加载失败，而非允许恢复。
文件连接器日志文件名
解决了文件连接器日志文件名可能包含重复的嵌套文件名的问题。
网关设置对话框权限
解决了因 metrics-collector 配置请求返回了 404 响应，导致网关设置对话框显示权限不足错误的问题。
ODBC 驱动程序安全更新
Phoenix、Google BigQuery、ServiceNow 和 MySQL ODBC 驱动程序现已改用 OpenSSL 3.5.8。Phoenix、Google BigQuery 和 ServiceNow ODBC 驱动程序现已改用 libcurl 8.22.0。
容器化部署（支持 Linux）
除了现有的 Windows 安装之外，Direct Access gateway 现在还可部署在容器化的 Docker 环境中。这使得 Direct Access gateway 能够通过容器部署在 Linux 和 Windows 环境之中。首个容器版本支持 ODBC 连接器（PostgreSQL、SQL Server 及 Oracle）以及 REST 连接器。
有关先决条件和部署详情，请参阅设置 Qlik Data Gateway - Direct Access 及在容器中设置 Qlik Data Gateway - Direct Access。
通过命令行自动注册网关
您现在可通过命令行自动注册 Direct Access gateway，而无需使用 Administration 活动中心。这对于多租户部署及其他需要自动化、无人值守注册的场景尤其有用。Windows 及容器化安装均支持此方法。
有关配置详细信息，请参阅 使用命令行自动注册网关。
AWS PrivateLink 支持（于 2026 年 9 月 22 日引入）
拥有 Qlik Cloud Analytics Enterprise 订阅或者 Qlik Sense Enterprise SaaS 的客户现在可以使用 Direct Access Gateway 在其数据与 Qlik Cloud 租户之间建立 AWS PrivateLink 终端节点。这意味着加载至 Qlik Analytics 应用程序的数据可以通过专用网络连接进行发送。有关更多信息和配置详细信息，请参阅为 Qlik Data Gateway - Direct Access 配置 AWS PrivateLink。
文件连接器改进
为初始文件下载确认添加了可配置超时 (FILE_REQUESTDOWNLOAD_ACK_TIMEOUT_SECONDS)。此配置将有助于缓解文件连接器重新加载时的 DirectAccess-2007 错误。
为文件连接器下载停滞添加了诊断日志记录。
静默安装及卸载现在会报告准确的结果
解决了在安装后步骤（例如收集安装日志或完成租户注册）失败时，静默安装或者卸载仍可能报告成功的问题。静默安装及卸载现在返回实际结果，并且先决条件安装程序现在静默运行，而不是等待隐藏的对话框。
连接器启动脚本加固
解决了在禁用 Windows Command Extensions 时，连接器启动脚本可能会探测不受信任路径，这还可能导致配置覆盖静默应用失败的问题。脚本现在显式启用 Command Extensions 以便防止出现此问题。
Google BigQuery 驱动程序更新
Google BigQuery ODBC 驱动程序已经更新至版本 3.3.1.3003
安全更新
已经针对 ODBC 驱动程序升级了 OpenSSL 和 libcurl 库：
除 Apache Spark 外的所有 ODBC 驱动程序均已升级成使用 OpenSSL 3.5.7。
除 Apache Spark 外的所有 ODBC 驱动程序均已升级成使用 libcurl 8.21.0。
支持用户界面中的基准测试（于 2026 年 8 月 18 日推出）
Direct Access gateway 网关现在直接在 Administration 活动中心显示基准测试结果，让管理员对网关性能有更高的透明度，而无需深入挖掘日志文件。
基准测试是诊断操作，用于测量 Direct Access gateway 和 Qlik Cloud 之间的网络连接和性能。使用它们来诊断重新加载性能问题、建立性能基线或比较网关。
您现在可以直接在Administration活动中心查看这些基准测试运行的结果，从而更轻松地识别影响重新加载性能的网络状况，并收集故障排除所需的信息，而无需离开管理体验。
有关更多信息，请参阅查看和运行基准测试。
新配置选项，用于限制所有 Direct Access gateway 组件的日志保留。
新增了一个配置选项，用于限制所有Direct Access gateway组件日志的保留时间，包括连接器、DCaaS 和代理本身。此选项可通过Direct Access gateway UI 和公共 API进行配置。
并发 WebSocket 发送导致的 DirectAccess-1103 错误
解决了重新加载 WebSocket 被并发发送静默中止的问题，该问题导致 DirectAccess-1103 错误和重新加载失败。
基准测试持续时间超时已增加
基准测试持续时间超时已增加到10分钟，以支持在较慢机器上的执行。
REST 连接器的进程隔离日志缺失
修复了一个问题，即在使用 REST 连接器时未生成进程隔离日志。REST 连接器现在会记录进程隔离信息，与其他 Direct Access gateway 连接器保持一致。
安全更新
以下 ODBC 驱动程序已更新为使用 OpenSSL 3.5.7：
MongoDB
Impala
凤凰城
Hive
MySQL
Impala、Phoenix 和 Hive ODBC 驱动程序也已更新，以使用 libcurl 8.21.0。
区块恢复可以按连接禁用
您现在可以针对特定连接器禁用区块恢复，从而提供对重新加载弹性和性能更精细的控制。此设置会覆盖全局区块恢复配置，并且可以直接在连接器设置中或通过公共 API进行配置。
有关配置详细信息，请参阅禁用按连接的区块恢复。
加拿大区域支持
Direct Access gateway 现已支持在加拿大区域部署，为具有数据驻留要求的客户扩大了可用性。
改进的重新加载数据流吞吐量
通过优化线程池管理、WebSocket 协议处理和自适应步调，改进了重新加载数据流吞吐量。这些改进是自动的，无需任何配置。
文件连接器自定义文件扩展支持
文件连接器现在允许您配置超出默认支持类型的自定义文件扩展名。通过网关设置或编辑扩展配置文件来配置允许的扩展。
有关配置详细信息，请参阅允许自定义扩展 （仅提供英文版本）。
DirectAccess-1513 连接超时错误
解决了连接偶尔会超时并出现 DirectAccess-1513 错误的问题，尤其是在高并发场景下。
安全更新
OpenSSL 库已针对以下驱动程序进行了升级：
Google BigQuery 及 Snowflake 驱动程序已升级到 3.5.7
Amazon Athena、Amazon Redshift、Apache Spark 以及 ServiceNow 驱动程序已升级到 3.5.6 版本
所有其他驱动程序（MySQL 除外）的 OpenSSL 库已升级到 3.0.20，在 Direct Access gateway 1.7.15
连接器类型误识别
在极少数情况下，一个最初以一种类型（例如，ODBC）连接的连接器会话，后来会被报告为另一种类型（例如，REST）。
SAP BW (通过 Direct Access gateway) 连接器问题：
空值选择：当列包含空值时，重新加载会失败。
Unicode 字符解析：当 Load Query 脚本包含 Unicode 字符时，会出现解析错误。
IN 和 AND 运算符：当条件块包含 IN 和 AND 运算符时，会出现错误。
PostgreSQL (通过 Direct Access gateway) 连接器 - 数据截断
包含超过 255 个字符的字符串将被截断。
ODBC（通过 Direct Access gateway）连接器 - 表预览
将 Direct Access gateway 升级到版本 1.7.13 后，预览不带双引号的表列会导致错误。
网关 CLI 重启异常
尝试使用 connectoragent.exe services restart 从命令行重启网关会导致错误。
安全性
已移除多个未使用的 OpenSSL 3.0.8 DLL 副本。
基准测试 API - SQLite 文件删除问题
从 Direct Access gateway 1.7.13 开始，SQLite 文件（包含基准重载数据）在基准测试完成后不会被删除。
通过网关配置传播来改进故障排除
网关配置现已传播到 Qlik Cloud，以便于 Qlik 支持进行故障排除。
Gloo 会话亲和性用于重新加载重新连接
重新加载重新连接现在使用 Gloo 会话亲和性，这减少了服务负载并提高了重新加载成功率。
基于 DSN 的连接的数据类型映射
数据类型映射现在可在基于 DSN 的连接中正常工作。
带 Filelist 掩码的文件连接器
解决了对不存在的文件使用 Filelist 掩码时，File 连接器会返回错误的问题。
C++ 可再发行组件安装与升级问题
解决了与 C++ 可再发行组件包相关的安装和升级问题。
文件连接器初始化延迟
缓解了启用进程隔离时因 File Connector 初始化延迟而导致的间歇性 DirectAccess-5000 和 DirectAccess-1510 错误。
安全更新
已将 ODBC 驱动程序（Apache Hive、Cloudera Impala、Apache Phoenix 和 Snowflake）中的 libcurl.dll 升级至版本 8.19.0。在除 Presto、Spark、Microsoft SQL Server、MySQL 和 Google BigQuery 之外的所有 ODBC 驱动程序中将 OpenSSL 升级至版本 3.0.20，以解决已知漏洞。
文件连接器 RTF 文件支持
修复了 FileExtensionValidator 中导致无法列出和加载 RTF 文件的拼写错误。
扩展的身份验证支持
以下连接器现在支持单一登录 (Kerberos) 身份验证：
Microsoft SQL Server
此外，Teradata 连接器现在支持 LDAP 身份验证。
改进了文件连接器重新加载的处理
分析引擎有时会缓存来自早期会话的连接，并向被请求关闭的记忆棒发送请求。这将导致重新加载失败，并出现以下错误：
Connector error: data loading error (DirectAccess-4008)
从该版本开始，发送至不再激活的 pod 的重新加载请求将被拒绝，并路由到可用的 pod。
改进的重新加载测量日志记录
重新加载测量记录已得到改进。这将使客户和 Qlik Support 都能够更深入地了解重新加载性能。作为改进的一部分，日志记录级别已更改为 INFO，并且日志消息已调整为可以与 Direct Access gateway 监控工具配合使用。此外，以下信息当前将在日志中显示：
使用 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）连接器时，无法预览包含双引号的列的数据。
“选择要加载的数据”对话框内的新下拉菜单
现在，已将选择数据库、所有者、角色、目录及架构的功能添加到数据加载编辑器 > 选择要加载的数据（<连接器显示名称>）对话框中。有以下连接器受影响：
Athena Drill（通过 Direct Access gateway）
已添加数据库和所有者下拉列表。
Databricks（通过 Direct Access gateway）
目录和架构下拉列表已经添加。
Presto（通过 Direct Access gateway）
已添加数据库和所有者下拉列表。
Snowflake（通过 Direct Access gateway）
已添加角色、数据库和架构下拉列表。
移除启用批量读取器选项
启用批量读取器选项默认启用，且不再显示在 UI 中。只能使用内部属性禁用它。
最低 TLS 版本
版本 1.3 已添加至以下连接器中的 最低 TLS下拉列表：
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 Data Gateway - Direct Access 附带一个易受攻击的 SQLite 组件。为解决此问题，System.Data.SQLite 已升级到 2.0.2 版。
ODBC（通过 Direct Access gateway）连接器
通过 Direct Access gateway 配置 UI 添加新的数据类型映射会导致设置不正确的驱动程序/标识符。
Oracle Wallet 连接失败
在并发重新加载期间，Oracle Wallet 与 Oracle Cloud 数据库的连接有时会失败。
当未设置 AGENT_LOG_LEVEL=DEBUG 和 AGENT_LOG_OPTIONS 时，减少了过多的日志记录。
文件连接器重新加载的连接器代理日志现在显示实际的 AppId，而非 AppId=dummyDocId。
WIX 安装程序可能因 COM 劫持（通过 HKCU\Software\Classes\WOW6432Node）而导致任意代码执行。此修复程序在运行安装程序之前验证注册表项。
随 Qlik Data Gateway 安装的 zlib 版本存在已知漏洞。此问题已通过升级到没有已知漏洞的版本来解决。
由于版本 20.19.5 存在已知漏洞，Node.js 运行时已升级到版本 22.x。
由于版本 8.7.0 存在已知漏洞，libcurl.dll 已升级到版本 8.16.0。
Databricks OAuth 服务主体
Databricks OAuth 用户帐户
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 连接器：数据提取问题
在 WHERE 子句中使用两个值从 SAP BW InfoProvider/ADSO 提取数据时，会返回零行。
gRPC 连接的失败导致 Direct Access-1510 错误
在极少数情况下，会发生 gRPC 连接失败，导致 Direct Access-1510 错误。为缓解此问题，已经实施以下改进：
已添加 gRPC 调用，以确保端口可以用于 gRPC 连接
当连接器拒绝连接之时，gRPC 通道将被重新创建
支持在为 ODBC（通过 Direct Access gateway）连接器定义自定义类型映射时减小列大小
增加了对在为 ODBC（通过 Direct Access gateway）连接器定义自定义类型映射时减小驱动程序报告的列大小的支持。在以前的版本中，列大小只能增加。
命令超时
超过默认 45 秒 pong 超时的长时间运行命令会导致命令管道断开连接。通过阻止超时在 Qlik Cloud Service Connection Broker 将命令中继到 Direct Access gateway 连接器代理时触发，解决了此问题。
配置 UI - 保存按钮已禁用
由于 MAX_PROCESSES_COUNT 值无效，保存 按钮将被禁用。通过使用有效值自动填充该字段，解决了此问题。
配置 UI - 默认值与初始值不一致
并发重新加载进程数字段的初始值与以下连接器在 UI 中显示的默认值不同：ODBC、SAP BW、SAP SQL、SAP ODP 和 REST。
文件连接器的进程隔离模式字段的初始值与 UI 中显示的默认值不同。
Microsoft SQL Server NTLM 身份验证模式无法工作
使用 Direct Access gateway 1.7.6 时，Microsoft SQL Server NTLM 身份验证模式停止工作。
高负载下的重新加载失败
执行高负载时，重新加载有时会失败，并出现以下错误：
Connector error: The gRPC connection to the connector failed. ... (DirectAccess-1510)
通过添加重试机制解决了此问题。
某些情况下的间歇性重新加载故障
重新加载有时会失败，并出现以下错误：
DirectAccess-4002：通过将 AGENT_DATA_PING_SKIP_THRESHOLD_SECONDS 属性的默认值从 60 秒减少到 15 秒，解决了此问题。
DirectAccess-2208：通过添加重试机制解决了此问题。
允许的驱动程序
允许的 DSN
自定义类型映射
启用进程隔离时连接器端口发生冲突
过度频繁地尝试开始连接器过程
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）连接器：使用数据管理器添加数据失败
使用 Google BigQuery（通过 Direct Access gateway）连接器时，如尝试使用数据管理器添加数据，则会出现“添加数据失败”错误。
在 LocalSystem 账户下安装 Direct Access gateway 时的密码说明
Direct Access gateway 安装程序中的密码字段使一些客户误以为在 LocalSystem 用户帐户下安装 Direct Access gateway 时总是需要密码。为了解决该问题，我们在安装程序中添加了以下说明文字：
A password is only required if you are not using the default local system account.
有效操作返回错误
对于有效加载和事件调用，连接器代理有时会返回“500”错误。
配置 API：
REST 和 FILE 连接器的“最大进程数”属性已更新，以涵盖 2-100 之间的值
默认值已添加到 AGENT_LOG_OPTIONS 属性中
更新了 DCaaS 日志级别值
保活事件：
保活事件有时不会被加密
当代理上的会话不再处于活动状态时，将发送对释放云资源的错误响应
安全加固
使用文件（通过 Direct Access gateway）连接器时，所有文件操作都将在Windows 服务帐户“NT AUTHORITY\SYSTEM”下执行。通过在安装过程中添加覆盖默认 Windows 服务帐户的功能，该问题得到了解决。
Google BigQuery（通过 Direct Access gateway ）连接器：处理超出特定范围的 TIMESTAMP 数据时出错
在处理超出 1400-9999（年）范围的 TIMESTAMP 数据时，会出现以下错误：
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))
REST（通过Direct Access gateway ）连接器：重新加载失败
重新加载大型数据结构有时会失败，并出现以下错误：
Received message exceeds the maximum configured message size.
REST（通过Direct Access gateway ）连接器：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 连接字符串属性无法按预期运行。
SQL 类型的数据源：加载脚本问题
当连接到 SQL 类型的数据源时，加载脚本中的“TableName”会错误地放在表定义的中间，而不是加载脚本的开头。
Databricks（通过 Direct Access gateway）连接器：安全加固
现在，通过 Databricks（通过 Direct Access gateway ）连接器现在将始终使用 SSL 进行通信和数据传输。删除了以前启用或禁用 SSL 的选项。
安全加固
对于从 Qlik Cloud Administration 活动中心返回客户托管日志的日志记录命令有效载荷，端到端加密不会相互执行。
REST（通过 Direct Access gateway）连接器缺少配置
Direct Access gateway 1.7.1 的 configuration.properties 文件中缺少 REST_MAX_PROCESS_COUNT 参数
Direct Access gateway 自动重启进程未按预期运行
Direct Access gateway 进程有时在崩溃或以其他方式终止时不会自动重启。
在错误位置创建区块恢复缓存文件夹
当 configuration.properties 文件中的 OVERRIDE_CHUNKS_CACHE_DIR 设置为空时，区块恢复缓存文件夹将在 [安装文件夹]\ConnectorAgent 文件夹中创建，而不是在 C:\ProgramData\Qlik\Gateway\tmp（默认文件夹）中创建。
区块恢复模式下的重新加载失败
在 "区块恢复 "模式下工作时，重新加载偶尔会失败，并显示 DirectAccess-4021 错误。问题的原因在于 EODAck 在 EODAck 超时后稍晚到达代理。通过稍微延长 EODAck 超时时间，该问题得以解决。
文件（通过Direct Access gateway ）连接器日志记录级别问题
文件（通过 Direct Access gateway ）连接器的 DEBUG 日志记录级别将被忽略。
[Direct Access gateway 安装文件夹]\data\logs\reloads 文件夹的内容从未被清除
旧的 JSON 文件从未从 [Direct Access gateway 安装文件夹]\data\logs\reloads 文件夹中清除。随着时间的推移，大量日志的积累可能会消耗掉大量磁盘空间。此外，备份这个文件夹（可能包含数千个日志文件）也是一个难题。
安全加固
这一改进为 Qlik Cloud 和 Direct Access gateway 之间发送的事件和信息增加了一层加密，这些事件和信息包含 Pod IP 和网关 ID 等敏感数据。
REST 连接器
新的 REST（通过 Direct Access gateway）连接器通过 Direct Access gateway 提供对私有 REST API 端点的安全访问，允许您将数据直接流式传输到 Qlik Sense 应用程序中。
有关更多信息，请参阅 REST 数据源 （仅提供英文版本）。
REST（通过 Direct Access gateway）连接器将分四个阶段向Qlik Cloud 地区推出，第四阶段计划于 2 月 17 日前完成。
第 3 阶段：US（美国）和 Qlik Cloud 政府
覆盖默认的块缓存目录
对于每次重新加载操作，Direct Access gateway 可将数据块缓存在内存中，并将其卸载到磁盘（当超出分配给缓存的大小时）。如果系统驱动器上没有足够的磁盘空间，则可以覆盖默认块缓存目录 (C:\ProgramData\Qlik\Gateway\tmp) 。
有关更多信息，请参阅覆盖默认的块缓存目录。
覆盖使用 ODBC（通过 Direct Access gateway 连接器）时检索的默认表数
默认情况下，会检索 10000 个表以供选择，这在处理非常大的数据库时可能还无法满足要求。此版本引入了通过增大 Direct Access gateway configuration.properties 文件中的 ODBC_TABLES_LIMIT_FOR_GENERICODBC 属性来覆盖默认值的能力。
更多信息，请参阅要卸载的最大表数。
通过 Google BigQuery (via Direct Access gateway) Connector 支持多个目录
Google BigQuery (via Direct Access gateway) Connector 现在支持在单个连接中访问多个目录（相当于 Google BigQuery 项目）。
有关更多信息，请参阅创建 Google BigQuery 连接 （仅提供英文版本）。
通过 Databricks (via Direct Access gateway) Connector 支持 Unity 目录
Databricks (via Direct Access gateway) Connector 现在支持在 Databricks 上访问 Unity Catalog 中的数据。
有关详细信息，请参见创建 Databricks 连接 （仅提供英文版本）。
减轻使用 ODBC（通过 Direct Access gateway）连接器时由 ODBC 驱动程序引起的数据错误
有时，由于供应商 ODBC 驱动程序处理源数据类型的问题，在重新加载过程中会出现错误，或者会向 Qlik Cloud 加载不正确的数据。在这种情况下，您可以覆盖 Qlik Cloud 数据类型或其规范（例如比例或精度）。
有关更多信息，请参阅使用 ODBC（经由 Direct Access gateway）连接器时覆盖默认的 Qlik Cloud 数据类型。
重新定位连接器启动、退出和重启事件日志事件
从 Direct Access gateway 1.7.1 开始，连接器的启动、退出和重启事件都将写入 Direct Access gateway(DirectAccessAgent) 日志文件。在以前的版本中，它们被写入连接器代理日志 (connector-agent_logs_<date>) 日志文件。
启用 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 Active Directory 身份验证方法连接到 Azure SQL 数据库（通过 Direct_Access gateway）数据源时，测试连接操作会因以下错误而失败：
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中所述。
文件连接器
新的文件（通过 Direct Access gateway）连接器通过 Direct Access gateway 提供安全的文件系统访问，允许您将数据直接流式传输到 Qlik Sense 应用程序中。
有关更多信息，请参阅文件（通过 Direct Access gateway） （仅提供英文版本）。
通过异步命令支持提高了性能
异步命令支持通过允许 Direct Access gateway 同时处理多个命令而不是一次处理一个命令来提高效率。
| Qlik Cloud 地区 | 地区代码 | 已启用 |
|---|---|---|
| 欧洲（伦敦） | eu-west-2 | 1 月 14 日 |
| 日本（东京） | ap-northeast-1 | |
| 欧洲（法兰克福） | eu-central-1 | 1 月 15 日 |
| 亚太（新加坡） | ap-southeast-1 | |
| 亚太（悉尼） | ap-southeast-2 | |
| 印度（孟买） | ap-south-1 | 1 月 21 日
|
| 美国东部（北弗吉尼亚州） | us-east-1 | |
| 欧洲（爱尔兰） | eu-west-1 | 1 月 28 日 |
Snowflake 连接器
加载带有特殊字符的数据将失败，并出现“SQL 编译错误”。
静默安装
静默安装 Direct Access gateway 将启动一个交互式提示来修复必备软件。
Oracle（通过 Direct Access gateway）连接器性能
使用 Oracle（通过 Direct Access 网关）连接器加载数据会比直接使用 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 文件，已从 Direct Access gateway 安装文件夹中删除了 configuration.properties 模板文件。现在，只有一个 configuration.properties 文件，位于 C:\ProgramData\Qlik\Gateway 中。
重新加载后未删除区块
重新加载后，有时不会从磁盘中删除处理过的区块。
崩溃后未删除区块
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 先决条件的更多信息，请参阅系统先决条件
改进了所依赖流程的批处理操作
从这个版本开始，依赖进程将接受并行检查，而不是顺序检查，从而避免了由于运行时修改进程列表而导致的异常。
要了解关于进程隔离的更多信息，请参阅进程隔离
改进了故障排除
日志中的资源使用警告中添加了更多上下文（例如“进程 ID”和“提交大小”）。
误导性错误信息
重新启动网关（手动或由于崩溃）后，请求可能会在初始化之前发送到连接器代理 (ConnectorAgent.exe) 。在这种情况下，错误消息会造成误导。现在，错误消息将指示网关已断开连接。
由于已断开连接，重新加载失败
初始负载后的 Direct Access gateway 断开连接有时会导致后续重新加载失败，并出现以下错误：
Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload
由于记忆棒关闭导致的重新加载失败
分析引擎有时会缓存来自早期会话的连接，并向被请求关闭的记忆棒发送请求。这将导致重新加载失败，并出现以下错误：
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/数据管理器预览中将显示重复的列。
在处理进程隔离时支持自动端口分配
以前，使用默认端口号和范围设置时，无法将并发重新加载进程的最大数量设置为高于 10。从这个版本开始，端口将自动分配，允许并发重新加载进程的数量大于 10。
使用 SAP SQL（通过 Direct Access gateway）连接器时增强的元数据分页
通过此增强功能，当检索到 10000 个或更多表时，将以 10000 个为一批的方式检索这些表，以防止超时。
使用进程隔离时未释放过期的重新加载
使用进程隔离时，连接器进程不会因过期的重新加载而释放。
尽管取消了应用程序，但 Amazon Redshift 会话仍在继续运行
即使正在运行的 QCS 应用程序被取消，Amazon Redshift 会话也会继续运行，直到查询完成。
已解决的安全漏洞
重新启动 Direct Access gateway 服务后重新加载卡滞
当使用非选择查询和存储过程时，重新加载将在重新启动 Direct Access gateway 服务后挂起几个小时。
数据预览和重新加载问题
使用 ODBC（经由 Direct Access gateway）连接器访问 Microsoft Fabric 时，有时会遇到数据预览和重新加载问题。
添加 ORDER BY 子句时出错
在使用 ODBC（经由 Direct Access gateway）连接器和 SQL Anywhere 17 时，添加 ORDER BY 子句会导致错误。
支持通过 Direct Access gateway 访问 ServiceNow
此版本引入了对 ServiceNow（经由 Direct Access gateway）连接器的支持，允许客户通过严格的出站、加密和相互验证的连接安全地访问防火墙 ServiceNow 数据源。
使用以下 Direct Access gateway 连接器时支持新的身份验证方法：
使用 ODBC 连接器时增强了元数据分页
通过此增强功能，当检索到 10000 个或更多表时，将以 10000 个为一批的方式检索这些表，以防止超时。
.NET 8.x 要求
在此版本中，将要求客户同时安装版本 .NET 6 和 .NET 8.x 后方可使用 Direct Access gateway。在安装或升级过程中，如果尚未安装，安装程序将自动安装它们。
提高了可支持性
为了帮助故障排除，添加了额外的日志记录，用于测量 Direct Access gateway 请求的持续时间。
如果 Direct Access gateway 和 Qlik Cloud 之间的连接空闲 30 秒或更长时间，则重新加载操作有时会失败，并出现以下错误：无效的对象名称 '#<TempTableName>'（表示 Direct Access gateway 临时表不可用）。
为解决这一问题，新增加了负载请求超时设置。新参数设置 ODBC 连接器的重新加载会话持续时间，默认值为 20 秒。
Direct Access gateway 连接重试间隔将不断延长，但永远不会自行重置。重新启动 Direct Access gateway 服务将是重置重试间隔的唯一方法。
当使用不正确的语法从 Oracle 调用存储过程时，重载操作将挂起数小时，而不是立即终止并显示一个信息性错误。
对 SAP ODP 连接器的支持
此版本引入了通过 Direct Access gateway 访问 SAP ODP 源的功能。为了便于实现这一点，在 SAP ODP 连接器中添加了一个新的数据网关字段。新字段允许客户选择使用哪个网关来访问其 SAP ODP 源。
另请参阅：SAP ODP 连接器 （仅提供英文版本）
扩展的日志记录功能
此版本引入了一个新的记录器，Qlik 支持可以使用它来解决特定网关组件的问题。
新支持的地区
日本现在作为 Qlik Cloud 租户地区受支持。
性能增强
改进了加密会话的内存分配。
安全漏洞
使用 ODBC 连接器时，密钥会写入 DCAAS 日志。
进程隔离性能
进程在重负载下启动时需要很长时间。
安装路径不正确
如果安装 Direct Access gateway，则总是会将 Qlik 设置为根文件夹，即使用户在安装向导中选择了不同的文件夹。
支持从 Administration 活动中心查看和下载日志文件
此版本引入了在 Administration 活动中心中查看 Direct Access gateway 日志文件并在需要时与 Qlik 支持人员共享这些日志文件的功能。在正常情况下，没有理由查看日志文件，但如果您遇到重复故障或其他问题，日志文件通常有助于查明原因。
另请参阅：查看和下载日志文件
支持静默安装 Direct Access gateway
客户现在可以静默安装 Direct Access gateway，如果您需要在整个组织的多台机器上进行安装 Direct Access gateway，这将非常有用。
改进了会话连续性
当重新加载会话过期时，有时会发生 DirectAccess-1012 错误。现在，Direct Access gateway 将尝试通过更频繁地对 Qlik Cloud 进行 ping 检测来保持重新加载会话的有效性。
configuration.properties 文件中的参数名称不正确
执行 Direct Access gateway 的新安装时，C:\ProgramData\Qlik\Gateway\configuration.properties 文件中的 EXTEND_FIRST_REQUEST_TIMEOUT 参数名称将被错误地称为 FIRST_REQUEST_TIME_EXTENSION。
重新加载 pod 可用性
当多个重载共享相同的重载 ID 时，QCS 中的重载 pod 数量将达到最大值。
数据丢失保护
在以前的版本中，为了防止潜在的数据丢失，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 驱动程序返回的完整错误。详细的错误消息将显示在数据加载编辑器中。
处理具有相同重载 ID 的多次重载
在此版本中，引擎会话 ID 将用于区分具有相同重新加载 ID 的多个重新加载。这将防止潜在的冲突，这些冲突会导致重新加载失败并出现以下错误：
Connector error: data loading error (DirectAccess-4008 支持在多个连接器进程中分散重新加载
连接器进程隔离已添加到 Direct Access gateway。这是一个选择加入功能，意味着它在默认情况下是关闭的。 进程隔离 允许直接访问网关服务器操作系统的管理员控制每个连接器类型可用于重新加载的进程数。通过减少每个连接器进程上同时运行的重新加载次数，在多个连接器进程之间分散重新加载可以提高隔离级别。这反过来又可以在发生连接器崩溃的情况下提高整体 Direct Access gateway 稳定性。
要了解关于进程隔离的更多信息，请参阅进程隔离
添加了在使用 SAP BW（通过 Direct Access gateway）连接器时禁用分块的功能
此版本为 SAP BW（通过 Direct Access gateway）连接器引入了 BEX_ONE_CHUNK 应用程序参数。当直接从 Qlik Cloud 访问 SAP BW 时（即，不通过 Direct access gateway），为了优化性能，结果集在 SAP 后端被划分为块，并作为单独的线程读取。然而，当通过 Direct Access gateway 访问 SAP BW 时，将结果集划分为块并没有真正的优势。相反，它消耗了 SAP 中更多的共享内存，因为它需要在数据传输期间创建一个额外的临时表。可以（尽管通常不是必需的）通过在 appsettings.json 文件中设置 BEX_ONE_CHUNK:false 来开始分块，该文件位于 SAP 连接器二进制文件文件夹中。
SAP BW（通过 Direct Access gateway）和 SAP SQL（通过 Direct Access gateway）连接器的诊断改进
对于 SAP BW（通过 Direct Access gateway）和 SAP SQL（通过 Direct Access gateway）连接器日志，在日志文件扩展名之前添加 _port 后缀，并在连接器的日志文件中添加 ProcessID=### 消息，以便区分在同一端口上侦听的连接器的新实例中的事件。
识别改进
重新加载期间的重新连接机制得到了改进，因此 Direct Access gateway 不再需要连接到启动重新加载的记忆棒（与以前一样）。现在，它将连接到第一个可用的记忆棒，而不是重复尝试连接到启动重新加载的记忆棒（这通常会导致重新加载失败）。
ODBC（经由 Direct Access gateway）连接器日志
当从不同的数据源执行重新加载时，来自一个数据源的进程将错误地出现在另一个数据来源的日志中。
安装程序中缺少文件
在 Direct Access gateway 安装过程中不会复制 configuration.properties 文件。
Qlik Cloud 资源扩展期间的重新加载错误
Qlik Cloud 资源扩展有时会导致 DirectAccess-1006 错误。进行了增强，以改进对某些 Qlik Cloud 资源扩展场景的处理，这些场景发生在通过 Direct Access gateway 执行应用程序重新加载期间。
Snowflake 连接故障
通过 ODBC（通过 Direct Access gateway）连接器连接到 Snowflake 将失败。
DLE 中调试应用程序脚本失败
在启用限制结果选项的情况下，在数据加载编辑器 (DLE) 中调试应用程序脚本有时会失败，并出现以下错误：
Connector error: Invalid load request (DirectAccess-1006).
Microsoft SQL 服务器（经由 Direct Access gateway）连接器：试图与托管在较旧的 Windows Server 版本上的 SQL 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.