升级 Qlik Data Gateway - Direct Access 在该页面上
本节介绍如何升级 Direct Access gateway 安装,并列出每个版本的新特性和增强功能。
性能升级
备份 Direct Access gateway 安装
建议在升级安装之前备份重要 Direct Access gateway 文件。
为此:
停止 Direct Access gateway 服务。
备份 [安装文件夹]\data 中的所有文件(不是子文件夹)。默认位置是 C:\Program Files\Qlik\ConnectorAgent\data 。
这将备份当前版本的租户配置和网关注册文件。
警告注释
请勿将备份保存到 C:\Program Files\Qlik ,因为此文件夹的内容可能会在升级过程中被清除。
在升级过程中,安装程序应将现有的 C:\ProgramData\Qlik\Gateway\configuration.properties 文件的副本创建为 C:\ProgramData\Qlik\Gateway\configuration.properties_BK 。不过,为了以防万一,还是要备份 configuration.properties 文件。
升级完成后,如果您遇到与租户配置相关的问题,请按照下面 恢复 Direct Access gateway 安装 中的步骤进行操作。
警告注释 如果升级过程中出现问题,切勿从 Administration 活动中心删除 Direct Access gateway 。这样做会破坏所有现有的数据连接,因为此时您正在注册一个“新”网关,而不是重新注册现有网关。
升级程序
要升级 Direct Access gateway,只需如阶段一:下载 Qlik Data Gateway - Direct Access 所述再次下载安装文件,然后在 Direct Access gateway 计算机上运行安装程序。
您可以使用以下方法确定已安装 Qlik Data Gateway - Direct Access 的版本:
恢复 Direct Access gateway 安装
升级完成后,如果遇到与租户配置、网关注册或网关配置 (configuration.properties ) 相关的问题,请停止 Direct Access gateway 服务,将备份的文件还原到其原始位置,然后启动 Direct Access gateway 服务。
另请参阅:备份 Direct Access gateway 安装 。
Qlik Data Gateway - Direct Access 版本历史记录
版本
发布日期
重大变化
支持日期结束
1.7.1
2025 年 2 月 11 日
新增功能和改进
REST 连接器
新的 REST(通过 Direct Access gateway) 连接器通过 Direct Access gateway 提供对私有 REST API 端点的安全访问,允许您将数据直接流式传输到 Qlik Sense 应用程序中。
有关更多信息,请参阅 REST 数据源 (仅提供英文版本) 。
信息注释
REST(通过 Direct Access gateway)连接器将分四个阶段向Qlik Cloud 地区推出,第四阶段计划于 2 月 17 日前完成。
覆盖默认的块缓存目录
对于每次重新加载操作,Direct Access gateway 可将数据块缓存在内存中,并将其卸载到磁盘(当超出分配给缓存的大小时)。如果系统驱动器上没有足够的磁盘空间,则可以覆盖默认块缓存目录 (C:\ProgramData\Qlik\Gateway\tmp ) 。
有关更多信息,请参阅覆盖默认的块缓存目录 。
覆盖使用 ODBC(通过 Direct Access gateway 连接器)时检索的默认表数
默认情况下,会检索 10000 个表以供选择,这在处理非常大的数据库时可能还无法满足要求。此版本引入了通过增大 Direct Access gateway configuration.properties 文件中的 ODBC_TABLES_LIMIT_FOR_GENERICODBC 属性来覆盖默认值的能力。
更多信息,请参阅从 ODBC 数据源选择和加载数据 (仅提供英文版本) 。
通过 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 解决了以下问题:
在某些情况下,启用 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 中所述。
已确定下一个主要版本的发布时间
1.7.0
2025 年 1 月 14 日
新增功能和改进
文件连接器
新的文件(通过 Direct Access gateway) 连接器通过 Direct Access gateway 提供安全的文件系统访问,允许您将数据直接流式传输到 Qlik Sense 应用程序中。
有关更多信息,请参阅文件(通过 Direct Access gateway) (仅提供英文版本) 。
通过异步命令支持提高了性能
异步命令支持通过允许 Direct Access gateway 同时处理多个命令而不是一次处理一个命令来提高效率。
信息注释
作为按地区分阶段推出的一部分,对于文件连接器 和通过异步命令提高性能 的支持将于 1 月下半月在 Qlik Cloud 租户中普遍可用,具体时间表如下:
Qlik Cloud 地区
地区代码
已启用
欧洲(伦敦)
eu-west-2
1 月 14 日
欧洲(瑞典)
eu-north-1
日本(东京)
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 日
已解决的问题
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.
已确定下一个主要版本的发布时间
1.6.9
2024 年 10 月 29 日
新增功能和改进
进程隔离现在默认已经打开。
在以前的版本中,默认情况下会关闭进程隔离模式。从 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 解决了块恢复功能的以下问题:
有关块恢复功能的更多信息,请参阅缓存数据以在出现问题时重新加载
2025 年 6 月 14 日
1.6.8
2024 年 9 月 17 日
新增功能和改进
数据块恢复机制
此版本引入了对发送丢失或损坏的数据块的支持。为了控制重新加载的数据块在内存中的大小,在 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/数据管理器预览中将显示重复的列。
2025 年 6 月 14 日
1.6.7
2024 年 7 月 16 日
新增功能和改进
在处理进程隔离时支持自动端口分配
以前,使用默认端口号和范围设置时,无法将 [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT 值设置为高于 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 子句会导致错误。
2025 年 6 月 14 日
1.6.6
2024 年 5 月 14 日
新增功能和改进:
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 临时表不可用)。
为了解决此问题,在 C:\ProgramData\Qlik\Gateway\<GATEWAY-INSTALL-DIR>\configuration.properties 文件中添加了一个新的 ODBC_RELOAD_SESSION_LIFE 参数。新参数设置 ODBC 连接器的重新加载会话持续时间,默认值为 20 秒。
取消重新加载有时会导致 ODBC 进程创建和终止循环。
Direct Access gateway 和 Qlik Cloud Services 之间的连接有时会在没有明显原因的情况下突然终止。
Direct Access gateway 连接重试间隔将不断延长,但永远不会自行重置。重新启动 Direct Access gateway 服务将是重置重试间隔的唯一方法。
当使用不正确的语法从 Oracle 调用存储过程时,重载操作将挂起数小时,而不是立即终止并显示一个信息性错误。
2025 年 6 月 14 日
1.6.5
2024 年 4 月 16 日
新增功能和改进:
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 解析以下问题:
2025 年 6 月 14 日
1.6.4
2024 年 3 月 7 日
新增功能和改进
支持从 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 数量将达到最大值。
2025 年 6 月 14 日
1.6.3
2024 年 1 月 30 日
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)
为了缓解此问题,在 C:\ProgramData\Qlik\Gateway\configuration.properties 文件中添加了一个 EXTEND_FIRST_REQUEST_TIMEOUT 参数(用于延长加载请求超时)。参数值的计量单位为分钟。经常遇到这些错误的客户应该尝试将值设置为 5-10 分钟。
有关详细说明,请参阅 Direct Access gateway 故障排除
支持详细的连接错误信息
增加了在使用基于 ODBC 的 Direct Access gateway 连接器时查看详细连接错误消息的支持。客户现在可以将高级 连接器设置中的 ShowErrorDetailMessage 参数设置为“true”,以查看 ODBC 驱动程序返回的完整错误。详细的错误消息将显示在数据加载编辑器中。
信息注释 错误消息由您正在使用的数据源完整提供。Qlik 不会在错误消息中附加任何附加信息,也不会以任何方式对其进行编辑。
处理具有相同重载 ID 的多次重载
在此版本中,引擎会话 ID 将用于区分具有相同重新加载 ID 的多个重新加载。这将防止潜在的冲突,这些冲突会导致重新加载失败并出现以下错误:
Connector error: data loading error (DirectAccess-4008
2025 年 6 月 14 日
1.6.2
2024 年1 月 9 日
Direct Access gateway 1.6.2 解决了在进程隔离模式下工作时有时会导致连接器代理崩溃的问题。
警告注释 强烈建议在进程隔离模式下使用 Direct Access gateway 1.6.1 的客户升级到此版本。
2025 年 6 月 14 日
1.6.1
2023 年 12 月 12 日
新功能和改进
Direct Access gateway 1.6.1 引入了几个重要的功能和增强功能,提高了整体稳定性和性能。
添加了在使用 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).
2025 年 6 月 14 日
1.5.3
2023 年 9 月 23 日
已解决的问题:
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)连接器: 在日志中增加诊断信息,帮助解决多个并发请求的问题。
2024 年 6 月 12 日
1.5.2
2023 年 9 月 12 日
新增功能和改进:
已解决的问题:
升级 Direct Access gateway 会将高级 ODBC 连接器日志记录设置(如日志文件保留期和最大大小)重置为默认值。
在极少数情况下,ODBC 连接器会崩溃,Direct Access gateway 代理无法重新启动。
当连接失败或 SQL 查询无效时,将返回一个通用的“偏移量和长度越界…”错误,而不是实际的错误原因。
在极少数情况下,对于在初始网关查询后延迟或处理时间延长的大于 3 GB 的应用程序,应用中心重新加载将失败,并出现“DirectAccess-4008”错误。添加了额外的日志记录,以帮助识别任何相关问题。
2024 年 6 月 12 日
1.4.2
2023 年 7 月 13 日
已解决的问题:
对 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.
对该问题进行了更准确的描述,从而改进了错误消息。
由于内存消耗过大,多次重新加载尝试有时会失败。
2024 年 2 月 19 日
1.4.1
2023 年 6 月 20 日
特性和改进:
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)
2024 年 2 月 19 日
1.4.0
2023 年 6 月 15 日
已更新对 Qlik Cloud 租户进行身份验证所需的 CA 证书。
2024 年 2 月 19 日
1.3.2
2023 年 5 月 30 日
此版本解决了以下问题:
Qlik Data Gateway - Direct Access 1.3.1 在某些情况下容易出现 CPU 利用率过高的情况。1.3.2 版解决了这个问题,不包含其他更改。为了防止与 CPU 相关的故障,我们鼓励所有客户立即升级到 1.3.2 版本。
2023 年 9 月 15 日
1.3.1
2023 年 5 月 9 日
此版本包括 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
已解决的问题
2023 年 9 月 15 日
1.3.0
2023 年 2 月 16 日
此版本解决了以下问题:
Qlik Data Gateway – Direct Access 1.2 版由于其数字签名问题,可能无法安装。
升级过程中将覆盖配置文件,导致更改丢失
2023 年 9 月 15 日
1.2.0
2023 年 1 月 24 日
特性和改进:
增加了对 SAP BW 和 SAP SQL 源的支持。有关设置与这些源的连接的信息,请参阅 SAP NetWeaver (仅提供英文版本) 。
已解决的问题:
提高了 Qlik Data Gateway - Direct Access 服务的稳定性和可恢复性,无需手动重新启动服务
支持覆盖默认的 Direct Access gateway 安装和配置参数
2023 年 5 月 16 日。
1.1.1
2022 年 11 月 15 日
特性和改进:
添加了 Windows Server 2022 支持
已解决的问题:
解决了安装过程中与选择自定义路径相关的潜在稳定性问题
2023 年 4 月 24 日
1.1.0
2022 年 10 月 18 日
特性和改进:
支持 Oracle Wallet
支持 Google BigQuery
改进了错误消息
已解决的问题:
已改进驱动程序崩溃后的系统恢复能力
Qlik Data Gateway - Direct Access 服务有时会意外停止
2023 年 4 月 24 日
1.0.0
2022 年 8 月 23 日
初始版本
2023 年 4 月 24 日
卸载 Qlik Data Gateway - Direct Access
您可以卸载不再使用的 Direct Access gateway ,方法是在 Windows 应用程序 > 已安装应用程序 列表中找到它,然后从该行末尾的 菜单中选择卸载 。