Skip to content

Commit 517f65a

Browse files
Merge pull request #36003 from MashaMSFT/202512_dbmigts
Troubleshoot db migration in Azure Arc
2 parents 7c86601 + 936a1d0 commit 517f65a

27 files changed

Lines changed: 430 additions & 44 deletions

azure-sql/managed-instance/failover-group-configure-sql-mi.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -478,7 +478,7 @@ To avoid problems from a lower service tier or under-resourced geo-secondary get
478478
- You can scale the primary and secondary instance up or down to a different compute size within the same service tier or to a different service tier.
479479
- When scaling up within the same service tier, scale up the geo-secondary first, and then scale up the primary.
480480
- When scaling down within the same service tier, reverse the order: scale down the primary first, and then scale down the secondary.
481-
- Follow the same sequence when you change the configuration of your instance. If you're scaling resources up, do so on the secondary first. If you're scaling down, do so the primary first. This applies to the following instance configuration changes:
481+
- Follow the same sequence when you change the configuration of your instance. If you're scaling resources up, do so on the secondary first. If you're scaling down, do so on the primary first. This applies to the following instance configuration changes:
482482
- Upgrading or downgrading the service tier.
483483
- Changing the number of vCores.
484484
- Scaling the storage size.

azure-sql/managed-instance/managed-instance-link-migrate.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -88,11 +88,14 @@ After you've cut over to the SQL managed instance target, monitor your applicati
8888

8989
For details, review [post-migration](../migration-guides/managed-instance/sql-server-to-managed-instance-guide.md#post-migration).
9090

91-
## Reverse migrate (SQL Server 2022)
91+
## Reverse a migration
9292

93-
Starting with SQL Server 2022 CU10, you can configure a link with Azure SQL Managed Instance as the initial primary and SQL Server as the secondary. This capability allows you to reverse migrate from Azure SQL Managed Instance to SQL Server 2022.
93+
Reverse migration back to SQL Server from Azure SQL Managed Instance might be supported depending on the [update policy](/azure/azure-sql/managed-instance/update-policy) of your SQL managed instance. For example:
94+
- [SQL Server 2022 update policy](/azure/azure-sql/managed-instance/update-policy#sql-server-2022-update-policy): Databases from instances configured with the **SQL Server 2022** update policy can be restored back to SQL Server 2022 instances.
95+
- [SQL Server 2025 update policy](/azure/azure-sql/managed-instance/update-policy#sql-server-2025-update-policy): Databases from instances configured with the **SQL Server 2025** update policy can be restored back to SQL Server 2025 instances.
96+
- [Always-up-to-date update policy](/azure/azure-sql/managed-instance/update-policy#always-up-to-date-update-policy): Databases from instances configured with the **Always-up-to-date** update policy can't be restored back to SQL Server.
9497

95-
To reverse a migration, follow the same steps to configure the link, but start the process with the SQL Managed Instance as your migration source, and the SQL Server 2022 instance as the migration target.
98+
If your source SQL Server version is earlier than SQL Server 2022, reverse migration isn't possible. When your database is migrated to SQL Managed Instance, it undergoes an internal upgrade to a newer database version that isn't compatible with earlier SQL Server versions. Reverse migration database compatibility is only available when SQL Managed instance is configured with the corresponding update policy.
9699

97100
## Related content
98101

7.08 KB
Loading

docs/relational-databases/extended-events/media/xevents-xe-profiler-menu.png renamed to docs/relational-databases/extended-events/media/use-the-ssms-xe-profiler/xevents-xe-profiler-menu.png

File renamed without changes.

docs/relational-databases/extended-events/media/xevents-xe-profiler-start-session.png renamed to docs/relational-databases/extended-events/media/use-the-ssms-xe-profiler/xevents-xe-profiler-start-session.png

File renamed without changes.
93.8 KB
Loading
Binary file not shown.
Lines changed: 41 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "Use the SSMS XEvent Profiler"
2+
title: Use the SSMS XEvent Profiler
33
description: The XEvent Profiler displays a live viewer of extended events. Learn why to use this profiler, key features, and how to get started viewing extended events.
44
author: erinstellato-ms
55
ms.author: erinstellato
6-
ms.reviewer: mikeray
7-
ms.date: 10/02/2016
6+
ms.reviewer: mikeray, mathoma
7+
ms.date: 12/09/2025
88
ms.service: sql
99
ms.subservice: xevents
1010
ms.topic: tutorial
@@ -13,39 +13,64 @@ helpviewer_keywords:
1313
- "extended events [SQL Server], system_health session"
1414
- "system_health session [SQL Server extended events]"
1515
- "system health session [SQL Server extended events]"
16-
monikerRange: ">=sql-server-2016||>=sql-server-linux-2017"
16+
monikerRange: ">=sql-server-2016 || >=sql-server-linux-2017"
1717
---
1818
# Use the SSMS XEvent Profiler
19+
1920
[!INCLUDE [SQL Server](../../includes/applies-to-version/sql-asdbmi.md)]
2021

2122
The XEvent Profiler is a SQL Server Management Studio (SSMS) feature that displays a live viewer window of Extended Events. This overview describes the reasons for using this profiler, key features, and instructions to get started viewing Extended Events.
2223

2324
## Why would I use the XEvent Profiler?
25+
2426
Unlike SQL Profiler, XEvent profiler is directly integrated into SSMS and is built on top of the scalable Extended Events technology in the SQL engine. This feature enables quick access to a live streaming view of diagnostics events on the SQL Server. This view can be customized and those customizations can be shared with other SSMS users as a .viewsettings file. The session created by XE Profiler is less intrusive to the running SQL Server than a similar SQL trace would be when using SQL Profiler. This session can be customized by the user as well, using the existing XE session properties UI or by Transact-SQL.
2527

2628
## Prerequisites
29+
2730
This feature is only available on SQL Server Management Studio (SSMS) v17.3 or later. Install the latest version of [SQL Server Management Studio (SSMS)](/ssms/install/install).
2831

29-
## <a id="getting-started"></a>Getting Started
32+
<a id="getting-started"></a>
33+
34+
## Getting started
35+
3036
To access the XEvent Profiler, follow these steps:
3137

3238
1. Open **SQL Server Management Studio**.
3339

34-
2. Connect to an instance of the SQL Server Database Engine or localhost.
40+
1. Connect to an instance of the SQL Server Database Engine or localhost.
41+
42+
1. In Object Explorer, find the XE Profiler menu item and expand it by selecting the '+' sign.
43+
44+
:::image type="content" source="media/use-the-ssms-xe-profiler/xevents-xe-profiler-menu.png" alt-text="Screenshot of the XEProfiler Menu.":::
45+
46+
1. Double-click **Standard** if you want to view all events in this session. Select **T-SQL** if you want to view the logged SQL statements. If a session is not already created, a session is created for you.
47+
48+
:::image type="content" source="media/use-the-ssms-xe-profiler/xevents-xe-profiler-start-session.png" alt-text="Screenshot of the XEProfiler Session." lightbox="media/use-the-ssms-xe-profiler/xevents-xe-profiler-start-session.png":::
49+
50+
1. You can now view events captured by the session.
51+
52+
:::image type="content" source="media/use-the-ssms-xe-profiler/xevents-xe-profiler-start-viewer.png" alt-text="Screenshot of the XEProfiler Viewer." lightbox="media/use-the-ssms-xe-profiler/xevents-xe-profiler-start-viewer.png":::
53+
54+
## Stop and start the session
55+
56+
To start the session, either select **Start data feed** from the **Extended Events** menu in the Live Data Viewer or use the green arrow in the tool bar:
57+
58+
:::image type="content" source="media/use-the-ssms-xe-profiler/start-feed.png" alt-text="Screenshot of the start data feed option in the extended events menu in SSMS.":::
59+
60+
Likewise, after a session is started, to stop a session select **Stop data feed** from the **Extended Events** menu in the Live Data Viewer or use the red square in the tool bar.
3561

36-
3. In Object Explorer, find the XE Profiler menu item and expand it by clicking the '+' sign.
62+
## Customize the session
3763

38-
![XEProfiler Menu](media/xevents-xe-profiler-menu.png)
64+
While XEvent Profiler provides the preconfigured **Standard** and **T-SQL** sessions, you can further customize the session to meet your needs by doing the following:
3965

40-
4. Double-click **Standard** if you want to view all events in this session. Click **T-SQL** if you want to view the logged SQL statements. If a session is not already created, a session is created for you.
66+
- **Add or remove columns**: Right-click on any column header in the Live Data viewer and select **Choose Columns...** to add or remove columns to control the display of additional information.
67+
- **Filter events**: Right-click on any field in the Live Data viewer and select **Filter by this value** to apply criteria to the captured events, such as to focus on a specific application, user, or event type. Alternatively, you can select **Filters...** from the top navigation bar to open the filter dialog box.
4168

42-
![XEProfiler Session](media/xevents-xe-profiler-start-session.png)
69+
## Export data
4370

44-
5. You can now view events captured by the session.
71+
To save the data for later analysis, you can export the data feed to a table, or either an `XEL` or `CSV` file. To export the feed, select **Export data...** from the **Extended Events** menu.
4572

46-
![XEProfiler Viewer](media/xevents-xe-profiler-start-viewer.png)
73+
## Related content
4774

48-
## See Also
49-
[Extended Events](../../relational-databases/extended-events/extended-events.md)
50-
[Extended Events Tools](../../relational-databases/extended-events/extended-events-tools.md)
51-
75+
- [Extended Events overview](extended-events.md)
76+
- [Extended Events Tools](extended-events-tools.md)

docs/relational-databases/system-stored-procedures/sys-sp-cdc-help-change-data-capture-transact-sql.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ dev_langs:
2222
---
2323
# sys.sp_cdc_help_change_data_capture (Transact-SQL)
2424

25-
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
25+
[!INCLUDE [SQL Server](../../includes/applies-to-version/sql-asdbmi.md)]
2626

2727
Returns the change data capture configuration for each table enabled for change data capture in the current database. Up to two rows can be returned for each source table, one row for each capture instance. Change data capture isn't available in every edition of [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)]. For a list of features that are supported by the editions of [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)], see [Editions and supported features of SQL Server 2022](../../sql-server/editions-and-components-of-sql-server-2022.md).
2828

docs/sql-server/azure-arc/configure-private-path.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,6 @@ To delete the resources from Azure portal:
128128
1. Select **Delete resource group**.
129129
1. Confirm the resource group name at **Type the resource group name**, and select Delete.
130130

131-
[!INCLUDE [manage-extension](includes/manage-extension.md)]
132131

133132
## Related content
134133

0 commit comments

Comments
 (0)