# 调试数据加载脚本

您可以使用数据加载编辑器中的调试实用程序通过使用中断点单步调试脚本的执行，这样能够让您检查脚本执行的变量值和输出。

您可以指定是查看任何还是所有输出、变量和中断点。

要显示调试面板，请执行以下操作：

* 在数据加载编辑器工具栏中单击 the 调试 icon 。

  随即在数据加载编辑器的底部打开调试面板。

信息注释在调试模式下运行的同时，都无法创建连接、编辑连接、选择数据、保存脚本或加载数据。调试模式以调试执行开始并继续执行，直到执行脚本或执行已结束。

## 调试工具栏

数据加载编辑器调试面板包含一个工具栏，该工具栏包含用于控制调试执行的下列选项：

调试工具栏选项

| UI 项目 | 描述 |
| --- | --- |
| the 播放 icon | 在调试模式下开始或继续执行，直到下一个中断点。 |
| the 步进 icon | 步进到代码的下一行。 |
| the 停止 icon | 在此结束执行。如果在执行所有代码之前结束，则生成的数据模型仅包含截止执行结束时所在的代码行的数据。 |
| the 停止 icon | 单击此图标可访问以下设置：<br><br><ul> <li> <p><span>限制加载</span>：启用该选项可限制要从每个数据源加载的数据的行数。如果数据源很大，该选项可用于减少执行时间。</p> <p>输入要加载的行数。</p> <div><span>信息注释</span>该选项仅适用于物理数据源。例如，自动生成和不限制内联加载。</div> </li> <li> <p><span>使用</span> <span>STORE</span><span>命令</span>：执行加载脚本中的任何 <span>STORE</span> 语句，而不是跳过它们。启用此设置后，文件将由 <span>STORE</span> 语句生成，就像使用常规数据加载时一样。</p> </li> </ul> |

## 输出

输出用于显示在调试执行期间所生成的所有消息。您可以在显示所有消息时通过单击 the 锁定 icon 选择锁定滚动输出。

此外，输出菜单 the 菜单 icon 包含下列选项：

输出菜单选项

| UI 项目 | 描述 |
| --- | --- |
| 清除 | 单击该选项可删除所有输出消息。 |
| 选择所有文本 | 单击该选项可选择所有输出消息。 |
| 滚动到底部 | 单击该选项可滚动到最后一条输出消息。 |

## 变量

变量所有保留变量、系统变量和在脚本中定义的变量，并在脚本执行期间显示当前值。

### 将变量设置为常用变量

如果想要在执行期间检查特定变量，可以将它们设置为常用变量。常用变量显示在变量列表的顶部，标有黄色星形。要将变量设置为常用变量，请执行以下操作：

* 单击变量旁边的 the 收藏夹 icon。

  现在，the 收藏夹 icon 显示为黄色，然后将变量移动到变量列表的顶部。

### 筛选变量

可以应用筛选器使用变量菜单 the 菜单 icon 中的以下选项只显示选定类型变量：

变量菜单选项

| UI 项目 | 描述 |
| --- | --- |
| 显示所有变量 | 单击该选项可显示所有类型变量。 |
| 显示系统变量 | 单击该选项可显示系统变量。<br><br>系统变量由 Qlik Sense 定义，但可以在脚本中更改变量值。 |
| 显示保留变量 | 单击该选项可显示保留变量。<br><br>保留变量由 Qlik Sense 定义且无法更改其值。 |
| 显示用户定义的变量 | 单击该选项可显示用户定义的变量。<br><br>用户定义的变量是您在脚本中定义的变量。 |

要了解有关变量的更多信息，请参阅[在数据加载编辑器中使用变量](https://help.qlik.com/zh-CN/sense/November2024/Subsystems/Hub/Content/Sense_Hub/Scripting/work-with-variables-in-data-load-editor.htm)。

## 中断点

您可以将中断点添加到脚本以停止调试执行某些代码行，并在此时检查变量值和输出消息。当到达中断点后，可以选择停止执行，继续执行直到下一个中断点或步进到下一行代码。已在脚本中列出了所有中断点，引用代码段和行号。

### 添加中断点

要在代码行中添加中断点，请执行下列操作之一：

* 在脚本中，直接单击要添加中断点的行号右边的区域。

  行号旁边的 the 移除 icon 表示在此代码行中有中断点。

提示注释您甚至可以在关闭调试面板后添加中断点。

### 删除中断点

您可以通过执行下列操作之一删除中断点：

* 在脚本中，单击行号旁边的 the 移除 icon。

* 在中断点列表中，单击中断点旁边的 the 取消 icon。

还可以单击 the 全部删除 icon，然后选择从脚本中删除所有中断点。

### 启用和禁用中断点

创建中断点时，中断点默认处于启用状态，在中断点列表中通过中断点旁边的 the 复选标记 icon 表示。可以通过在中断点列表中选择和取消选择个别中断点以启用和禁用中断点。

还可以使用中断点菜单 the 菜单 icon 中的以下选项：

* 全部启用
* 全部禁用

相关学习:

* [数据加载编辑器简介](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)

## 了解详情

* [数据加载编辑器简介](https://help.qlik.com/lnk/Intro_Data_Load_Editor_QS)