SQL Runner 可直接存取資料庫，您可以使用這項工具，為 LookML 專案建立及偵錯衍生資料表。使用 SQL Runner 定義新的衍生資料表並排解現有資料表的問題，確保資料準確度並改善開發工作流程。本指南說明如何使用 SQL Runner 執行這些工作。
本頁說明如何使用 SQL Runner 建立衍生資料表，以及如何使用 SQL Runner 偵錯衍生資料表。如需下列資訊，請參閱其他說明文件頁面：
將 SQL Runner 查詢新增至 LookML 專案
SQL Runner 非常適合用來測試 SQL，以便在 LookML 專案中做為衍生資料表。您甚至可以從其他工具取得 SQL 查詢，在 SQL Runner 中測試，然後新增至 LookML 專案。
在 SQL Runner 中建立 SQL 查詢後，您可以使用「新增至專案」選項或「取得衍生資料表 LookML」選項，從查詢建立衍生資料表。這兩種選項都可讓您在 SQL Runner 中執行查詢，並將查詢新增至 LookML 專案。詳情請參閱以下各節。
新增至專案
使用「新增至專案」選項，是將 SQL Runner 查詢新增至專案最簡單的方法：
使用「新增至專案」選項選取 LookML 專案後，Looker 會自動在所選專案中建立含有查詢的檢視表檔案。如果您想手動建立檢視表檔案，並自行新增查詢的 LookML，可以使用「取得衍生資料表 LookML」選項。
如要使用「新增至專案」選項，請按照下列步驟操作：
- 使用 SQL Runner 建立要用於衍生資料表的 SQL 查詢。
- 按一下右上角齒輪選單中的「新增至專案」。
- 選取要新增這個衍生資料表的專案。
- 輸入衍生資料表的檢視名稱。
- 按一下「新增」，將查詢新增為專案中的衍生資料表。如果 Looker 尚未處於開發模式，系統會切換至該模式，並使用 SQL Runner 查詢中的 LookML 建立新的檢視表檔案，然後開啟 IDE 檔案瀏覽器，顯示新的檢視表檔案。
- 移動檔案，以符合專案的檔案結構。
- 驗證 LookML，然後將變更部署至正式環境。
取得衍生資料表 LookML
如要從 SQL Runner 查詢建立衍生資料表，也可以使用 SQL Runner 齒輪選單中的「取得衍生資料表 LookML」選項。與「新增至專案」選項相同，Looker 會提供將 SQL 查詢轉換為衍生資料表所需的 LookML。接著，您可以複製 LookML 並自行貼到專案中，這在您想取代現有衍生資料表時非常實用。
如要從 SQL Runner 查詢建立衍生資料表，請按照下列步驟操作：
- 使用 SQL Runner 建立要用於衍生資料表的 SQL 查詢。
- 按一下齒輪選單，然後選取「取得衍生資料表 LookML」。
在「取得衍生資料表 LookML」彈出式視窗中，按一下「將其新增至專案」連結。
使用「專案」下拉式清單，選擇要新增衍生資料表的專案。
在「資料檢視名稱」欄位中輸入新的檢視畫面名稱。如需檔案命名慣例，請參閱「管理 LookML 檔案和資料夾」頁面。
按一下「新增」按鈕。 如果 Looker 尚未處於開發模式，系統會切換至該模式，並使用 SQL Runner 查詢中的 LookML 建立新的檢視表檔案，然後開啟 IDE 檔案瀏覽器，顯示新的檢視表檔案。
移動檔案，以符合專案的檔案結構。
使用 SQL Runner 偵錯
SQL Runner 也很適合用來檢查衍生資料表定義中的 SQL 錯誤。
SQL Runner 錯誤醒目顯示
SQL Runner 會醒目顯示 SQL 指令中的錯誤位置，並在錯誤訊息中指出錯誤位置。
提供的位置資訊會因資料庫方言而異。舉例來說，MySQL 會提供含有錯誤的行號，而 Redshift 則會提供錯誤的字元位置。其他資料庫方言可能會有其中一種或其他行為。
SQL Runner 也會以紅色底線標出 SQL 指令中第一個語法錯誤的位置，並在該列標上「x」。將滑鼠游標懸停在「x」上，即可查看錯誤的詳細資訊。修正該問題後，按一下「執行」，查看查詢中是否還有其他錯誤。
使用 SQL Runner 測試衍生資料表
如果看到衍生資料表發生錯誤，您可以將 SQL 陳述式複製到 SQL Runner，並測試 SQL 的不同部分，縮小錯誤位置範圍，找出錯誤原因。詳情請參閱「Using SQL Runner to test derived tables」Looker 社群貼文。