偵錯資料載入指令碼

您可使用資料載入編輯器中的偵錯公用程式,透過使用中斷點逐步執行您的指令碼,從而使您能夠檢查指令碼執行的變數值和輸出。您可選取是否檢視任何或所有輸出變數中斷點

為顯示偵錯面板,請執行以下操作:

  • 資料載入編輯器工具列中按一下 u

    偵錯面板會在資料載入編輯器的底部開啟。

備註: 您不可在執行偵錯模式時建立連線、編輯連線、選取資料、儲存指令碼或載入資料。偵錯模式以偵錯執行開始,直至執行指令碼或終止執行。

偵錯工具列

資料載入編輯器偵錯面板包含一個工具列,當中有以下選項用於控制偵錯執行:

偵錯工具列選項
UI 項目 描述
限制載入

啟動以限制從各資料來源載入的資料列數目。如果您的資料來源巨大,這有助於縮短執行時間。

輸入要載入的列數。

備註: 這僅適用於實體資料來源。例如,自動產生和內嵌載入將不受限制。
œ 以偵錯模式啟動或繼續執行,直至達到下一個中斷點。
Œ 跳至下一行程式碼。
在此結束執行。如果您在執行所有程式碼前終止,產生的資料模型將僅包含截至終止執行所在程式碼行的資料。

輸出

輸出會顯示在偵錯執行時產生的所有訊息。當顯示新訊息時,您可按一下 \ 選取鎖定輸出來防止捲動。

此外,輸出功能表 (¨) 包含以下選項:

輸出功能表選項
UI 項目 描述
清除 按一下此選項來刪除所有輸出訊息。
選取所有文字 按一下此選項來選取所有輸出訊息。
捲動至底端 按一下此選項來捲動至最後一條輸出訊息。

變數

變數列出所有保留的變數、系統變數和指令碼中定義的變數,並顯示指令碼執行期間的目前值。

將變數設定為我的最愛

如果您想在執行期間檢查特定變數,則可將這些變數設定為我的最愛。我的最愛變數顯示於變數清單頂部,並標示黃色星號。如需將變數設定為我的最愛,執行以下步驟:

  • 按一下變數旁邊的 ï

    ï 現為黃色,變數移至變數清單頂部。

篩選變數

您可套用篩選,使用變數功能表 (¨) 中的以下選項,僅顯示選定類型的變數:

變數功能表選項
UI 項目 描述
顯示所有變數 按一下以顯示所有類型變數。
顯示系統變數

按一下以顯示系統變數。

系統變數由 Qlik Sense 定義,但您可變更指令碼中的變數值。

顯示保留的變數

按一下以顯示保留的變數。

保留的變數由 Qlik Sense 定義,且值不可變更。

顯示使用者定義的變數

按一下以顯示使用者定義的變數。

使用者定義的變數為您在指令碼中定義的變數。

若要進一步瞭解變數,請參閱 在資料載入編輯器中使用變數

中斷點

您可新增中斷點至您的指令碼,以便在特定程式碼行終止偵錯執行,並檢查該點的變數值和輸出訊息。您到達中斷點後,便可選取停止執行,繼續直至到達下一中斷點,或進入下一程式碼行。指令碼中的所有中斷點均已列出,並包含區段和行編號的參考。

新增中斷點

如需在程式碼行新增中斷點,則執行以下其中一項:

  • 在指令碼中,直接按一下您想新增中斷點的行編號右邊區域。

    行編號旁邊的 Q 將表示該行有中斷點。

提示: 您甚至可在偵錯面板關閉時新增中斷點。

刪除中斷點

您可執行以下任一操作,刪除中斷點:

  • 在指令碼中,按一下行編號旁邊的 Q

  • 在中斷點清單中,按一下中斷點旁邊的 E

您還可按一下 ¨,選取全部刪除,以從指令碼中刪除所有中斷點。

啟用和停用中斷點

在建立時預設為啟用的中斷點,以中斷點清單內中斷點旁邊的 m 表示。您可透過選取和取消選取中斷點清單中的個別中斷點實現啟用和停用。

您在中斷點功能表 (¨) 中還有以下選項:

  • 全部啟用
  • 全部停用