Merge pull request #36083 from MicrosoftDocs/main

Auto Publish – main to live - 2025-12-15 23:30 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -50822,7 +50822,12 @@
     },
     {
       "source_path": "docs/advanced-analytics/install/sql-machine-learning-azure-data-studio.md",
-      "redirect_url": "/sql/machine-learning/install/sql-machine-learning-azure-data-studio",
+      "redirect_url": "/sql/machine-learning/install/sql-machine-learning-visual-studio-code",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/machine-learning/install/sql-machine-learning-azure-data-studio.md",
+      "redirect_url": "/sql/machine-learning/install/sql-machine-learning-visual-studio-code",
       "redirect_document_id": true
     },
     {

docs/database-engine/service-broker/broker-system-messages.md

@@ -24,9 +24,9 @@ In addition to the application-defined message types specified in the contract,
 
 ## Error messages
 
-When a remote service ends a dialog with an error or the local broker detects an unrecoverable error in a dialog, the local broker creates an Error Message. Error messages are of message type `https://schemas.microsoft.com/SQL/ServiceBroker/Error`. Error messages are validated as well-formed XML.
+When a remote service ends a dialog with an error or the local broker detects an unrecoverable error in a dialog, the local broker creates an Error Message. Error messages are of message type `http://schemas.microsoft.com/SQL/ServiceBroker/Error`. Error messages are validated as well-formed XML.
 
-The XML document that is contained in an error message uses the namespace `https://schemas.microsoft.com/SQL/ServiceBroker`. The root element of the document has the local name **Error**, and contains an element named **Code** and an element named **Message**. The **Code** element holds an integer value. The **Message** element holds the human-readable text of the message.
+The XML document that is contained in an error message uses the namespace `http://schemas.microsoft.com/SQL/ServiceBroker`. The root element of the document has the local name **Error**, and contains an element named **Code** and an element named **Message**. The **Code** element holds an integer value. The **Message** element holds the human-readable text of the message.
 
 For example, an error message generated by a service that processes expense reports might contain the following XML (reformatted for readability):
 

docs/machine-learning/install/sql-machine-learning-azure-data-studio.md

@@ -0,0 +1,119 @@
+---
+title: "Visual Studio Code Notebooks (Python, R)"
+description: Learn how to run Python and R scripts in a notebook in Visual Studio Code with SQL Server Machine Learning Services.
+author: VanMSFT
+ms.author: vanto
+ms.date: 12/12/2025
+ms.service: sql
+ms.subservice: machine-learning-services
+ms.topic: how-to
+ms.custom:
+  - sfi-image-nochange
+monikerRange: ">=sql-server-2017 || >=sql-server-linux-ver15"
+---
+# Run Python and R scripts in Visual Studio Code notebooks with SQL Server Machine Learning Services
+
+[!INCLUDE [SQL Server 2017 and later](../../includes/applies-to-version/sqlserver2017.md)]
+
+Learn how to run Python and R scripts in [Visual Studio Code](https://code.visualstudio.com) notebooks with [SQL Server Machine Learning Services](../sql-server-machine-learning-services.md). Visual Studio Code is a cross-platform development tool.
+
+## Prerequisites
+
+- Download and install [Visual Studio Code](https://code.visualstudio.com)) on your workstation. Visual Studio Code is cross-platform and runs on Windows, macOS, and Linux.
+
+- Install the [Polyglot Notebooks extension](https://code.visualstudio.com/docs/languages/polyglot) for Visual Studio Code.
+
+- A server with SQL Server Machine Learning Services installed and enabled. You can use Machine Learning Services on [Windows](sql-machine-learning-services-windows-install.md), [Linux](../../linux/sql-server-linux-setup-machine-learning.md), or [Big Data Clusters](../../big-data-cluster/machine-learning-services.md).
+
+## Create a SQL notebook
+
+> [!IMPORTANT]  
+> Machine Learning Services runs as part of SQL Server. Therefore, you need to use a SQL kernel and not a Python kernel.
+
+You can use Machine Learning Services in Visual Studio Code with a SQL notebook. To create a new notebook, follow these steps:
+
+1. Select **File** and **New Notebook** to create a new notebook. The notebook uses the **SQL kernel** by default.
+
+1. Select **Attach To** and **Change Connection**.
+
+   :::image type="content" source="media/ads-attach-to-connection.png" alt-text="Screenshot of Visual Studio Code SQL Notebook change connection.":::
+
+1. Connect to an existing or new SQL Server. You can either:
+
+   1. Choose an existing connection under **Recent Connections** or **Saved Connections**.
+
+   1. Create a new connection under **Connection Details**. Fill out the connection details to your SQL Server and database.
+
+   :::image type="content" source="media/ads-connection-details.png" alt-text="Screenshot of Visual Studio Code SQL Notebook connection details.":::
+
+## Run Python or R scripts
+
+SQL Notebooks consist of code and text cells. Use code cells to run Python or R scripts through the stored procedure [sp_execute_external_scripts](../../relational-databases/system-stored-procedures/sp-execute-external-script-transact-sql.md). Use text cells to document your code in the notebook.
+
+### Run a Python script
+
+Follow these steps to run a Python script:
+
+1. Select **+ Code** to add a code cell.
+
+   :::image type="content" source="media/ads-add-code.png" alt-text="Screenshot of Visual Studio Code SQL Notebooks add code block." lightbox="media/ads-add-code.png":::
+
+1. Enter the following script in the code cell:
+
+   ```sql
+   EXECUTE sp_execute_external_script
+       @language = N'Python',
+       @script = N'
+               a = 1
+               b = 2
+               c = a/b
+               d = a*b
+               print(c, d)
+               ';
+   ```
+
+1. Select **Run cell** (the round black arrow) or press **F5** to run the single cell.
+
+   :::image type="content" source="media/ads-run-python.png" alt-text="Screenshot of Visual Studio Code SQL Notebooks run Python code." lightbox="media/ads-run-python.png":::
+
+1. The result appears under the code cell.
+
+   :::image type="content" source="media/ads-run-python-output.png" alt-text="Screenshot of Visual Studio Code SQL Notebook Python code output." lightbox="media/ads-run-python-output.png":::
+
+### Run an R script
+
+Follow these steps to run an R script:
+
+1. Select **+ Code** to add a code cell.
+
+   :::image type="content" source="media/ads-add-code.png" alt-text="Screenshot of Visual Studio Code SQL Notebooks add code block." lightbox="media/ads-add-code.png":::
+
+1. Enter the following script in the code cell:
+
+   ```sql
+   EXECUTE sp_execute_external_script
+       @language = N'R',
+       @script = N'
+               a <- 1
+               b <- 2
+               c <- a/b
+               d <- a*b
+               print(c(c, d))
+               ';
+   ```
+
+1. Select **Run cell** (the round black arrow) or press **F5** to run the single cell.
+
+   :::image type="content" source="media/ads-run-r.png" alt-text="Screenshot of Visual Studio Code SQL Notebooks run R code." lightbox="media/ads-run-r.png":::
+
+1. The result appears under the code cell.
+
+   :::image type="content" source="media/ads-run-r-output.png" alt-text="Screenshot of Visual Studio Code SQL Notebook R code output." lightbox="media/ads-run-r-output.png":::
+
+## Related content
+
+- [SQL Notebooks in Visual Studio Code](https://devblogs.microsoft.com/dotnet/net-interactive-with-sql-net-notebooks-in-visual-studio-code/)
+- [Jupyter Notebooks in VS Code](https://code.visualstudio.com/docs/datascience/jupyter-notebooks)
+- [Polyglot Notebooks in VS Code](https://code.visualstudio.com/docs/languages/polyglot)
+- [Quickstart: Run simple Python scripts with SQL machine learning](../tutorials/quickstart-python-create-script.md)
+- [Quickstart: Run simple R scripts with SQL machine learning](../tutorials/quickstart-r-create-script.md)

docs/machine-learning/install/sql-machine-learning-visual-studio-code.md

@@ -49,7 +49,7 @@ Machine Learning Services uses an extensibility framework to run Python and R sc
 ::: moniker range=">=sql-server-ver15||>=sql-server-linux-ver15||=azuresqldb-mi-current"
 1. [Install SQL Server Machine Learning Services on Windows](install/sql-machine-learning-services-windows-install.md) or [on Linux](../linux/sql-server-linux-setup-machine-learning.md?toc=/sql/machine-learning/toc.json). You can also use [Machine Learning Services on Big Data Clusters](../big-data-cluster/machine-learning-services.md) and [Machine Learning Services in Azure SQL Managed Instance](/azure/azure-sql/managed-instance/machine-learning-services-overview).
 
-1. Configure your development tools. You can use [Run Python and R scripts in Azure Data Studio notebooks](install/sql-machine-learning-azure-data-studio.md). You can also run T-SQL in [Azure Data Studio](/azure-data-studio/what-is-azure-data-studio).
+1. Configure your development tools. You can use [Run Python and R scripts in Visual Studio Code notebooks](install/sql-machine-learning-visual-studio-code.md). You can also run T-SQL with the [MSSQL extension for Visual Studio Code](../tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code.md).
 
 1. Write your first Python or R script.
 
@@ -60,7 +60,7 @@ Machine Learning Services uses an extensibility framework to run Python and R sc
 ::: moniker range="=sql-server-2017"
 1. [Install SQL Server Machine Learning Services on Windows](install/sql-machine-learning-services-windows-install.md).
 
-1. Configure your development tools. You can use [Run Python and R scripts in Azure Data Studio notebooks](install/sql-machine-learning-azure-data-studio.md). You can also use T-SQL in [Azure Data Studio](/azure-data-studio/what-is-azure-data-studio).
+1. Configure your development tools. You can use [Run Python and R scripts in Visual Studio Code notebooks](install/sql-machine-learning-visual-studio-code.md). You can also use T-SQL with the [MSSQL extension for Visual Studio Code](../tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code.md).
 
 1. Write your first Python or R script.
 

docs/machine-learning/sql-server-machine-learning-services.md

@@ -58,8 +58,8 @@ items:
     href: ../machine-learning/install/change-default-language-runtime-version.md
   - name: Upgrade Python and R runtime with binding
     href: ../machine-learning/install/upgrade-r-and-python.md
-  - name: Azure Data Studio notebooks
-    href: ../machine-learning/install/sql-machine-learning-azure-data-studio.md
+  - name: Visual Studio Code notebooks
+    href: ../machine-learning/install/sql-machine-learning-visual-studio-code.md
   - name: Set up a Python client
     href: ../machine-learning/python/setup-python-client-tools-sql.md
   - name: Set up an R client

docs/machine-learning/toc.yml

@@ -67,7 +67,7 @@ This setting is only available in [!INCLUDE [ssazuresynapse-md](../../includes/s
 
 ## Syntax
 
-Syntax for SQL Server, Azure SQL Database, and Azure SQL Managed Instance:
+Syntax for SQL Server, Azure SQL Database, SQL database in Fabric, and Azure SQL Managed Instance:
 
 ```syntaxsql
 ALTER DATABASE SCOPED CONFIGURATION