Edit

Share via

sys.sp_change_feed_configure_parameters (Transact-SQL)

Applies to: SQL Server 2022 (16.x) and later versions Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Warehouse in Microsoft Fabric SQL database in Microsoft Fabric Preview

Configures optional performance settings for the change feed for the current database context.

This system stored procedure is used to fine tune the operational performance for:

Syntax

Transact-SQL syntax conventions

sys.sp_change_feed_configure_parameters
    [ [ @maxtrans = ] max_trans ]
    [ , [ @pollinterval = ] polling_interval ]
    [ , [ @autoreseed = ] autoreseed ]
    [ , [ @autoreseedthreshold = autoreseed_threshold_percent ]
    [ , [ @dynamicmaxtrans = ] transactions ]
    [ , [ @dynamicmaxtranslowerbound = ] transactions_lower_bound ]
[ ; ]

Arguments

[ @maxtrans = ] max_trans

Data type is int. Indicates the maximum number of transactions to process in each scan cycle.

Used to reduce latency by decreasing change batch size with @maxtrans, or to reduce the cost by increasing the batch size. As the batch size increases, fewer I/O operations are performed.

  • For Azure Synapse Link, the default value if not specified is 10000. If specified, the value must be a positive integer.
  • For Fabric mirroring, this value is dynamically determined and automatically set.

[ @pollinterval = ] polling_interval

Data type is int. Describes the frequency that the log is scanned for any new changes, in seconds.

  • For Azure Synapse Link, the default interval if not specified is 5 seconds. The value must be 5 or larger.
  • For Fabric mirroring, this value is dynamically determined and automatically set.

[ @autoreseed = ] autoreseed

Applies to: Fabric Mirroring only

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

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.

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

For more information, see Configure automatic reseed for Fabric mirrored databases.

[ @autoreseedthreshold = ] autoreseed_threshold_percent

Applies to: Fabric Mirroring only

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

[ @dynamicmaxtrans = ] transactions

Applies to: Fabric Mirroring only

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.

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.

[ @dynamicmaxtranslowerbound = ] transactions_lower_bound

Applies to: Fabric Mirroring only

The lower bound for dynamic maxtrans setting for Fabric Mirroring. By default, the lower bound value is 200.

Returns

0 (success) or 1 (failure).

Permissions

A user with CONTROL database permissions, db_owner database role membership, or sysadmin server role membership can execute this procedure.

Example

A. Enable automatic reseed

Applies to: Fabric Mirroring only

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.

USE <Mirrored database name>
GO
EXECUTE sys.sp_change_feed_configure_parameters 
  @autoreseed = 1
, @autoreseedthreshold = 70;

B. Disable automatic reseed

Applies to: Fabric Mirroring only

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

USE <Mirrored database name>
GO
EXECUTE sys.sp_change_feed_configure_parameters @autoreseed = 0;

C. Enable dynamic maximum transactions

Applies to: Fabric Mirroring only

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

USE <Mirrored database name>
GO
EXECUTE sys.sp_change_feed_configure_parameters 
  @dynamicmaxtrans=1;

To disable the dynamic maximum transactions feature, set @dynamicmaxtrans to 0. For example:

USE <Mirrored database name>
GO
EXECUTE sys.sp_change_feed_configure_parameters 
  @dynamicmaxtrans=0;

Verify the setting of the dynamic maximum transactions feature with sys.sp_help_change_feed_settings (Transact-SQL).

D. Configure the dynamic maximum transactions maximum and lower bound

Applies to: Fabric Mirroring only

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

USE <Mirrored database name>
GO
EXECUTE sys.sp_change_feed_configure_parameters
  @dynamicmaxtrans=1
, @dynamicmaxtranslowerbound=5
, @maxtrans=5000;

Related content