Server configuration: max text repl size

  • Article

Applies to: SQL Server Azure SQL Managed Instance

This article describes how to configure the max text repl size server configuration option in SQL Server by using SQL Server Management Studio or Transact-SQL. The max text repl size option specifies the maximum size (in bytes) of text, ntext, varchar(max), nvarchar(max), varbinary(max), xml, and image data that can be added to a replicated column or captured column in a single INSERT, UPDATE, WRITETEXT, or UPDATETEXT statement. The default value is 65,536 bytes. A value of -1 indicates that there's no size limit, other than the limit imposed by the data type.

Limitations

This option applies to transactional replication and Change Data Capture (CDC). When a server is configured for both transactional replication and CDC, the specified value applies to both features. This option is ignored by both snapshot replication and merge replication.

Permissions

Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, a user must be granted the ALTER SETTINGS server-level permission. The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

Use SQL Server Management Studio

  1. In Object Explorer, right-click a server and select Properties.

  2. Select the Advanced node.

  3. Under Miscellaneous, change the Max Text Replication Size option to the desired value.

Use Transact-SQL

  1. Connect to the Database Engine.

  2. From the Standard bar, select New Query.

  3. Copy and paste the following example into the query window and select Execute. This example shows how to use sp_configure to configure the max text repl size option to -1.

    USE master;
GO

EXECUTE sp_configure 'show advanced options', 1;

RECONFIGURE;
GO

EXECUTE sp_configure 'max text repl size', -1;
GO

RECONFIGURE;
GO

EXECUTE sp_configure 'show advanced options', 0;
GO

RECONFIGURE;
GO

For more information, see Server configuration options.

Follow up: After you configure the max text repl size option

The setting takes effect immediately without restarting the server.

Related content