Troubleshooting SQL Server made easy via Notebooks – seeking your feedback
Published Sep 21 2021 09:35 PM 6,572 Views

As part of our journey in making troubleshooting experience easier for our customers, we have learned from our research and studies, that Jupyter Notebook is a great way to do this.  Code and documentation can be in one place, which boosts users’ workflow. To continue in this effort, we are currently experimenting with SQL Server DOCs articles that are rich with code snippets. These articles are ideal for executable troubleshooting guides in Jupyter Notebook format that can be launched, edited and executed directly in Azure Data Studio client tool, i.e. less copying and pasting!


To illustrate the new experience, a database administrator, Gloria, searches online on how to troubleshoot SQL Server Error 9002. She finds an article such as Troubleshooting a Full Transaction Log (SQL Server Error 9002) which shows an [Open Notebook in Azure Data Studio] button. Clicking on the button will allow Gloria to launch a Jupyter Notebook equivalent to the article, in order to troubleshoot SQL Server Error 9002 in Azure Data Studio.




This allows Gloria then to read through the description about the error in the notebook, and then execute the code cells to start diagnosing. No copy and pasting!




Articles with troubleshooting notebooks (Preview)

To try out this new Docs to Jupyter Notebooks experience, check out these two articles. In these articles, you can click on “Open Notebook in Azure Data Studio” which will launch the equivalent notebook for the article. Please note that you will need to have Azure Data Studio installed on your local machine first (


These articles were selected for this experimentation phase due to high frequency of these problems being reported to Microsoft CSS.


Seeking feedback

What are your thoughts on this experience? Please vote on this Github item and provide comments so we can improve the experience further. [Seeking Feedback] From SQL Server docs articles to notebooks in Azure Data Studio · Issue #16648

For more information on what the expected experience looks like, watch the animated gifs below:


Launching and running a SQL Notebook in Azure Data Studio







Launching and running a PowerShell Notebook in Azure Data Studio




Channel 9 Presentation of the feature

Notebook Views in Azure Data Studio | Data Exposed - YouTube


Learn more



Joseph Pilov & Julie Koesmarno


Version history
Last update:
‎Dec 04 2021 08:23 PM
Updated by: