升级和卸载 Qlik Data Gateway - Direct Access

新增和增强特性

支持应用程序默认凭据 OAuth 机制与 Google BigQuery

此版本引入了对使用 Google BigQuery (通过 Direct Access gateway) 连接器时应用程序默认凭据 OAuth 机制的支持。

有关详细信息，请参阅创建 Google BigQuery 连接 （仅提供英文版本）。

支持带进程隔离的元数据命令

已向进程隔离配置属性添加了两个新选项：全部和元数据。全部选项允许您为重新加载和元数据命令启用进程隔离，而元数据选项允许您仅为元数据命令启用进程隔离。这可能很有用，例如，对于使用不支持多线程的ODBC驱动程序，但希望并发运行元数据命令（主要用于预览目的）的客户。

新选项通过配置 UI 或通过公共 API 得到支持。

另请参阅：进程分离

支持巴西 (br) 和法国 (fr) 地区

您现在可以在巴西 (br) 和法国 (fr) Qlik Cloud 租户地区中使用 Direct Access gateway。

指标收集器

在典型的客户环境中，每天都存在大量数据重新加载通过 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 服务主体

• Databricks OAuth 用户帐户

这两者都使用通用的 OAuth 2.0 流，该流由 Databricks 托管或 Microsoft Entra ID 托管帐户支持。

要了解更多信息，请参阅创建 Databricks 连接 （仅提供英文版本）。

覆盖进程隔离设置的默认起始端口

启用进程隔离后，您现在可以覆盖 Direct Access gateway 用于与所有隔离的连接器进程进行进程间通信的默认起始端口 (49152)。当默认端口被其他进程占用时，这会很有用。要覆盖端口，请通过编辑 configuration.properties 文件或通过 公共 API 将 DATA_PORT_RANGE_START 属性设置为所需的端口。

已解决的问题

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 连接器：数据提取问题

  在 WHERE 子句中使用两个值从 SAP BW InfoProvider/ADSO 提取数据时，会返回零行。

• gRPC 连接的失败导致 Direct Access-1510 错误

  在极少数情况下，会发生 gRPC 连接失败，导致 Direct Access-1510 错误。为缓解此问题，已经实施以下改进：

  • 已添加 gRPC 调用，以确保端口可以用于 gRPC 连接

  • 当连接器拒绝连接之时，gRPC 通道将被重新创建

新增和增强特性

对 SAP 报告连接器的支持

从该版本起，客户现在可以通过 Qlik Data Gateway - Direct Access 访问其 SAP 报告连接器。

使用 SAP 报告连接器 （仅提供英文版本）

支持 Direct Access gateway 与 Qlik Cloud Government DoD 配合使用

此版本增加了对使用 Direct Access gateway 与 Qlik Cloud Government DoD 配合的支持。

缓解由 DNS 解析引起的延迟

从该版本起，服务到服务通信现在将使用 IPv4 环回地址 (127.0.0.1) 而不是 localhost 执行。这应该能有效消除由 DNS 解析引起的任何延迟。

配置连接器启动参数

您现在可以增加连接器启动的超时值和尝试次数。在执行大量并发重新加载时，这可能很有用。增加这些参数将为 Direct Access gateway 提供更多时间以及额外的尝试来运行连接器，然后才会因失败而退出并需要重新启动。

配置连接器启动

异步请求加载槽

此版本引入了异步请求加载槽的选项。异步请求加载槽可缓解在创建重新加载数据 WebSocket 到 Qlik Cloud 期间，到 Direct Access gateway 的临时命令管道拥堵。这在执行大量并发重新加载时可能很有用。

异步请求加载槽

安装日志的新位置

安装日志文件现在将位于 <Direct Access gateway 安装文件夹>\data\logs 中，这与其他 Direct Access gateway 日志文件的位置一致。

在以前的版本中，安装日志文件位于 C:\Users\<user>\AppData\Local\Temp 中。此文件夹中仍存在的任何日志将在升级期间复制到新位置。

已解决的问题

Direct Access gateway 1.7.7 解决了关注问题：

• 支持在为 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：通过添加重试机制解决了此问题。

文件（通过 Direct Access gateway ）连接器：限制文件系统对特定空间的访问

使用文件（通过 Direct Access gateway）连接器时，现在可以限制文件系统或网络驱动器对特定空间的访问。将每个路径与 Qlik Cloud 租户内的空间配对，意味着只有具有可以消费数据角色或更高权限的角色的空间成员才能访问指定路径。当没有配置空间时，所有空间都可以访问指定的路径。

新配置可以通过公共 API 进行，也可直接在网关服务器上的配置文件中进行。

公共 API

文件（通过 Direct Access gateway）连接器 （仅提供英文版本）

支持无需重新启动网关即可应用更改

从这个版本开始，更新文件（通过Direct Access gateway ）和 REST（通过Direct Access gateway ）连接器的允许路径/URL 时，不再需要重启 Direct Access gateway 服务来应用更改。在改动以下 ODBC 属性时（通过Direct Access gateway ）也是如此：

• 允许的驱动程序

• 允许的 DSN

• 自定义类型映射

Oracle（通过Direct Access gateway ）连接器：支持 Oracle TNS 名称连接方法

该版本增加添加了对使用 TNS 名称访问 Oracle 的支持。

创建 Oracle 连接 （仅提供英文版本）

文件（通过 Direct Access gateway）连接器：默认启用进程隔离

在执行 Direct Access gateway 的清洁安装时，进程隔离将默认启用，并将并发重载进程数 设置为 10。

进程分离

允许使用 REST（通过 Direct Access gateway）连接器连接到localhost

您现在可以允许 REST（通过 Direct Access gateway）连接器连接到 localhost。这便于使用本地（指向网关服务器）REST 端点（如 connector-agent/ 状态端点）来确定代理上的活动负载数。

在添加本地 URL（例如 http://localhost:5050/status）到 restconnector_allowed_urls.txt 文件时，这也可以使用公共 API 进行配置。

允许使用 REST（通过 Direct Access gateway）连接器连接到localhost

公共 API

支持使用公共 API 异步执行“加载数据”请求

在代理上异步执行加载数据请求显著缩短了云服务需要等待代理响应的时间。

此特性在 Direct Access gateway 1.7.5 中引入，现在可以通过使用 OPTIONAL_CAPABILITIES 参数的公共 API 获得。

公共 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）连接器：使用数据管理器添加数据失败

  使用 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.

在元数据预览调用中添加了日志记录上下文

为帮助排查重载故障，元数据预览调用日志中添加了以下字段：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 引入了在非默认 Windows 服务帐户下安装 Direct Access gateway 的功能。使用安装向导和执行静默安装时，此选项可用。

有关更多信息，请参阅第二阶段：在保护您数据源的防火墙后的服务器上安装 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 数据时出错

  在处理超出 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))

故障排程改进

• Direct Access gateway 机器指标（内核、磁盘空间、内存、CPU 等）现在将被传播到远程日志记录中，以协助故障排除。
• 除 SAP 连接器的日志外，所有日志的日志消息时间戳现在都将采用 UTC 格式。
• 文件（通过 Direct Access gateway）连接器日志名称现在包括端口号（而不是进程 ID）。
• 文件（通过 Direct Access gateway）连接器日志记录消息现在包括一个进程 ID 列。

增强 ODBC（通过Direct Access gateway ）连接器

使用 ODBC（通过 Direct Access gateway）连接器时，现在将从连接器中显示的 ODBC 驱动程序列表中排除ANSI ODBC 驱动程序（不受支持）。

已解决的问题

Direct Access gateway 1.7.3 解决了以下问题：

• 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 活动中心返回客户托管日志的日志记录命令有效载荷，端到端加密不会相互执行。

设置区块恢复阈值

现 在，您可以为区块恢复持续时间设置一个阈值（以分钟为单位）。如果在达到恢复持续时间阈值时重新加载尚未恢复，则将失败并显示相应的消息。

此选项对于在长时间恢复后可能超过三小时限制的重新加载非常有用。例如，假设从数据库检索数据需要 90 分钟，但一旦重新加载开始，其中一个块就会损坏。在这种情况下，所有区块都将存储在缓存中，并从缓存发送。在这种情况下，整个重新加载过程（存储在缓存中 + 实际重新加载）可能需要三个小时才能完成。

另请参阅设置区块恢复持续时间阈值。

已解决的问题

Direct Access gateway 1.7.2 解决了以下问题：

• 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 日前完成。

  • 第 1 阶段： SE（瑞典）、JP（日本）和 UK（英国）
  • 第 2 阶段：DE（德国）、SG（新加坡）、AP（亚太地区）和 IN（印度）

  • 第 3 阶段：US（美国）和 Qlik Cloud 政府

  • 第 4 阶段：EU（欧盟）
    

• 覆盖默认的块缓存目录

  对于每次重新加载操作，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>) 日志文件。

已解决的问题

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 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 同时处理多个命令而不是一次处理一个命令来提高效率。

   

已解决的问题

Direct Access gateway 1.7.0 解析以下问题：

• 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 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 先决条件的更多信息，请参阅系统先决条件

• 改进了所依赖流程的批处理操作

  从这个版本开始，依赖进程将接受并行检查，而不是顺序检查，从而避免了由于运行时修改进程列表而导致的异常。

  要了解关于进程隔离的更多信息，请参阅进程隔离

• 改进了故障排除

  日志中的资源使用警告中添加了更多上下文（例如“进程 ID”和“提交大小”）。

已解决的问题

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

  由于记忆棒关闭导致的重新加载失败

  分析引擎有时会缓存来自早期会话的连接，并向被请求关闭的记忆棒发送请求。这将导致重新加载失败，并出现以下错误：

  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 个为一批的方式检索这些表，以防止超时。

已解决的问题

Direct Access gateway 1.6.7 解析以下问题：

• 使用进程隔离时未释放过期的重新加载

  使用进程隔离时，连接器进程不会因过期的重新加载而释放。

• 尽管取消了应用程序，但 Amazon Redshift 会话仍在继续运行

  即使正在运行的 QCS 应用程序被取消，Amazon Redshift 会话也会继续运行，直到查询完成。

• 已解决的安全漏洞

  • Direct Access gateway 连接器将所有服务绑定到 0.0.0.0，允许从本地计算机上的每个 IP 地址进行连接，这可能会使服务器暴露在每个可能的网络中。
  • Direct Access gateway 将尝试从用户临时文件路径中不存在的动态生成目录加载 MPR.dll。由于预期位置没有 MPR.dll，攻击者可以在此路径中放置恶意 DLL，安装程序随后可以加载并执行该 DLL。

• 重新启动 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 1.6.6 引入了以下功能和增强功能：

• 支持通过 Direct Access gateway 访问 ServiceNow

  此版本引入了对 ServiceNow（经由 Direct Access gateway）连接器的支持，允许客户通过严格的出站、加密和相互验证的连接安全地访问防火墙 ServiceNow 数据源。

• 使用以下 Direct Access gateway 连接器时支持新的身份验证方法：

  • Azure Synapse Analytics：Azure OAuth 和 Azure Active Directory
  • Azure SQL 数据库：Azure OAuth 和 Azure Active Directory
  • Snowflake：OAuth
  • Databricks：Azure OAuth
  • MongoDB：SCRAM-SHA-256 和 LDAP

• 使用 ODBC 连接器时增强了元数据分页

  通过此增强功能，当检索到 10000 个或更多表时，将以 10000 个为一批的方式检索这些表，以防止超时。

• .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 连接器的支持

  此版本引入了通过 Direct Access gateway 访问 SAP ODP 源的功能。为了便于实现这一点，在 SAP ODP 连接器中添加了一个新的数据网关字段。新字段允许客户选择使用哪个网关来访问其 SAP ODP 源。

  另请参阅：SAP ODP 连接器 （仅提供英文版本）

• 扩展的日志记录功能

  此版本引入了一个新的记录器，Qlik 支持可以使用它来解决特定网关组件的问题。

• 新支持的地区

  日本现在作为 Qlik Cloud 租户地区受支持。

• 性能增强

  改进了加密会话的内存分配。

已解决的问题

Direct Access gateway 1.6.5 解析以下问题：

• 安全漏洞

  使用 ODBC 连接器时，密钥会写入 DCAAS 日志。

• 进程隔离性能

  进程在重负载下启动时需要很长时间。

• 安装路径不正确

  如果安装 Direct Access gateway，则总是会将 Qlik 设置为根文件夹，即使用户在安装向导中选择了不同的文件夹。

新增功能和改进

• 支持从 Administration 活动中心查看和下载日志文件

  此版本引入了在 Administration 活动中心中查看 Direct Access gateway 日志文件并在需要时与 Qlik 支持人员共享这些日志文件的功能。在正常情况下，没有理由查看日志文件，但如果您遇到重复故障或其他问题，日志文件通常有助于查明原因。

  另请参阅：查看和下载日志文件

• 支持静默安装 Direct Access gateway

  客户现在可以静默安装 Direct Access gateway，如果您需要在整个组织的多台机器上进行安装 Direct Access gateway，这将非常有用。

  另请参见：静默安装 Direct Access gateway

• 改进了会话连续性

  当重新加载会话过期时，有时会发生 DirectAccess-1012 错误。现在，Direct Access gateway 将尝试通过更频繁地对 Qlik Cloud 进行 ping 检测来保持重新加载会话的有效性。

已解决的问题

Direct Access gateway 1.6.4 解析以下问题：

• 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 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 不会在错误消息中附加任何附加信息，也不会以任何方式对其进行编辑。

• 处理具有相同重载 ID 的多次重载

  在此版本中，引擎会话 ID 将用于区分具有相同重新加载 ID 的多个重新加载。这将防止潜在的冲突，这些冲突会导致重新加载失败并出现以下错误：

  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）连接器时禁用分块的功能

  此版本为 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 不再需要连接到启动重新加载的记忆棒（与以前一样）。现在，它将连接到第一个可用的记忆棒，而不是重复尝试连接到启动重新加载的记忆棒（这通常会导致重新加载失败）。

已解决的问题

Direct Access gateway 1.6.0 解析以下问题：

• 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).

已解决的问题：

• ODBC（经由 Direct Access gateway）连接器：取消大型表格的重新加载时，连接器有时会崩溃。进行了改进以防止这种情况。

• 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.

• SAP SQL（经由 Direct Access gateway）和 SAP BW（经由 Direct Access gateway）连接器：在日志中增加诊断信息，帮助解决多个并发请求的问题。

新增功能和改进：

• 提供对 ODBC（经由 Direct Access gateway） （仅提供英文版本） 连接器的支持。

• Administration 活动中心中的版本列现在将显示 Direct Access gateway 版本，而不是 RepAgent（其子组件之一）版本。

已解决的问题：

• 升级 Direct Access gateway 会将高级 ODBC 连接器日志记录设置（如日志文件保留期和最大大小）重置为默认值。
• 在极少数情况下，ODBC 连接器会崩溃，Direct Access gateway 代理无法重新启动。
• 当连接失败或 SQL 查询无效时，将返回一个通用的“偏移量和长度越界…”错误，而不是实际的错误原因。
• 在极少数情况下，对于在初始网关查询后延迟或处理时间延长的大于 3 GB 的应用程序，应用中心重新加载将失败，并出现“DirectAccess-4008”错误。添加了额外的日志记录，以帮助识别任何相关问题。

已解决的问题：

• 对 C:\ProgramData\Qlik\Gateway\configuration.properties 文件中 ODBC_LOG_LEVEL 值的更改将无效。

• 如果激活的直接访问网关连接在几分钟内未使用，则重新加载将失败，并出现以下错误：

  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 租户进行身份验证所需的 CA 证书。

此版本解决了以下问题：

Qlik Data Gateway - Direct Access 1.3.1 在某些情况下容易出现 CPU 利用率过高的情况。1.3.2 版解决了这个问题，不包含其他更改。为了防止与 CPU 相关的故障，我们鼓励所有客户立即升级到 1.3.2 版本。

此版本包括 Qlik Cloud 政府 的 CA 捆绑，并解决了几个问题。

Qlik Cloud 政府 的 CA 捆绑文件

CA 捆绑包验证 Qlik Cloud 租户的身份，从而确保可信连接。

在以前的 Direct Access gateway 版本中，Qlik Cloud 政府 客户的 CA 捆绑文件是由 Qlik 根据需要提供的。在此版本中，CA 捆绑包文件包含在安装中。

在默认设置中，CA 捆绑包文件安装到以下位置：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 在重新启动时挂起。
• 改进了重新加载会话处理，以防止不必要的超时。
• Administration 活动中心中的 Direct Access gateway 版本列将指示错误的版本。
• 在用户停止任务或达到配额限制后，代理将继续向网关发送数据。
• 数据网关的端到端加密默认情况下将不会启用，而是由运行时标志控制。

此版本解决了以下问题：

• Qlik 数据网关 – 直接访问 1.2 版由于其数字签名问题，可能无法安装。
• 升级过程中将覆盖配置文件，导致更改丢失

特性和改进：

• 增加了对 SAP BW 和 SAP SQL 源的支持。有关设置与这些源的连接的信息，请参阅 SAP NetWeaver （仅提供英文版本）。

已解决的问题：

• 提高了 Qlik Data Gateway - Direct Access 服务的稳定性和可恢复性，无需手动重新启动服务
• 支持覆盖默认的 Direct Access gateway 安装和配置参数

特性和改进：

• 添加了 Windows Server 2022 支持

已解决的问题：

• 解决了安装过程中与选择自定义路径相关的潜在稳定性问题

1.1.0

2022 年 10 月 18 日

特性和改进：

• 支持 Oracle Wallet
• 支持 Google BigQuery
• 改进了错误消息

已解决的问题：

• 已改进驱动程序崩溃后的系统恢复能力
• Qlik Data Gateway - Direct Access 服务有时会意外停止