Skip to content

Commit 3860e1d

Browse files
authored
Merge pull request #34287 from rwestMSFT/rw-0603-refresh
Refresh SQL Server install content
2 parents 3852e6d + e1f7a3c commit 3860e1d

File tree

38 files changed

+1716
-1641
lines changed

38 files changed

+1716
-1641
lines changed

docs/database-engine/install-windows/add-features-to-an-instance-of-sql-server-setup.md

Lines changed: 77 additions & 77 deletions
Large diffs are not rendered by default.
Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: "Change the database compatibility level and use the Query Store"
2+
title: "Change the Database Compatibility Level and Use the Query Store"
33
description: This article explains the place of using the Query Store to establish a baseline and changing the database compatibility level in a SQL Server upgrade.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 11/29/2022
6+
ms.date: 06/03/2025
77
ms.service: sql
88
ms.subservice: install
99
ms.topic: conceptual
@@ -17,33 +17,33 @@ monikerRange: ">=sql-server-2016"
1717

1818
[!INCLUDE [SQL Server-Windows Only](../../includes/applies-to-version/sql-windows-only.md)]
1919

20-
In [!INCLUDE[sssql16-md](../../includes/sssql16-md.md)] and later, some changes are only enabled once the [database compatibility level](../../t-sql/statements/alter-database-transact-sql-compatibility-level.md) has been changed. This was done for several reasons:
20+
In [!INCLUDE [sssql16-md](../../includes/sssql16-md.md)] and later, some changes are only enabled once the [database compatibility level](../../t-sql/statements/alter-database-transact-sql-compatibility-level.md) has been changed. This was done for several reasons:
2121

2222
- Since upgrade is a one-way operation (it isn't possible to downgrade the file format), there's value in separating the enablement of new features to a separate operation within the database. It's possible to revert a setting to a prior database compatibility level. The new model reduces the number of things that must happen during an outage window.
2323

24-
- Changes to the query processor can have complex effects. Even though a "good" change to the system may be great for most workloads - it may cause an unacceptable regression on an important query for others. Separating this logic from the upgrade process, allows for features such as the Query Store, to mitigate plan choice regressions quickly or even avoid them completely in production servers.
24+
- Changes to the query processor can have complex effects. Even though a "good" change to the system might be great for most workloads, it could cause an unacceptable regression on an important query for others. Separating this logic from the upgrade process allows for features, such as the Query Store, to mitigate plan choice regressions quickly or even avoid them completely in production servers.
2525

26-
The below behaviors are expected for [!INCLUDE[ssSQL17](../../includes/sssql17-md.md)] when a database is attached or restored, and after an in-place upgrade:
26+
The following behaviors are expected for [!INCLUDE [ssSQL17](../../includes/sssql17-md.md)] when a database is attached or restored, and after an in-place upgrade:
2727

2828
- If the compatibility level of a user database was 100 or higher before the upgrade, it remains the same after upgrade.
29-
- If the compatibility level of a user database was 90 before upgrade, in the upgraded database, the compatibility level is set to 100, which is the lowest supported compatibility level in [!INCLUDE[ssSQL17](../../includes/sssql17-md.md)].
30-
- The compatibility levels of the `tempdb`, `model`, `msdb` and Resource databases are set to the current compatibility level after upgrade.
29+
- If the compatibility level of a user database was 90 before upgrade, in the upgraded database, the compatibility level is set to 100, which is the lowest supported compatibility level in [!INCLUDE [ssSQL17](../../includes/sssql17-md.md)].
30+
- The compatibility levels of the `tempdb`, `model`, `msdb`, and `Resource` databases are set to the current compatibility level after upgrade.
3131
- The `master` system database retains the compatibility level it had before upgrade.
3232

33-
The upgrade process to enable new query processor functionality is related to the post-release servicing model of the product. Some of those fixes are released under [Trace Flag 4199](../../t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql.md#tf4199). Customers needing fixes can opt in to those fixes without causing unexpected regressions for other customers. The post-release servicing model for query processor hotfixes is documented [here](https://support.microsoft.com/kb/974006). Beginning with [!INCLUDE[sssql16-md](../../includes/sssql16-md.md)], moving to a new compatibility level implies that Trace Flag 4199 is no longer needed, because those fixes are now enabled by default in the latest compatibility level. Therefore, as part of the upgrade process, it's important to validate that 4199 isn't enabled once the upgrade process completes.
33+
The upgrade process to enable new query processor functionality is related to the post-release servicing model of the product. Some of those fixes are released under [Trace Flag 4199](../../t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql.md#tf4199). Customers needing fixes can opt in to those fixes without causing unexpected regressions for other customers. The post-release servicing model for query processor hotfixes is documented [here](https://support.microsoft.com/help/974006). Beginning with [!INCLUDE [sssql16-md](../../includes/sssql16-md.md)], moving to a new compatibility level implies that Trace Flag 4199 is no longer needed, because those fixes are now enabled by default in the latest compatibility level. Therefore, as part of the upgrade process, it's important to validate that 4199 isn't enabled once the upgrade process completes.
3434

3535
> [!NOTE]
3636
> Trace Flag 4199 is still needed to enable any new query processor fixes released after RTM, if applicable.
3737
38-
The recommended workflow for upgrading the query processor to the latest version of the code is documented in the [Keep performance stability during the upgrade to newer SQL Server section of Query Store Usage Scenarios](../../relational-databases/performance/query-store-usage-scenarios.md#CEUpgrade), as seen below.
38+
For information about the recommended workflow to upgrade the query processor to the latest version of the code, see [Keep performance stability during the upgrade to newer SQL Server section of Query Store Usage Scenarios](../../relational-databases/performance/query-store-usage-scenarios.md#CEUpgrade).
3939

40-
:::image type="content" source="media/change-the-database-compatibility-mode-and-use-the-query-store/query-store-usage.png" alt-text="Diagram showing the recommended workflow for upgrading the query processor to the latest version of the code.":::
40+
:::image type="content" source="media/change-the-database-compatibility-mode-and-use-the-query-store/query-store-usage.png" alt-text="Diagram showing the recommended workflow for upgrading the query processor to the latest version of the code." lightbox="media/change-the-database-compatibility-mode-and-use-the-query-store/query-store-usage.png":::
4141

42-
Starting with [!INCLUDE[ssManStudioFull](../../includes/ssmanstudiofull-md.md)] v18, users can be guided through the recommended workflow using the Query Tuning Assistant. For more information, see [Upgrading Databases by using the Query Tuning Assistant](../../relational-databases/performance/upgrade-dbcompat-using-qta.md).
42+
Starting with [!INCLUDE [ssManStudioFull](../../includes/ssmanstudiofull-md.md)] 18, users can be guided through the recommended workflow using the Query Tuning Assistant. For more information, see [Upgrade databases using the Query Tuning Assistant](../../relational-databases/performance/upgrade-dbcompat-using-qta.md).
4343

44-
## See also
44+
## Related content
4545

46-
- [View or Change the Compatibility Level of a Database](../../relational-databases/databases/view-or-change-the-compatibility-level-of-a-database.md)
46+
- [View or change the compatibility level of a database](../../relational-databases/databases/view-or-change-the-compatibility-level-of-a-database.md)
4747
- [Query Store Usage Scenarios](../../relational-databases/performance/query-store-usage-scenarios.md)
48-
- [ALTER DATABASE (Transact-SQL) Compatibility Level](../../t-sql/statements/alter-database-transact-sql-compatibility-level.md)
49-
- [Upgrading Databases by using the Query Tuning Assistant](../../relational-databases/performance/upgrade-dbcompat-using-qta.md)
48+
- [ALTER DATABASE (Transact-SQL) compatibility level](../../t-sql/statements/alter-database-transact-sql-compatibility-level.md)
49+
- [Upgrade databases using the Query Tuning Assistant](../../relational-databases/performance/upgrade-dbcompat-using-qta.md)

docs/database-engine/install-windows/check-parameters-for-the-system-configuration-checker.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Check Parameters System Configuration Checker"
33
description: During SQL Server Setup, the System Configuration Checker for conditions that prevent a successful SQL Server installation.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: "12/13/2019"
6+
ms.date: 06/03/2025
77
ms.service: sql
88
ms.subservice: install
99
ms.topic: conceptual
@@ -25,14 +25,16 @@ monikerRange: ">=sql-server-2016"
2525

2626
[!INCLUDE [SQL Server -Windows Only](../../includes/applies-to-version/sql-windows-only.md)]
2727

28-
During [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Setup, the System Configuration Checker (SCC) scans the computer where [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] will be installed. The SCC checks for conditions that prevent a successful [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] installation. Before Setup starts the [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Installation Wizard, the SCC retrieves the status of each item. It then compares the result with required conditions and provides guidance for removal of blocking issues.
29-
30-
The system configuration checker generates a report which contains a short description for each executed rule, and the execution status. The system configuration check report is located at %programfiles%\Microsoft SQL Server\140\Setup Bootstrap\Log\\\<YYYYMMDD_HHMM>\\\.
31-
32-
See the following links for more information:
28+
During [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] Setup, the System Configuration Checker (SCC) scans the computer where [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] will be installed.
3329

34-
- [Hardware and Software Requirements for Installing SQL Server](../../sql-server/install/hardware-and-software-requirements-for-installing-sql-server.md)
35-
- [Security Considerations for a SQL Server Installation](../../sql-server/install/security-considerations-for-a-sql-server-installation.md)
36-
- [Supported Version and Edition Upgrades](../../database-engine/install-windows/supported-version-and-edition-upgrades.md)
37-
38-
30+
## Remarks
31+
32+
The SCC checks for conditions that prevent a successful [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] installation. Before Setup starts the [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] Installation Wizard, the SCC retrieves the status of each item. It then compares the result with required conditions and provides guidance for removal of blocking issues.
33+
34+
The system configuration checker generates a report which contains a short description for each executed rule, and the execution status. The system configuration check report is located at `%programfiles%\Microsoft SQL Server\140\Setup Bootstrap\Log\<yyyyMMdd_HHmm>`.
35+
36+
## Related content
37+
38+
- [Hardware and software requirements for SQL Server 2022](../../sql-server/install/hardware-and-software-requirements-for-installing-sql-server-2022.md)
39+
- [Security considerations for a SQL Server installation](../../sql-server/install/security-considerations-for-a-sql-server-installation.md)
40+
- [Supported version and edition upgrades (SQL Server 2022)](supported-version-and-edition-upgrades-2022.md)

0 commit comments

Comments
 (0)