Skip to content

Commit fb7baf9

Browse files
denreadenrea
authored
Merge pull request #36101 from rwestMSFT/rw-1217-refresh-stored-procedures
Refresh SQL Server 2025 and Fabric system stored procedures
2 parents 27b2663 + d099f50 commit fb7baf9

25 files changed

Lines changed: 277 additions & 220 deletions

‎docs/relational-databases/system-stored-procedures/includes/fabric-internal-use.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
author: rwestMSFT
3+
ms.author: randolphwest
4+
ms.date: 12/17/2025
5+
ms.service: sql
6+
ms.topic: include
7+
---
8+
> [!CAUTION]
9+
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.

‎docs/relational-databases/system-stored-procedures/sp-MSchange-feed-ddl-event.md‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_MSchange_feed_ddl_event internal system stored procedur
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Internal procedure that handles data definition language events.
2929

30-
> [!NOTE]
31-
> This internal system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -41,23 +40,23 @@ This system stored procedure is used for:
4140
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: [Transact-SQL syntax conventions](../../t-sql/language-elements/transact-sql-syntax-conventions-transact-sql.md)
4241

4342
```syntaxsql
44-
sys.sp_MSchange_feed_ddl_event
45-
@EventData xml
43+
sys.sp_MSchange_feed_ddl_event [ @EventData = ] N'EventData'
44+
[ ; ]
4645
```
4746

4847
## Arguments
4948

50-
#### EventData
49+
#### [ @EventData = ] N'*EventData*'
5150

52-
Internal use only.
51+
[!INCLUDE [ssinternalonly-md](../../includes/ssinternalonly-md.md)]
5352

5453
## Result set
5554

5655
`0` (success) or `1` (failure).
5756

5857
## Permissions
5958

60-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
59+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
6160

6261
## Related content
6362

‎docs/relational-databases/system-stored-procedures/sp-change-feed-configure-parameters.md‎

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_configure_parameters system stored procedur
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 08/19/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -66,66 +66,65 @@ Data type is **int**. Describes the frequency that the log is scanned for any ne
6666
- For Azure Synapse Link, the default interval if not specified is 5 seconds. The value must be `5` or larger.
6767
- For Fabric mirroring, this value is dynamically determined and automatically set.
6868

69-
#### [ @autoreseed = ] *autoreseed*
69+
#### [ @autoreseed = ] *autoreseed*
7070

71-
**Applies to:** Fabric Mirroring only
71+
**Applies to**: Fabric Mirroring only
7272

7373
The `autoreseed` argument defines the setting of the autoreseed option. `0` = disabled, `1` = enabled at the provided *autoreseed_threshold_percent*.
7474

75-
The autoreseed feature is disabled by default in SQL Server 2025 (Preview). The autoreseed feature is enabled and cannot be managed or disabled in Azure SQL Database and Azure SQL Managed Instance.
75+
The autoreseed feature is disabled by default in SQL Server 2025 (Preview). The autoreseed feature is enabled and can't be managed or disabled in Azure SQL Database and Azure SQL Managed Instance.
7676

7777
During reseed, the mirrored database item in Microsoft Fabric is available but will not receive incremental changes.
7878

7979
For more information, see [Configure automatic reseed for Fabric mirrored databases](/fabric/database/mirrored-database/sql-server-configure-automatic-reseed).
8080

8181
#### [ @autoreseedthreshold = ] *autoreseed_threshold_percent*
8282

83-
**Applies to:** Fabric Mirroring only
83+
**Applies to**: Fabric Mirroring only
8484

8585
The `autoreseedthreshold` argument defines the log usage percentage threshold when an autoreseed event triggers. By default, `70`.
8686

87-
#### [ @dynamicmaxtrans = ] *transactions*
87+
#### [ @dynamicmaxtrans = ] *transactions*
8888

89-
**Applies to:** Fabric Mirroring only
89+
**Applies to**: Fabric Mirroring only
9090

91-
Whether or not the dynamic maximum transactions setting for Fabric Mirroring is enabled. `0` = disabled, `1` = enabled. Fabric follows a maximum number of transactions to process in each scan cycle. For more information, [Mirrored databases from SQL Server performance](/fabric/database/mirrored-database/sql-server-performance#control-scan-performance).
91+
Whether or not the dynamic maximum transactions setting for Fabric Mirroring is enabled. `0` = disabled, `1` = enabled. Fabric follows a maximum number of transactions to process in each scan cycle. For more information, [Mirrored databases from SQL Server performance](/fabric/database/mirrored-database/sql-server-performance#control-scan-performance).
9292

93-
94-
The dynamic maximum transactions feature is enabled by default in SQL Server 2025 (Preview). The dynamic maximum transactions feature is enabled and cannot be managed or disabled in Azure SQL Database and Azure SQL Managed Instance.
93+
The dynamic maximum transactions feature is enabled by default in SQL Server 2025 (Preview). The dynamic maximum transactions feature is enabled and can't be managed or disabled in Azure SQL Database and Azure SQL Managed Instance.
9594

9695
#### [ @dynamicmaxtranslowerbound = ] *transactions_lower_bound*
9796

98-
**Applies to:** Fabric Mirroring only
97+
**Applies to**: Fabric Mirroring only
9998

100-
The lower bound for dynamic maxtrans setting for Fabric Mirroring. By default, the lower bound value is `200`.
99+
The lower bound for dynamic maxtrans setting for Fabric Mirroring. By default, the lower bound value is `200`.
101100

102101
## Returns
103102

104103
`0` (success) or `1` (failure).
105104

106105
## Permissions
107106

108-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
107+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
109108

110-
## Example
109+
## Examples
111110

112111
### A. Enable automatic reseed
113112

114-
**Applies to:** Fabric Mirroring only
113+
**Applies to**: Fabric Mirroring only
115114

116115
Use the following T-SQL sample to enable automatic reseed on the current mirrored database. Specify a log usage percentage threshold to trigger an autoreseed event, for example 70%. For more information, see [Configure automatic reseed for Fabric mirrored databases](/fabric/database/mirrored-database/sql-server-configure-automatic-reseed).
117116

118117
```sql
119118
USE <Mirrored database name>
120119
GO
121-
EXECUTE sys.sp_change_feed_configure_parameters
120+
EXECUTE sys.sp_change_feed_configure_parameters
122121
@autoreseed = 1
123-
, @autoreseedthreshold = 70;
122+
, @autoreseedthreshold = 70;
124123
```
125124

126125
### B. Disable automatic reseed
127126

128-
**Applies to:** Fabric Mirroring only
127+
**Applies to**: Fabric Mirroring only
129128

130129
Use the following T-SQL sample to disable automatic reseed on the current mirrored database.
131130

@@ -137,14 +136,14 @@ EXECUTE sys.sp_change_feed_configure_parameters @autoreseed = 0;
137136

138137
### C. Enable dynamic maximum transactions
139138

140-
**Applies to:** Fabric Mirroring only
139+
**Applies to**: Fabric Mirroring only
141140

142141
To enable the dynamic maximum transactions feature, set `@dynamicmaxtrans` to `1`. For example:
143142

144143
```sql
145144
USE <Mirrored database name>
146145
GO
147-
EXECUTE sys.sp_change_feed_configure_parameters
146+
EXECUTE sys.sp_change_feed_configure_parameters
148147
@dynamicmaxtrans=1;
149148
```
150149

@@ -153,15 +152,15 @@ To disable the dynamic maximum transactions feature, set `@dynamicmaxtrans` to `
153152
```sql
154153
USE <Mirrored database name>
155154
GO
156-
EXECUTE sys.sp_change_feed_configure_parameters
155+
EXECUTE sys.sp_change_feed_configure_parameters
157156
@dynamicmaxtrans=0;
158157
```
159158

160-
Verify the setting of the dynamic maximum transactions feature with [sys.sp_help_change_feed_settings (Transact-SQL)](sp-help-change-feed-settings.md).
159+
Verify the setting of the dynamic maximum transactions feature with [sys.sp_help_change_feed_settings](sp-help-change-feed-settings.md).
161160

162161
### D. Configure the dynamic maximum transactions maximum and lower bound
163162

164-
**Applies to:** Fabric Mirroring only
163+
**Applies to**: Fabric Mirroring only
165164

166165
To modify the maximum and lower bounds for the dynamic maximum transactions feature, use `@maxtrans` and `@dynamicmaxtranslowerbound` respectively. For example:
167166

‎docs/relational-databases/system-stored-procedures/sp-change-feed-create-table-group.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_create_table_group system stored procedure
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Creates a source to maintain metadata specific to each table group. A table group represents the container for all the individual tables that will be replicated.
2929

30-
> [!CAUTION]
31-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -74,7 +73,7 @@ The credential name to access the landing zone.
7473

7574
## Permissions
7675

77-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
76+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
7877

7978
## Related content
8079

‎docs/relational-databases/system-stored-procedures/sp-change-feed-disable-db.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_disable_db system stored procedure disables
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Disable the change feed at the database level, and then the metadata for all the associated tables.
2929

30-
> [!CAUTION]
31-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -47,7 +46,7 @@ sys.sp_change_feed_disable_db
4746

4847
## Permissions
4948

50-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
49+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
5150

5251
## Remarks
5352

‎docs/relational-databases/system-stored-procedures/sp-change-feed-disable-table.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The internal sys.sp_change_feed_disable_table system stored proced
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: randolphwest, ajayj, imotiwala
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Removes a table from the change feed.
2929

30-
> [!CAUTION]
31-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -67,7 +66,7 @@ The last changes published and synchronized to Azure Synapse can't be guaranteed
6766

6867
## Permissions
6968

70-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
69+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
7170

7271
## Related content
7372

‎docs/relational-databases/system-stored-procedures/sp-change-feed-drop-table-group.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_drop_table_group system stored procedure dr
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Drops a table group and internal metadata objects.
2929

30-
> [!CAUTION]
31-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -54,7 +53,7 @@ Required. Data type is **uniqueidentifier**. The unique identifier of the table
5453

5554
## Permissions
5655

57-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
56+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
5857

5958
## Related content
6059

‎docs/relational-databases/system-stored-procedures/sp-change-feed-enable-db.md‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_enable_db system stored procedure enables t
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, randolphwest, ajayj
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -31,8 +31,7 @@ Enables current database for:
3131
- [Microsoft Fabric mirrored databases](/fabric/database/mirrored-database/overview)
3232
- [Azure Synapse Link](../../sql-server/synapse-link/synapse-link-sql-server-change-feed-manage.md)
3333

34-
> [!CAUTION]
35-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
34+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3635

3736
## Syntax
3837

@@ -64,20 +63,20 @@ Data type is **int**. Describes the frequency, or polling interval, that the log
6463

6564
#### @destination_type
6665

67-
**Applies to:** Fabric database mirroring only. For Synapse Link, do not specify.
66+
**Applies to**: Fabric database mirroring only. For Synapse Link, don't specify.
6867

6968
Data type is **int**. Default is `0`, for Azure Synapse Link. `2` = Fabric database mirroring.
7069

7170
## Permissions
7271

73-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
72+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
7473

7574
## Examples
7675

7776
The following sample enables the change feed.
7877

7978
```sql
80-
EXECUTE sys.sp_change_feed_enable_db;
79+
EXECUTE sys.sp_change_feed_enable_db ;
8180
```
8281

8382
Verify the database is enabled.

‎docs/relational-databases/system-stored-procedures/sp-change-feed-enable-table.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The sys.sp_change_feed_enable_table system stored procedure enable
44
author: WilliamDAssafMSFT
55
ms.author: wiassaf
66
ms.reviewer: imotiwala, ajayj, randolphwest
7-
ms.date: 06/23/2025
7+
ms.date: 12/17/2025
88
ms.service: fabric
99
ms.subservice: system-objects
1010
ms.topic: "reference"
@@ -27,8 +27,7 @@ monikerRange: ">=sql-server-ver16 || =azuresqldb-current || =azuresqldb-mi-curre
2727

2828
Stored procedure to enable the creation of a new table to an existing table group.
2929

30-
> [!CAUTION]
31-
> This system stored procedure is used internally and isn't recommended for direct administrative use. Use Synapse Studio or the Fabric portal instead. Using this procedure could introduce inconsistency.
30+
[!INCLUDE [fabric-internal-use](includes/fabric-internal-use.md)]
3231

3332
This system stored procedure is used for:
3433

@@ -69,7 +68,7 @@ The source table name.
6968

7069
## Permissions
7170

72-
A user with [CONTROL database permissions](../security/permissions-database-engine.md), **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
71+
A user with `CONTROL` database permissions, **db_owner** database role membership, or **sysadmin** server role membership can execute this procedure.
7372

7473
## Related content
7574

0 commit comments

Comments
 (0)