Azure Data Studio 疑難排解

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

回報您遇到的問題

向 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 Tools 服務的記錄
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 資料夾。

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

下一步

• 回報問題
• 什麼是 Azure Data Studio