Merge pull request #36906 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit cd9a5c370767 · 2026-03-18T22:34:25.000Z
Auto Publish – main to live - 2026-03-18 22:30 UTC
diff --git a/azure-sql/virtual-machines/windows/media/sql-server-iaas-agent-extension-automate-management/azure-rm-sql-server-iaas-agent-portal.png b/azure-sql/virtual-machines/windows/media/sql-server-iaas-agent-extension-automate-management/azure-rm-sql-server-iaas-agent-portal.png
diff --git a/azure-sql/virtual-machines/windows/media/sql-server-iaas-agent-extension-automate-management/least-privilege.png b/azure-sql/virtual-machines/windows/media/sql-server-iaas-agent-extension-automate-management/least-privilege.png
diff --git a/azure-sql/virtual-machines/windows/sql-agent-extension-manually-register-single-vm.md b/azure-sql/virtual-machines/windows/sql-agent-extension-manually-register-single-vm.md
@@ -48,6 +48,7 @@ To register your SQL Server VM with the extension, you'll need the following:
 - The latest version of [Azure CLI](/cli/azure/install-azure-cli) or [Azure PowerShell (5.0 minimum)](/powershell/azure/install-az-ps).
 - A minimum of .NET Framework 4.5.1 or later.
 - To verify that none of the [limitations](sql-server-iaas-agent-extension-automate-management.md#limitations) apply to you.
+- A [supported region](sql-server-iaas-agent-extension-automate-management.md#supported-regions) for the SQL IaaS Agent extension.
 
 ## Register subscription with RP
 
diff --git a/azure-sql/virtual-machines/windows/sql-server-iaas-agent-extension-automate-management.md b/azure-sql/virtual-machines/windows/sql-server-iaas-agent-extension-automate-management.md
diff --git a/docs/relational-databases/blob/codesnippet/visualbasic/access-filestream-data-w_0_2.vb b/docs/relational-databases/blob/codesnippet/visualbasic/access-filestream-data-w_0_2.vb
@@ -3,8 +3,8 @@ Imports System
 Imports System.Collections.Generic 
 Imports System.Text 
 Imports System.Data 
-Imports System.Data.SqlClient 
-Imports System.Data.SqlTypes 
+Imports Microsoft.Data.SqlClient 
+Imports Microsoft.Data.SqlTypes 
 
 Module Module1
     Public Sub Main(ByVal args As String())
diff --git a/docs/relational-databases/blob/codesnippet/visualbasic/create-client-applicatio_4.vb b/docs/relational-databases/blob/codesnippet/visualbasic/create-client-applicatio_4.vb
@@ -3,8 +3,8 @@ Imports System
 Imports System.Collections.Generic 
 Imports System.Text 
 Imports System.Data 
-Imports System.Data.SqlClient 
-Imports System.Data.SqlTypes 
+Imports Microsoft.Data.SqlClient 
+Imports Microsoft.Data.SqlTypes 
 
 Module Module1
     Public Sub Main(ByVal args As String())
diff --git a/docs/relational-databases/errors-events/mssqlserver-4064-database-engine-error.md b/docs/relational-databases/errors-events/mssqlserver-4064-database-engine-error.md
diff --git a/docs/relational-databases/indexes/delete-an-index.md b/docs/relational-databases/indexes/delete-an-index.md
@@ -15,7 +15,7 @@ helpviewer_keywords:
   - "dropping indexes"
   - "indexes [SQL Server], dropping"
   - "index deletions [SQL Server]"
-monikerRange: "=azuresqldb-current || >=sql-server-2016 || =fabric-sqldb"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Delete an index
 [!INCLUDE [SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB](../../includes/applies-to-version/sql-asdb-asdbmi-fabricsqldb.md)]
diff --git a/docs/relational-databases/indexes/disk-space-requirements-for-index-ddl-operations.md b/docs/relational-databases/indexes/disk-space-requirements-for-index-ddl-operations.md
@@ -16,6 +16,7 @@ helpviewer_keywords:
   - "space [SQL Server], indexes"
   - "indexes [SQL Server], disk space requirements"
   - "temporary disk space [SQL Server]"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Disk space requirements for index DDL operations
 
diff --git a/docs/relational-databases/indexes/index-disk-space-example.md b/docs/relational-databases/indexes/index-disk-space-example.md
@@ -17,6 +17,7 @@ helpviewer_keywords:
   - "space [SQL Server], indexes"
   - "indexes [SQL Server], disk space requirements"
   - "offline index disk space [SQL Server]"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Index disk space example
 
diff --git a/docs/relational-databases/indexes/modify-an-index.md b/docs/relational-databases/indexes/modify-an-index.md
@@ -13,7 +13,7 @@ helpviewer_keywords:
   - "indexes [SQL Server], modifying"
   - "modifying indexes"
   - "index changes [SQL Server]"
-monikerRange: "=azuresqldb-current || >=sql-server-2016 || =fabric-sqldb"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Modify an Index
 [!INCLUDE [SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB](../../includes/applies-to-version/sql-asdb-asdbmi-fabricsqldb.md)]
diff --git a/docs/relational-databases/indexes/move-an-existing-index-to-a-different-filegroup.md b/docs/relational-databases/indexes/move-an-existing-index-to-a-different-filegroup.md
@@ -13,6 +13,7 @@ helpviewer_keywords:
   - "moving indexes"
   - "indexes [SQL Server], moving"
   - "filegroups [SQL Server], switching"
+monikerRange: ">=sql-server-ver16 || >=sql-server-linux-ver16 || =azuresqldb-mi-current"
 ---
 # Move an existing index to a different filegroup
 
diff --git a/docs/relational-databases/indexes/specify-fill-factor-for-an-index.md b/docs/relational-databases/indexes/specify-fill-factor-for-an-index.md
@@ -12,7 +12,7 @@ ms.custom:
 helpviewer_keywords:
   - "fill factor [SQL Server]"
   - "page splits [SQL Server]"
-monikerRange: "=azuresqldb-current || >=sql-server-2016 || =fabric-sqldb"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Specify Fill Factor for an Index
 [!INCLUDE [SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB](../../includes/applies-to-version/sql-asdb-asdbmi-fabricsqldb.md)]
diff --git a/docs/relational-databases/indexes/transaction-log-disk-space-for-index-operations.md b/docs/relational-databases/indexes/transaction-log-disk-space-for-index-operations.md
@@ -16,6 +16,7 @@ helpviewer_keywords:
   - "transaction logs [SQL Server], disk space"
   - "disk space [SQL Server], transaction logs"
   - "space [SQL Server], transaction logs"
+monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb"
 ---
 # Transaction log disk space for index operations
 
diff --git a/docs/relational-databases/xml/use-for-xml-results-in-application-code.md b/docs/relational-databases/xml/use-for-xml-results-in-application-code.md
@@ -4,7 +4,8 @@ description: Learn how to use the results of a SQL query with FOR XML clauses in
 author: MikeRayMSFT
 ms.author: mikeray
 ms.reviewer: randolphwest
-ms.date: 05/05/2022
+ms.date: 03/17/2026
+ai-usage: ai-assisted
 ms.service: sql
 ms.subservice: xml
 ms.topic: how-to
@@ -24,7 +25,7 @@ helpviewer_keywords:
 
 [!INCLUDE [SQL Server Azure SQL Database FabricSQLDB](../../includes/applies-to-version/sql-asdb-asdbmi-fabricsqldb.md)]
 
-By using FOR XML clauses with SQL queries, you can retrieve and even cast query results as XML data. This functionality allows you to do the following when FOR XML query results can be used in XML application code:
+By using FOR XML clauses with SQL queries, you can retrieve and cast query results as XML data. When you use FOR XML query results in XML application code, you can:
 
 - Query SQL tables for instances of [XML Data &#40;SQL Server&#41;](../../relational-databases/xml/xml-data-sql-server.md) values
 
@@ -34,7 +35,7 @@ This article provides examples that demonstrate these approaches.
 
 ## Retrieve FOR XML data with ADO and XML data islands
 
-The ADO **Stream** object or other objects that support the COM **IStream** interface, such as the Active Server Pages (ASP) **Request** and **Response** objects, can be used to contain the results when you're working with FOR XML queries.
+The ADO **Stream** object or other objects that support the COM **IStream** interface, such as the Active Server Pages (ASP) **Request** and **Response** objects, can contain the results when you're working with FOR XML queries.
 
 For example, the following ASP code shows the results of querying an **xml** data type column, Demographics, in the `Sales.Store` table of the AdventureWorks sample database. Specifically, the query looks for the instance value of this column for the row where the CustomerID is equal to 3.
 
@@ -119,17 +120,17 @@ For example, the following ASP code shows the results of querying an **xml** dat
 <!-- EndRecordAndStreamVBS -->
 ```
 
-This example ASP page contains server-side VBScript that uses ADO to execute the FOR XML query and return the XML results in an XML data island, MyDataIsle. This XML data island is then returned in the browser for additional client-side processing. Additional client-side VBScript code is then used to process the contents of the XML data island. This process is performed before displaying the contents as part of the resultant DHTML and opening a message box to show the preprocessed contents of the XML data island.
+This example ASP page contains server-side VBScript that uses ADO to execute the FOR XML query and return the XML results in an XML data island, MyDataIsle. The browser then receives this XML data island for additional client-side processing. Additional client-side VBScript code then processes the contents of the XML data island, displaying the contents as part of the resultant DHTML and opening a message box to show the preprocessed contents of the XML data island.
 
 ### Test this example
 
-1. Verify that IIS is installed and that the AdventureWorks sample database for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] has been installed.
+1. Verify that IIS and the AdventureWorks sample database for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] are installed.
 
-   This example requires that Internet Information Services (IIS) version 5.0, or later versions, are installed with ASP support enabled. Also, the AdventureWorks sample database has to be installed.
+   This example requires Internet Information Services (IIS) version 5.0 or later with ASP support enabled. The AdventureWorks sample database must also be installed.
 
-2. Copy the code example that was previously provided and paste it into the XML or text editor that you use. Save the file as RetrieveResults.asp in the root directory that is used for IIS. Typically, this is C:Inetpub\wwwroot.
+1. Copy the preceding code example and paste it into the XML or text editor that you use. Save the file as RetrieveResults.asp in the root directory that IIS uses. Typically, this directory is C:Inetpub\wwwroot.
 
-3. Open the ASP page in a browser window by using the following URL. First, replace 'MyServer' with either "localhost" or the actual name of the server where [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] and IIS are installed.
+1. Open the ASP page in a browser window by using the following URL. First, replace 'MyServer' with either "localhost" or the actual name of the server where [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] and IIS are installed.
 
     ```text
     https://MyServer/RetrieveResults.asp
@@ -200,17 +201,17 @@ The VBScript message box will then show the following original, unfiltered XML d
 
 ## Retrieve FOR XML data with ASP.NET and the .NET Framework
 
-As in the previous example, the following ASP.NET code shows the results of querying an **xml** data type column, Demographics, in the Sales.Store table of the AdventureWorks sample database. As in the previous example, the query looks for the instance value of this column for the row where the CustomerID is equal to 3.
+As in the previous example, the following ASP.NET code shows the results of querying an **xml** data type column, Demographics, in the `Sales.Store` table of the AdventureWorks sample database. As in the previous example, the query looks for the instance value of this column for the row where the CustomerID is equal to 3.
 
-In this example, the following Microsoft .NET Framework managed APIs are used to accomplish the return and rendering of the FOR XML query results:
+In this example, the following Microsoft .NET Framework managed APIs return and render the FOR XML query results:
 
-1. **SqlConnection** is used to open a connection to SQL Server, based on the contents of a specified connection string variable, strConn.
+1. **SqlConnection** opens a connection to SQL Server, based on the contents of a specified connection string variable, `strConn`.
 
-2. **SqlDataAdapter** is then used as the data adapter and it uses the SQL connection and a specified SQL query string to execute the FOR XML query.
+1. **SqlDataAdapter** serves as the data adapter and uses the SQL connection and a specified SQL query string to execute the FOR XML query.
 
-3. After the query has executed, the **SqlDataAdapter.Fill** method is then called and passed an instance of a **DataSet,** MyDataSet, in order to fill the data set with the output of the FOR XML query.
+1. After the query executes, the **SqlDataAdapter.Fill** method fills a **DataSet** instance, `MyDataSet`, with the output of the FOR XML query.
 
-4. The **DataSet.GetXml** method is then called to return the query results as a string that can be displayed in the server-generated HTML page.
+1. The **DataSet.GetXml** method returns the query results as a string that the server-generated HTML page displays.
 
     ```vb
     <%@ Page Language="VB" %>
@@ -244,8 +245,8 @@ In this example, the following Microsoft .NET Framework managed APIs are used to
     Dim strConn As String
     strConn = "Server=(local);Database=AdventureWorks;Integrated Security=SSPI;"
 
-    Dim MySqlConn As New System.Data.SqlClient.SqlConnection(strConn)
-    Dim MySqlAdapter As New System.Data.SqlClient.SqlDataAdapter(SQL,MySqlConn)
+    Dim MySqlConn As New Microsoft.Data.SqlClient.SqlConnection(strConn)
+    Dim MySqlAdapter As New Microsoft.Data.SqlClient.SqlDataAdapter(SQL,MySqlConn)
     Dim MyDataSet As New System.Data.DataSet
 
     MySqlConn.Open()
@@ -266,13 +267,13 @@ In this example, the following Microsoft .NET Framework managed APIs are used to
 
 ### Test this example
 
-1. Verify that IIS is installed and that the AdventureWorks sample database for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] has been installed.
+1. Verify that IIS and the AdventureWorks sample database for [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] are installed.
 
-   This example requires that Internet Information Services (IIS) version 5.0, or later versions, are installed with ASP.NET support enabled. Also, the AdventureWorks sample database has to be installed.
+   This example requires Internet Information Services (IIS) version 5.0 or later with ASP.NET support enabled. The AdventureWorks sample database must also be installed.
 
-2. Copy the code that was previously provided and paste it into the XML or text editor that you use. Save the file as RetrieveResults.aspx in the root directory used for IIS. Typically, this is C:Inetpub\wwwroot.
+1. Copy the preceding code and paste it into the XML or text editor that you use. Save the file as RetrieveResults.aspx in the root directory that IIS uses. Typically, this directory is C:Inetpub\wwwroot.
 
-3. Open the ASP.NET page in a browser window using the following URL. First, replace 'MyServer' with either "localhost" or the actual name of the server where [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] and IIS are installed.
+1. Open the ASP.NET page in a browser window by using the following URL. First, replace 'MyServer' with either "localhost" or the actual name of the server where [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] and IIS are installed.
 
     ```text
     https://MyServer/RetrieveResults.aspx
@@ -293,9 +294,9 @@ SqlConnection closed.
 ```
 
 > [!NOTE]
-> The [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] **xml** data type support lets you request that the result of a FOR XML query be returned as **xml** data type, instead of as string or image typed data, by specifying the [TYPE directive](../../relational-databases/xml/type-directive-in-for-xml-queries.md). When the TYPE directive is used in FOR XML queries, it provides programmatic access to the FOR XML results similar to that shown in [Use XML Data in Applications](../../relational-databases/xml/use-xml-data-in-applications.md).
+> The [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] **xml** data type support lets you request that a FOR XML query returns results as **xml** data type, instead of as string or image typed data, by specifying the [TYPE directive](../../relational-databases/xml/type-directive-in-for-xml-queries.md). When you use the TYPE directive in FOR XML queries, it provides programmatic access to the FOR XML results similar to the approach shown in [Use XML Data in Applications](../../relational-databases/xml/use-xml-data-in-applications.md).
 
-## See also
+## Related content
 
 - [FOR XML &#40;SQL Server&#41;](../../relational-databases/xml/for-xml-sql-server.md)
 
diff --git a/docs/relational-databases/xml/use-nested-for-xml-queries-in-asp-net.md b/docs/relational-databases/xml/use-nested-for-xml-queries-in-asp-net.md
@@ -4,7 +4,8 @@ description: Learn how to use nested FOR XML queries in an ASP.NET application t
 author: MikeRayMSFT
 ms.author: mikeray
 ms.reviewer: randolphwest
-ms.date: 05/05/2022
+ms.date: 03/17/2026
+ai-usage: ai-assisted
 ms.service: sql
 ms.subservice: xml
 ms.topic: how-to
@@ -20,7 +21,7 @@ helpviewer_keywords:
 
 [!INCLUDE [SQL Server Azure SQL Database FabricSQLDB](../../includes/applies-to-version/sql-asdb-asdbmi-fabricsqldb.md)]
 
-In this example, an ASP.NET application returns XML to a browser by executing a stored procedure in SQL Server. The stored procedure generates XML using nested queries. A similar SELECT statement is shown in the article [Generating Siblings by Using a Nested AUTO Mode Query](../../relational-databases/xml/generate-siblings-with-a-nested-auto-mode-query.md). This example demonstrates one way to use nested FOR XML queries to generate element-centric XML in [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)].
+In this example, an ASP.NET application returns XML to a browser by executing a stored procedure in SQL Server. The stored procedure generates XML by using nested queries. A similar SELECT statement is shown in the article [Generating Siblings by Using a Nested AUTO Mode Query](../../relational-databases/xml/generate-siblings-with-a-nested-auto-mode-query.md). This example demonstrates one way to use nested FOR XML queries to generate element-centric XML in [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)].
 
 ## Example
 
@@ -55,14 +56,14 @@ This is the .aspx application. It executes the stored procedure and returns XML
 ```csharp
 <%@LANGUAGE=C# Debug=true %>
 <%@import Namespace="System.Xml"%>
-<%@import namespace="System.Data.SqlClient" %><%
+<%@import namespace="Microsoft.Data.SqlClient" %><%
 Response.Expires = -1;
 Response.ContentType = "text/xml";
 %>
 
 <%
-using(System.Data.SqlClient.SqlConnection c = new System.Data.SqlClient.SqlConnection("Data Source=server;Database=AdventureWorks;Integrated Security=SSPI;"))
-using(System.Data.SqlClient.SqlCommand cmd = c.CreateCommand())
+using(Microsoft.Data.SqlClient.SqlConnection c = new Microsoft.Data.SqlClient.SqlConnection("Data Source=server;Database=AdventureWorks;Integrated Security=SSPI;"))
+using(Microsoft.Data.SqlClient.SqlCommand cmd = c.CreateCommand())
 {
    cmd.CommandText = "GetSalesOrderInfo";
    cmd.CommandType = CommandType.StoredProcedure;
@@ -89,7 +90,7 @@ using(System.Data.SqlClient.SqlCommand cmd = c.CreateCommand())
 
 3. Execute the application (`https://server/GetSalesOrderInfo.aspx`).
 
-## See also
+## Related content
 
 - [Use Nested FOR XML Queries](../../relational-databases/xml/use-nested-for-xml-queries.md)
 
diff --git a/docs/t-sql/functions/vector-search-transact-sql.md b/docs/t-sql/functions/vector-search-transact-sql.md
@@ -4,7 +4,7 @@ description: VECTOR_SEARCH search for vectors similar to a given query vectors u
 author: mikerayMSFT
 ms.author: mikeray
 ms.reviewer: pookam, damauri, randolphwest, wiassaf
-ms.date: 03/07/2026
+ms.date: 03/18/2026
 ms.service: sql
 ms.subservice: t-sql
 ms.topic: reference
@@ -270,24 +270,19 @@ CREATE TABLE dbo.Articles
 GO
 
 -- Step 2: Insert sample data (100 rows required for latest version indexes)
-DECLARE @i INT = 1;
-WHILE @i <= 100
-BEGIN
-    INSERT INTO Articles (id, title, content, embedding)
-    VALUES (
-        @i, 
-        'Article ' + CAST(@i AS NVARCHAR(10)), 
-        'Content for article ' + CAST(@i AS NVARCHAR(10)),
-        JSON_ARRAY(
-            CAST(@i * 0.01 AS FLOAT),
-            CAST(@i * 0.02 AS FLOAT),
-            CAST(@i * 0.03 AS FLOAT),
-            CAST(@i * 0.04 AS FLOAT),
-            CAST(@i * 0.05 AS FLOAT)
-        )
-    );
-    SET @i = @i + 1;
-END
+INSERT INTO Articles (id, title, content, embedding)
+SELECT
+    value AS id,
+    'Article ' || [value],
+    'Content for article ' || [value],
+    CAST(JSON_ARRAY(
+        CAST(value * 0.01 AS FLOAT),
+        CAST(value * 0.02 AS FLOAT),
+        CAST(value * 0.03 AS FLOAT),
+        CAST(value * 0.04 AS FLOAT),
+        CAST(value * 0.05 AS FLOAT)
+    ) AS VECTOR(5))
+FROM GENERATE_SERIES(1, 100);
 GO
 
 -- Step 3: Create a vector index on the embedding column
diff --git a/docs/t-sql/statements/create-vector-index-transact-sql.md b/docs/t-sql/statements/create-vector-index-transact-sql.md
