Skip to content

Commit 4e9913c

Browse files
authored
Freshness pass for configuration settings 002 (#35136)
1 parent f9de4f9 commit 4e9913c

95 files changed

Lines changed: 2431 additions & 2121 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/database-engine/configure-windows/allow-polybase-export.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,15 @@ This change takes effect immediately.
3434
The following example enables this setting.
3535

3636
```sql
37-
EXEC sp_configure 'show advanced options', 1;
37+
EXECUTE sp_configure 'show advanced options', 1;
3838
GO
39+
3940
RECONFIGURE;
4041
GO
41-
EXEC sp_configure 'allow polybase export', 1;
42+
43+
EXECUTE sp_configure 'allow polybase export', 1;
4244
GO
45+
4346
RECONFIGURE;
4447
GO
4548
```

docs/database-engine/configure-windows/availability-group-commit-time-server-configuration-options.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Learn to modify the commit time for an availability group replica
44
author: MashaMSFT
55
ms.author: mathoma
66
ms.reviewer: randolphwest
7-
ms.date: 05/19/2025
7+
ms.date: 08/26/2025
88
ms.service: sql
99
ms.subservice: configuration
1010
ms.topic: conceptual
@@ -15,14 +15,14 @@ ms.custom:
1515

1616
[!INCLUDE [SQL Server](../../includes/applies-to-version/_ss2025.md)]
1717

18-
Use the `availability group commit time` server configuration option to specify the group commit time, in milliseconds, for an [Always On availability group replica](../../database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.md).
18+
Use the `availability group commit time` server configuration option to specify the group commit time, in milliseconds, for an [Always On availability group](../availability-groups/windows/overview-of-always-on-availability-groups-sql-server.md).
1919

2020
> [!NOTE]
2121
> The `availability group commit time` server configuration option is available starting with [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)].
2222
2323
## Overview
2424

25-
Changes made inside a transaction aren't visible outside of the transaction until the transaction is committed. The definition of a committed transaction for an Always On availability group involves all synchronous secondary replicas in the availability group acknowledging the hardened commit. After a commit is issued on the primary replica, that fact needs to be propagated quickly across the network to all secondary replicas.
25+
Changes made inside a transaction aren't visible outside of the transaction until the transaction is committed. The definition of a committed transaction for an Always On availability group involves all synchronous secondary replicas in the availability group acknowledging the hardened commit. After a commit is issued on the primary replica, that fact needs to be propagated quickly across the network to all secondary replicas.
2626

2727
Since SQL Server relies on [write-ahead transaction logging](../../relational-databases/sql-server-transaction-log-architecture-and-management-guide.md#WAL) to maintain ACID properties of a transaction, changes are first recorded to the transaction log in the form of [log blocks](../../relational-databases/sql-server-transaction-log-architecture-and-management-guide.md#log-blocks). These log blocks are sent, and then applied, to the transaction log of all the secondary replicas.
2828

@@ -41,9 +41,9 @@ For business scenarios where the default value of 10 milliseconds is too long, y
4141

4242
- The default value of `0` indicates that [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] uses the default value of 10 ms for the availability group commit time.
4343

44-
- The `availability group commit time` server configuration option is available when [show advanced options](../../database-engine/configure-windows/show-advanced-options-server-configuration-option.md) is set to `1`.
44+
- The `availability group commit time` server configuration option is available when [show advanced options](show-advanced-options-server-configuration-option.md) is set to `1`.
4545

4646
## Related content
4747

48-
- [Server configuration options](../../database-engine/configure-windows/server-configuration-options-sql-server.md)
48+
- [Server configuration options](server-configuration-options-sql-server.md)
4949
- [sp_configure (Transact-SQL)](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md)

docs/database-engine/configure-windows/backup-checksum-default.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: "Configure the backup checksum default (server configuration option)"
2+
title: "Server Configuration: backup checksum default"
33
description: Find out about the backup checksum default option. See how to use it to turn backup checksum on or off during SQL Server backup and restore operations.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 03/28/2024
6+
ms.date: 08/26/2025
77
ms.service: sql
88
ms.subservice: configuration
99
ms.topic: how-to
1010
---
1111

12-
# Configure the backup checksum default (server configuration option)
12+
# Server configuration: backup checksum default
1313

1414
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
1515

16-
Use the backup checksum default setting to enable or disable backup checksum during all backup and restore operations at the instance level.
16+
Use the `backup checksum default` setting to enable or disable backup checksum during all backup and restore operations at the instance level.
1717

1818
To configure checking for errors for individual backup or restore operations, see [Enable or disable backup checksums during backup or restore (SQL Server)](../../relational-databases/backup-restore/enable-or-disable-backup-checksums-during-backup-or-restore-sql-server.md).
1919

@@ -27,43 +27,41 @@ The following table describes the valid values:
2727
To enable backup checksum for all backup and restore operations at the instance level, run the following command:
2828

2929
```sql
30-
EXEC sp_configure 'backup checksum default', 1;
30+
EXECUTE sp_configure 'backup checksum default', 1;
3131
RECONFIGURE;
3232
```
3333

3434
The setting takes effect immediately.
3535

3636
## Usage scenarios
3737

38-
You can use the backup checksum default setting to provide error-management options (`CHECKSUM` and `NO_CHECKSUM`) when using backup applications or utilities that don't natively expose these options. You might also use this option when you use utilities such as [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] log shipping or the Backup database task from [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] maintenance plans. These utilities and the associated Transact-SQL stored procedures don't provide an option to include the `CHECKSUM` option during backup.
38+
You can use the `backup checksum default` setting to provide error-management options (`CHECKSUM` and `NO_CHECKSUM`) when using backup applications or utilities that don't natively expose these options. You might also use this option when you use utilities such as [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] log shipping or the Backup database task from [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] maintenance plans. These utilities and the associated Transact-SQL stored procedures don't provide an option to include the `CHECKSUM` option during backup.
3939

4040
## More information
4141

4242
If the page checksum validation fails during the backup operation, [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] stops the backup operation and reports error message 3043. For more information on the error and troubleshooting steps, see the error page for [MSSQLSERVER_3043](../../relational-databases/errors-events/mssqlserver-3043-database-engine-error.md).
4343

44-
When you use the explicit `NO_CHECKSUM` option in the `BACKUP` command, the backup checksum default server option is overridden.
44+
When you use the explicit `NO_CHECKSUM` option in the `BACKUP` command, the `backup checksum default` server option is overridden.
4545

4646
To determine whether checksum was being used during a backup to protect a backup set, use one of the following methods:
4747

4848
- The `HasBackupChecksums` flag in the output of the `RESTORE HEADERONLY` command. For example:
4949

5050
```sql
51-
RESTORE headeronly FROM disk = 'c:\temp\master.bak'
51+
RESTORE HEADERONLY FROM DISK = 'c:\temp\master.bak';
5252
```
5353

5454
- The `has_backup_checksums` column in the `backupset` system table in the `msdb` database. For example:
5555

5656
```sql
57-
SELECT has_backup_checksums, database_name, *
58-
FROM msdb..backupset
57+
SELECT has_backup_checksums,
58+
database_name,
59+
*
60+
FROM msdb..backupset;
5961
```
6062

6163
If the backup is performed by using the `CHECKSUM` option, the restore operation automatically performs the validation, and then displays error message 3183. For more information on the error and troubleshooting steps, see the error page for [MSSQLSERVER_3183](../../relational-databases/errors-events/mssqlserver-3183-database-engine-error.md).
6264

63-
## SQL Server 2012 and earlier versions
64-
65-
In [!INCLUDE [sssql11-md](../../includes/sssql11-md.md)] and earlier versions, this option doesn't exist. You need to use Trace Flag 3023 to enable the `CHECKSUM` option as a default for the `BACKUP` command. Trace Flag 3023 can be used dynamically by using a `DBCC TRACEON` statement, or it can be used as a startup parameter.
66-
6765
### Dynamic usage
6866

6967
```sql

docs/database-engine/configure-windows/blocked-process-threshold-server-configuration-option.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ The setting takes effect immediately without a server stop and restart.
3232
The following example sets the `blocked process threshold` to `20` seconds, generating a blocked process report for each task that is blocked.
3333

3434
```sql
35-
sp_configure 'show advanced options', 1;
35+
EXECUTE sp_configure 'show advanced options', 1;
3636
GO
3737

3838
RECONFIGURE;
3939
GO
4040

41-
sp_configure 'blocked process threshold', 20;
41+
EXECUTE sp_configure 'blocked process threshold', 20;
4242
GO
4343

4444
RECONFIGURE;

docs/database-engine/configure-windows/broadcast-a-shutdown-message-command-prompt.md

Lines changed: 26 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Broadcast a Shutdown Message (Command Prompt)"
33
description: Find out how to use the net send command to broadcast a message in SQL Server. See how to determine which users are currently connected to SQL Server.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: "03/14/2017"
6+
ms.date: 08/26/2025
77
ms.service: sql
88
ms.subservice: configuration
99
ms.topic: how-to
@@ -16,26 +16,29 @@ helpviewer_keywords:
1616
- "default instances [SQL Server], broadcasting shutdown messages"
1717
- "stopping SQL Server"
1818
---
19-
# Broadcast a Shutdown Message (Command Prompt)
20-
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
21-
This topic describes how to broadcast a shutdown message in [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)] by using the **net send** command. In the message, include the time the instance of [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] will be stopped so that users can finish their tasks.
22-
23-
## <a name="SSMSProcedure"></a>
24-
25-
#### To broadcast a shutdown message
26-
27-
1. From a command prompt, enter:
28-
29-
**net send /users "message"**
30-
31-
The **/users** option specifies that the message be sent to all users connected to the server
32-
19+
# Broadcast a shutdown message from the command prompt
20+
21+
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
22+
23+
This article describes how to broadcast a shutdown message in [!INCLUDE [ssnoversion](../../includes/ssnoversion-md.md)] by using the `net send` command. In the message, include the time the instance of [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] is going to stop, so that users can finish their tasks.
24+
25+
<a id="SSMSProcedure"></a>
26+
27+
## Broadcast a shutdown message
28+
29+
1. From a command prompt, enter:
30+
31+
```console
32+
net send /users "message"
33+
```
34+
35+
The `/users` option specifies that the message is sent to all users connected to the server.
36+
3337
> [!NOTE]
34-
> The **net send** command requires the messenger service to be running on both the sending and the receiving computers. The messenger service is disabled by default on Windows Server 2003. For information about **net send**, see the Windows documentation.
35-
36-
On your network, it may be more appropriate to contact users by e-mail or the telephone. To determine which users are currently connected to [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)], use the Activity Monitor. For information on the Activity Monitor, see [Activity Monitor](../../relational-databases/performance-monitor/activity-monitor.md) and [Open Activity Monitor &#40;SQL Server Management Studio&#41;](../../relational-databases/performance-monitor/open-activity-monitor-sql-server-management-studio.md).
37-
38-
## See Also
39-
[Start, Stop, Pause, Resume, Restart the Database Engine, SQL Server Agent, or SQL Server Browser Service](../../database-engine/configure-windows/start-stop-pause-resume-restart-sql-server-services.md)
40-
41-
38+
> The `net send` command requires the messenger service to be running on both the sending and the receiving computers. The messenger service is disabled by default on Windows Server 2003. For information about `net send`, see the Windows documentation.
39+
40+
On your network, it might be more appropriate to contact users by e-mail or the telephone. To determine which users are currently connected to [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)], use the Activity Monitor. For information on the Activity Monitor, see [Activity Monitor](../../relational-databases/performance-monitor/activity-monitor.md) and [Open Activity Monitor in SQL Server Management Studio (SSMS)](../../relational-databases/performance-monitor/open-activity-monitor-sql-server-management-studio.md).
41+
42+
## Related content
43+
44+
- [Start, stop, pause, resume, and restart SQL Server services](start-stop-pause-resume-restart-sql-server-services.md)

docs/database-engine/configure-windows/buffer-pool-extension.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.topic: conceptual
1212

1313
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
1414

15-
Introduced in [!INCLUDE [ssSQL14](../../includes/sssql14-md.md)], the buffer pool extension provides the seamless integration of a nonvolatile random access memory (that is, solid-state drive) extension to the [!INCLUDE [ssDE](../../includes/ssde-md.md)] buffer pool to significantly improve I/O throughput. The buffer pool extension isn't available in every [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] edition. For more information, see [Features Supported by the Editions of SQL Server 2016](~/sql-server/editions-and-supported-features-for-sql-server-2016.md).
15+
Introduced in [!INCLUDE [ssSQL14](../../includes/sssql14-md.md)], the buffer pool extension provides the seamless integration of a nonvolatile random access memory (that is, solid-state drive) extension to the [!INCLUDE [ssDE](../../includes/ssde-md.md)] buffer pool to significantly improve I/O throughput. The buffer pool extension isn't available in every [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] edition. For more information, see [Editions and supported features of SQL Server 2022](../../sql-server/editions-and-components-of-sql-server-2022.md).
1616

1717
## Benefits of the buffer pool extension
1818

@@ -59,17 +59,17 @@ When enabled, the buffer pool extension specifies the size and file path of the
5959

6060
## Capacity limitations
6161

62-
SQL Server Enterprise edition allows a maximum buffer pool extension size of 32 times the value of `max server memory`.
62+
SQL Server Enterprise edition allows a maximum buffer pool extension size of 32 times the value of `max server memory (MB)`.
6363

64-
SQL Server Standard edition allows a maximum buffer pool extension size of four times the value of `max server memory`.
64+
SQL Server Standard edition allows a maximum buffer pool extension size of four times the value of `max server memory (MB)`.
6565

6666
## Best practices
6767

6868
We recommend that you follow these best practices.
6969

7070
- After you enable buffer pool extension for the first time, you should restart the SQL Server instance to get the maximum performance benefits.
7171

72-
- Set the buffer pool extension so the ratio between the size of the physical memory (`max server memory`) and the size of the buffer pool extension of 1:16 or less. A lower ratio in the range of 1:4 to 1:8 might be optimal. For information about setting the `max server memory` option, see [Server memory configuration options](server-memory-server-configuration-options.md).
72+
- Set the buffer pool extension so the ratio between the size of the physical memory (`max server memory (MB)`) and the size of the buffer pool extension of 1:16 or less. A lower ratio in the range of 1:4 to 1:8 might be optimal. For information about setting the `max server memory (MB)` option, see [Server memory configuration options](server-memory-server-configuration-options.md).
7373

7474
- Test the buffer pool extension thoroughly before implementing in a production environment. Once in production, avoid making configuration changes to the file or turning off the feature. These activities might have a negative effect on server performance because the buffer pool is significantly reduced in size when the feature is disabled. When disabled, the memory used to support the feature isn't reclaimed until the instance of SQL Server is restarted. However, if the feature is re-enabled, the memory is reused without restarting the instance.
7575

0 commit comments

Comments
 (0)