# 故障排除 — 加载数据

本部分介绍在 Qlik Cloud Analytics 和 Qlik Sense 中加载和建模数据时可能会发生的问题。

## 通过将文件拖放至添加数据附加文件不起作用

您正在尝试通过拖出文件然后放置到 添加数据/附加文件 对话框来附加文件，但是文件没有上传。

此文件储存于 ZIP 存档中。无法附加来自 ZIP 存档的单独文件。

附加文件前，从 ZIP 存档提取文件。

## 使用非 ANSI 编码的数据文件时出现字符集问题

当使用 ANSI 数据连接时，您可能会在非 ODBC 编码的数据文件中对字符进行编码时出现问题。

ODBC 数据连接不提供用于对字符集进行编码的全部功能。

执行以下操作：

* 如果可能，使用文件夹数据连接导入数据文件，这样可以通过多种选择支持处理字符代码。如果您正在加载 Microsoft Excel 电子表格或文本数据文件，则该选择可能是最好的选择。

## 加载数据时出现循环引用警告

如果您已加载两个以上的表格，可以按照在两个字段之间存在多条关联路径的方式关联表格，这样可能会导致在数据结构中出现循环。

有关更多信息，请参阅[了解并解决循环引用](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/understand-circular-references.htm)。

## 在从固定的记录文件选择数据时，列未如预期排列。

文件使用制表符来整合各列。一般情况下，如果在选择对话框中选择字段断开，您将看到字段标题没有和预期的数据对齐。

在这种情况下，制表符通常等同于大量字符。

执行以下操作：

1. 在字段名称中选择没有字段名称。
2. 选择 字段断开。
3. 增大制表符大小的设置，直到列和标题对齐。
4. 通过单击相应的列位置插入字段断开。
5. 选择数据预览。
6. 在字段名称中选择嵌入的字段名称。

列现在正确对齐，并且每个字段都应当有正确的字段名称。

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Troubleshooting/troubleshooting-load-data.htm)

## 连接器无法使用

您试图在数据加载编辑器中为单独安装的连接器创建数据连接，但连接失败，或者现有连接标记为未知。

### 连接器无法正确安装

根据安装说明无法正确安装连接器。如果应用程序在多节点站点上使用连接器，则连接器需要安装在所有节点上。

执行以下操作：

* 验证是否根据有关站点所有节点的说明安装自定义连接器。

### 无法为 Qlik Sense 调整连接器

如果要能够选择数据，可能需要为 QlikView 调整 Qlik Sense 连接器。

建议的操作 （如果您自己使用 QVX SDK 开发连接器）

执行以下操作：

* 您需要使用接口为 Qlik Sense 调整连接器以选择数据。

建议的操作 （如果已经为您提供连接器）

执行以下操作：

* 请与连接器提供商联系以获取 Qlik Sense 适应连接器。

## 在重新启动 SQL Server 后数据连接停止工作

如果您创建指向 SQL Server 的数据连接，然后重新启动 SQL Server，则数据连接可能会停止工作，并且您无法选择数据。Qlik Sense 已失去与 SQL Server 的连接，并且无法重新连接。

Qlik Sense:

执行以下操作：

* 关闭应用程序，然后从应用中心再次打开它。

Qlik Sense Desktop:

执行以下操作：

1. 关闭所有应用程序。
2. 重新启动 Qlik Sense Desktop。

## 数据加载编辑器不显示脚本

数据加载编辑器 打开时，编辑器的内容为空白，并且无法编辑脚本。

脚本包含非常复杂的结构，例如，大量嵌套 IF 语句。

通过向 URL 添加 /debug/dle\_safe\_mode，在安全模式中打开数据加载编辑器。这将禁用语法高亮显示和自动完成功能，但您应能编辑和保存脚本。

提示注释考虑将脚本的复杂部分移至单独的文本文件，并使用 include 变量在运行时将其注入脚本。有关更多信息，请参阅[Include](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/Include.htm)。

## 数据加载脚本执行且没有出错，但不加载数据

脚本执行且没有出现语法或加载错误，但无法按预期加载数据。一般建议是激活脚本调试步骤并检查执行结果，但此处可能存在一些导致出错的常见原因。

有关更多信息，请参阅[调试数据加载脚本](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/debug-data-load-script.htm)。

### 语句不以分号终止

您忘记了使用分号终止语句。

执行以下操作：

* 可以使用分号终止所有语句。

### 字符串包含单引号字符

字符串包含单引号字符，如 SET 变量语句。

执行以下操作：

* 如果字符串包含单引号字符，则需要使用额外的单引号进行转义。

有关更多信息，请参阅[在脚本中使用引号](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm)。

## 数据管理器不显示包含数据的应用程序中的表格

打开在早于 3.0 的 Qlik Sense 版本中创建的应用程序时，数据管理器不显示任何表格，并显示应用程序不包含数据的消息。

Qlik Sense 3.0 和更高版本中改善的数据模型需要加载数据才能完成数据分析和准备。

在数据管理器中单击加载数据。这要求应用程序可以访问应用程序中使用的数据源。

## 对于在服务器上创建应用程序的所有用户，数据管理器工作流中断

用户试图在数据管理器中使用添加数据或加载数据，或者在浏览器中刷新应用程序时收到错误。

数据管理器使用 QVD 文件缓存加载的数据。不再使用这些文件时，它们会自动删除，但在大量累积或发生损坏后，它们会导致错误。

删除包含 QVD 文件的文件夹。在 Qlik Sense 服务器上，缓存位置如下：

<Qlik Sense共享文件夹>\应用程序\DataPrepAppCache

在 Qlik Sense Desktop 上，缓存位置如下：

C:\Users\<用户名>\文档\Qlik\Sense\应用程序\DataPrepAppCache

## 在使用 OLE DB 数据源时出现数据选择问题

如果您无法从 OLE DB 数据连接选择数据，可能需要检查配置的连接方式。

执行以下操作：

1. 验证连接字符串设计是否正确。

2. 验证是否使用适当的凭据登录。

有关更多信息，请参阅[连接到数据源](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/connect-data-sources.htm)。

## 日期字段未在工作表视图中识别为日期字段

您拥有包含日期或时间戳数据的字段，但是它们在工作表视图中未识别为日期字段，即是说，在资产面板和其他字段列表中未用 the Date and time icon 指示它们。

### 添加表格时数据分析已禁用

添加表格时，您通过the 按钮旁的 icon添加数据 禁用了数据分析。

使用该选项，识别的日期和时间戳字段将正确发挥作用，但是在资产面板和其他字段列表中不会用 the Date and time icon 指示它们，并且展开的属性字段不可用。

打开数据管理器并单击加载数据。

现在所有日期和时间戳字段都应当在工作表视图的资产面板中用 the Date and time icon 指示。如果仍然未用 the Date and time icon 指示它们，则可能是字段数据使用了无法识别为日期的格式。

### 无法识别日期格式

在加载表格时，未识别日期字段的输入格式。通常，Qlik Sense 会根据区域设置和共用日期格式自动识别日期字段，但是在某些情况下您可能需要指定输入格式。

打开数据管理器并编辑包含无法识别为日期的字段的表格。大多数情况下会使用 the field type icon 将字段指示为一般字段。使用匹配字段数据的输入格式将字段类型更改为日期或时间戳。

有关更多信息，请参阅[确保正确识别日期或时间戳](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/changing-date-time-format.htm#Making)。

## 附加文件时，弹出错误信息“无效路径”

文件名太长。Qlik Sense 仅支持最多包含 171 个字符的文件名。

将文件重命名为包含少于 172 个字符的名称。

## 加载从 QlikView 文档转换的应用程序时出错

重新加载从 QlikView 文档转换的应用程序时，可能会收到错误信息提醒。

### 脚本中使用的绝对文件路径参考

加载脚本是指使用绝对路径的文件，其在 Qlik Sense 标准模式中不受支持。错误信息示例包括 "Invalid Path" 和 "LOAD statement only works with lib:// paths in this script mode"。

执行以下操作：

* 将含 lib:// 引用的所有文件引用在 Qlik Sense 中替换为数据连接。

有关更多信息，请参阅[将 QlikView 文档转换为 Qlik Sense 应用程序](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/create-app-from-document.htm)。

### 脚本中使用的不受支持的函数或语法

如果在数据加载编辑器中运行脚本时出现语法错误，则表明可能 QlikView 不支持正在使用的 Qlik Sense 脚本语句或函数。

执行以下操作：

* 删除无效的语句或使用有效的语句进行替换。

有关更多信息，请参阅[Qlik Sense 不支持的 QlikView 函数和语句](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/QlikView-functions-statements-not-supported.htm)。

## Microsoft Excel：从数据管理器或数据加载编辑器中的文件加载数据失败

Excel 电子表格启用了冻结窗格或拆分屏幕，并且表格中存在空的单元格。

禁用冻结窗格或拆分屏幕，或者整理电子表格，然后重新加载数据。

## Microsoft Excel: 连接到文件或通过 ODBC 从文件加载数据时出现问题

当设置 ODBC 数据连接连接至 MicrosoftExcel 文件或通过 MicrosoftExcel 数据连接从 ODBC 文件加载数据时，您可能会遇到问题。这通常是因为 Windows 中的 ODBCDSN 配置存在问题，或者相关联的 ODBC 驱动程序存在问题。

Qlik Sense 支持本地加载 MicrosoftExcel 文件。如果可以，使用连接至含 ODBC 文件的文件夹的文件夹数据连接替换 MicrosoftExcel 数据连接。

## 磁盘空间不足

有多种原因会造成系统磁盘空间不足，数据管理器在 QVD 文件中缓存加载的数据就是一个可能的原因。

删除包含 QVD 文件的文件夹。在 Qlik Sense 服务器上，缓存位置如下：

<Qlik Sense共享文件夹>\应用程序\DataPrepAppCache

在 Qlik Sense Desktop 上，缓存位置如下：

C:\Users\<用户名>\文档\Qlik\Sense\应用程序\DataPrepAppCache

## 加载数据时出现合成钥警告

如果您已加载多个文件，可能会收到一个警告，提示已在加载数据后创建合成钥。

如果两个表格包含多个公共字段，那么 Qlik Sense 将创建一个合成钥以解决链接问题。

有关更多信息，请参阅[合成钥](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/synthetic-keys.htm)。

在很多情况下，如果链接有意义，那么您不需要对合成钥执行任何操作，但建议您在数据模型查看器中审核数据结构。

## 具有共用字段的表格未自动按字段名称关联

您已使用添加数据添加了两个或多个表格。表格具有带共用字段名称的字段，但是它们未自动关联。

添加表格时，您保留了在添加数据对话框中启用数据分析的默认选项。该选项会自动限定在表格之间共用的所有字段名称。例如，如果您使用此选项添加具有共用字段 A 的表格 B 和表格 F1，此字段在表格 F1 中将被命名为 A，在表格 B.F1 中被命名为 B。这意味着表格不会自动关联。

打开数据管理器并选择关联视图。现在您可根据数据分析建议关联表格。

如果您有关联的表格，则单击加载数据。

有关更多信息，请参阅[管理数据关联](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/LoadData/associating-data.htm)。