sp_estimated_rowsize_reduction_for_vardecimal (Transact-SQL)

Applies to: SQL Server

Estimates the reduction in the average size of rows if you enable vardecimal storage format on a table. Use this number to estimate the overall reduction in the size of the table. Since the statistical sampling is used to compute the average reduction in the rowsize, regard it as an estimate only. In rare cases, rowsize may increase after enabling the vardecimal storage format.

Note

This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use ROW and PAGE compression instead. For more information, see Data Compression. For compression effects on the size of tables and indexes, see sp_estimate_data_compression_savings (Transact-SQL).

Transact-SQL syntax conventions

Syntax

  
sp_estimated_rowsize_reduction_for_vardecimal [ [ @table_name = ] 'table'] [;]  

Arguments

[ @table = ] 'table' Is the three part name of the table for which the storage format is to be changed. table is nvarchar(776).

Return Code Values

0 (success) or 1 (failure)

Result Sets

The following result set is returned to provide current and estimated table size information.

Column name Data type Description
avg_rowlen_fixed_format decimal (12, 2) Represents the length of the row in fixed decimal storage format.
avg_rowlen_vardecimal_format decimal (12, 2) Represents average rowsize when vardecimal storage format is used.
row_count int Number of rows in the table.

Remarks

Use sp_estimated_rowsize_reduction_for_vardecimal to estimate the savings that result if you enable a table for vardecimal storage format. For instance if the average size of the row can be reduced by 40%, you can potentially reduce the size of the table by 40%. You may not receive a space savings depending on the fill factor and the size of the row. For example, if you have a row that is 8000 bytes long and you reduce its size by 40%, you can still fit only one row on a data page, resulting in no savings.

If the results of sp_estimated_rowsize_reduction_for_vardecimal indicate that the table will grow, this means that many rows in the table use nearly the entire precision of the decimal data types, and the addition of the small overhead needed for vardecimal storage format is greater than the savings from vardecimal storage format. In this rare case, do not enable vardecimal storage format.

If a table is enabled for vardecimal storage format, use sp_estimated_rowsize_reduction_for_vardecimal to estimate the average size of the row if vardecimal storage format is disabled.

Permissions

Requires CONTROL permission on the table.

Examples

The following example estimates the rowsize reduction if the Production.WorkOrderRouting table in the AdventureWorks2022 database is compressed.

USE AdventureWorks2022;  
GO  
EXEC sp_estimated_rowsize_reduction_for_vardecimal 'Production.WorkOrderRouting' ;  
GO  

See Also

sp_db_vardecimal_storage_format (Transact-SQL)
sp_tableoption (Transact-SQL)