閱讀英文版本

分享方式：

針對 Azure Data Studio 進行疑難排解

  • 文章

重要

Azure Data Studio 將於 2026 年 2 月 28 日停用。 建議您使用 Visual Studio Code。 如需移轉至 Visual Studio Code 的詳細資訊，請流覽 Azure Data Studio 發生什麼事？

Azure Data Studio 會針對 存放庫，在 azuredatastudio \(英文\) 上追蹤問題與功能要求。

回報您遇到的問題

將問題回報給 GitHub 問題追蹤器，並提供任何有助於重現該錯誤的詳細資料。 包含來自記錄檔的所有記錄資訊。

撰寫良好的錯誤 (Bug) 報表與功能要求

針對每個問題與功能要求提出單一問題。

  • 不要在同一個問題中列舉多個錯誤 (Bug) 或功能要求。
  • 除非您的問題來自相同的輸入，否則不要將該問題當成現有問題的註解來新增。 許多問題看起來類似，但原因不同。

您可提供的資訊越多，某人成功重現問題並找出修正方式的可能性就越大。

在每個問題中包含下列資訊：

  • Azure Data Studio 的版本
  • 可重現的步驟 (1...2...3...)，以及您期望的結果與實際看到的內容。
  • 影像、動畫或影片的連結。 影像與動畫可說明重現步驟，但無法加以取代。
  • 示範問題的程式碼片段或程式碼存放庫的連結，讓我們能夠輕鬆地將其提取到我們的機器上來重建問題。

備註

由於我們需要複製並貼上程式碼片段，因此，以媒體檔案 (也就是 .gif) 形式包含程式碼片段是不夠的。

  • 開發工具主控台中的錯誤 (說明 > 切換開發人員工具)

請記得執行下列步驟：

  • 搜尋問題存放庫，以查看是否存在相同的問題。
  • 簡化靠近問題的程式碼，以便讓問題能夠浮現出來。

如果我們無法重現該問題並要求更多資訊，請不要有任何不好的感受！

如何設定記錄層級

Azure Data Studio

在命令選擇區 (Ctrl/Cmd + Shift + P) 執行開發人員：設定記錄層級...命令，以選取目前工作階段的記錄層級。 此值不會保存在多個工作階段上。 如果您重新啟動 Azure Data Studio，它會還原回預設的 Info 層級。

如果您想要啟用偵錯記錄以進行啟動，請將記錄層級設定為 Debug 並執行開發人員：重新載入視窗命令。

MSSQL (內建延伸模組)

如果 Mssql: Log Debug Info 使用者設定已設為 True，則偵錯記錄資訊會傳送至 MSSQL 輸出通道。

Mssql: Tracing Level 使用者設定會用來控制記錄的詳細程度。

Azure Data Studio 記錄和位置

從 [命令選擇區] (Ctrl/Cmd + Shift + P) 執行 [開發人員：開啟 Logs 資料夾] 命令以開啟記錄的路徑。 有許多不同類型的記錄檔會寫入在該處。 這是一些常用的項目：

  1. renderer#.log (例如 renderer1.log)：此檔案是主要程序的記錄檔。
  2. telemetry.log：將記錄層級設為 Trace 時，此檔案將包含 Azure Data Studio 所傳送的遙測事件
  3. exthost#/exthost.log：延伸模組主機程序的記錄檔 (這只是程序本身，而不是在其中執行的延伸模組)
  4. exthost#/Microsoft.mssql：mssql 延伸模組的記錄，其中包含 MSSQL 相關功能的許多核心邏輯
    • sqltools.log 是 SQL 工具服務的記錄
  5. exthost#/output_logging_#######：這些資料夾均包含 Azure Data Studio 的 Output 面板中所顯示的訊息。 將每個檔案命名為 #-<Channel Name>。 例如，Notebooks 輸出通道可能會輸出到名為 3-Notebooks.log 的檔案。

如果系統要求您提供記錄，請壓縮整個資料夾，以確保會包含正確的記錄。

在當機後復原編輯器檔案

如果 Azure Data Studio 意外當機，重新啟動 Azure Data Studio 也應該會重新開啟任何未儲存的編輯器檔案。 如果沒有，嘗試重新開啟它們時可能發生錯誤。 在此情況下，請遵循下列步驟，瀏覽至包含備份的資料夾，您可以在其中手動開啟備份以復原其內容。

  1. 從 [命令選擇區] (Ctrl/Cmd + Shift + P)，執行 [開發人員：開啟使用者資料資料夾] 命令。
  2. 在開啟的資料夾中，瀏覽至 Backups 資料夾。

這包含具有隨機產生的名稱的資料夾。 在這些資料夾內，是包含編輯器備份的檔案 (其中包含一些額外的中繼資料及其文字內容)。

下一步