Merge pull request #36584 from WilliamDAssafMSFT/20260207-for-secondary

20260207 ALTER DATABASE ... FOR SECONDARY

Author: prmerger-automator[bot]

docs/relational-databases/performance/query-store-for-secondary-replicas.md

@@ -73,6 +73,9 @@ ALTER DATABASE [Database_Name]
     (OPERATION_MODE = READ_WRITE);
 ```
 
+> [!NOTE]
+> Before SQL Server Management Studio (SSMS) version 21, the `FOR SECONDARY` syntax is valid but not recognized by IntelliSense. For SQL Server 2022, SSMS IntelliSense does not recognize the `FOR SECONDARY` syntax as valid, but it is valid.
+
 ### Enable automatic plan correction for secondary replicas
 
 **Applies to**: [!INCLUDE [ssSQL22](../../includes/sssql22-md.md)] and later versions, [!INCLUDE [ssazure-sqldb](../../includes/ssazure-sqldb.md)].

docs/t-sql/statements/alter-database-transact-sql-set-options.md

@@ -4,7 +4,7 @@ description: Learn how to set database options such as Automatic tuning, encrypt
 author: markingmyname
 ms.author: maghan
 ms.reviewer: randolphwest, wiassaf
-ms.date: 12/10/2025
+ms.date: 02/09/2026
 ms.service: sql
 ms.subservice: t-sql
 ms.topic: reference
@@ -84,6 +84,8 @@ SET
     <option_spec> [ ,...n ] [ WITH <termination> ]
 }
 
+{ [ FOR SECONDARY ] SET <set_options> }
+
 <option_spec> ::=
 {
     <accelerated_database_recovery>
@@ -342,6 +344,16 @@ The name of the database to be modified.
 
 Runs the action in the current database. `CURRENT` isn't supported for all options in all contexts. If `CURRENT` fails, provide the database name.
 
+#### FOR SECONDARY
+
+**Applies to**: [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] and later versions
+
+Specifies the settings for secondary replicas. All secondary replicas must have the identical values. Similar to `FOR SECONDARY` for [ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)](alter-database-scoped-configuration-transact-sql.md).
+
+For use with the Query Store (`QUERY_STORE`) and Automatic Tuning (`AUTOMATIC_TUNING`) only.
+
+Before SQL Server Management Studio (SSMS) version 21, the `FOR SECONDARY` syntax is valid but not recognized by IntelliSense. For SQL Server 2022, SSMS IntelliSense does not recognize the `FOR SECONDARY` syntax as valid, but it is valid.
+
 #### \<accelerated_database_recovery> ::=
 
 **Applies to**: [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] (Starting with [!INCLUDE[sql-server-2019](../../includes/sssql19-md.md)])
@@ -1809,6 +1821,8 @@ SET
 }
 ;
 
+{ [ FOR SECONDARY ] SET <set_options> }
+
 <option_spec> ::=
 {
     <auto_option>
@@ -1957,6 +1971,14 @@ The name of the database to be modified.
 
 Controls automatic options.
 
+#### FOR SECONDARY
+
+Specifies the settings for secondary replicas. All secondary replicas must have the identical values. Similar to `FOR SECONDARY` for [ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)](alter-database-scoped-configuration-transact-sql.md).
+
+For use with the Query Store (`QUERY_STORE`) and Automatic Tuning (`AUTOMATIC_TUNING`) only.
+
+Before SQL Server Management Studio (SSMS) version 21, the `FOR SECONDARY` syntax is valid but not recognized by IntelliSense.
+
 #### <a id="auto_create_statistics"></a> AUTO_CREATE_STATISTICS { ON | OFF }
 
 - ON
@@ -2885,6 +2907,8 @@ SET
 }
 ;
 
+{ [ FOR SECONDARY ] SET <set_options> }
+
 <optionspec> ::=
 {
     <auto_option>
@@ -3009,6 +3033,14 @@ The name of the database to be modified.
 
 `CURRENT` runs the action in the current database. `CURRENT` isn't supported for all options in all contexts. If `CURRENT` fails, provide the database name.
 
+#### FOR SECONDARY
+
+Specifies the settings for secondary replicas. All secondary replicas must have the identical values. Similar to `FOR SECONDARY` for [ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)](alter-database-scoped-configuration-transact-sql.md).
+
+For use with the Query Store (`QUERY_STORE`) and Automatic Tuning (`AUTOMATIC_TUNING`) only.
+
+Before SQL Server Management Studio (SSMS) version 21, the `FOR SECONDARY` syntax is valid but not recognized by IntelliSense.
+
 #### \<auto_option> ::=
 
 Controls automatic options.