# 偵錯資料載入指令碼

您可使用資料載入編輯器或 指令碼 中的偵錯公用程式，透過使用中斷點逐步執行您的指令碼，從而使您能夠檢查指令碼執行的變數值和輸出。

您可選取是否檢視任何或所有輸出、變數和中斷點。

為顯示偵錯面板，請執行以下操作：

* 在資料載入編輯器工具列中按一下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-TW/cloud-services/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)