sp_autostats (Transact-SQL)

Muestra o cambia la opción de actualización automática de estadísticas, AUTO_UPDATE_STATISTICS, para un índice, un objeto de estadísticas, una tabla o una vista indizada.

Para obtener más información acerca de la opción AUTO_UPDATE_STATISTICS, vea Opciones de ALTER DATABASE SET (Transact-SQL) y Utilizar las estadísticas para mejorar el rendimiento de las consultas.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_autostats [ @tblname = ] 'table_or_indexed_view_name' 
    [ , [ @flagc = ] 'stats_value' ] 
    [ , [ @indname = ] 'statistics_name' ]

Argumentos

  • [ @tblname= ] 'table_or_indexed_view_name'
    Es el nombre de la tabla o vista indizada para la que se muestra la opción AUTO_UPDATE_STATISTICS. table_or_indexed_view_name es de tipo nvarchar(776) y no tiene un valor predeterminado.

  • [ @flagc= ] 'stats_value'
    Actualiza la opción AUTO_UPDATE_STATISTICS a uno de estos valores:

    ON = ON

    OFF = OFF

    Cuando no se especifica stats_flag, muestra la configuración actual de AUTO_UPDATE_STATISTICS. stats_value es varchar(10), con un valor predeterminado de NULL.

  • [ @indname= ] 'statistics_name'
    Es el nombre de las estadísticas para las que se muestra o actualiza la opción AUTO_UPDATE_STATISTICS. Para que se muestren las estadísticas de un índice, se puede usar el nombre del mismo; un índice y su objeto de estadísticas correspondiente tienen el mismo nombre.

    statistics_name es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Si se especifica stats_flag, sp_autostats informa acerca de la acción que se realizó, pero no devuelve un conjunto de resultados.

Si no se especifica stats_flag, sp_autostats devuelve el conjunto de resultados siguiente.

Nombre de columna

Tipo de datos

Descripción

Nombre de índice

varchar(60)

Nombre del índice o de las estadísticas.

AUTOSTATS

varchar(3)

Valor actual para la opción AUTO_UPDATE_STATISTICS.

Última actualización

datetime

Fecha de la actualización más reciente de las estadísticas.

El conjunto de resultados para una tabla o vista indizada incluye estadísticas creadas para índices, estadísticas de columna única generadas con la opción AUTO_CREATE_STATISTICS y estadísticas creadas con la instrucción CREATE STATISTICS.

Notas

Si el índice especificado está deshabilitado, o si la tabla especificada tiene un índice clúster deshabilitado, aparece un mensaje de error.

Permisos

Para cambiar la opción AUTO_UPDATE_STATISTICS, es necesario pertenecer a la función fija de base de datos db_owner o disponer del permiso ALTER en table_name. Para mostrar la opción AUTO_UPDATE_STATISTICS, es necesario pertenecer a la función public.

Ejemplos

A. Mostrar el estado de todas las estadísticas de una tabla

En el ejemplo siguiente, se muestra el estado de todas las estadísticas de la tabla Product.

USE AdventureWorks;
GO
EXEC sp_autostats 'Production.Product';
GO

B. Habilitar AUTO_UPDATE_STATISTICS para todas las estadísticas de una tabla

En el ejemplo siguiente, se habilita la opción AUTO_UPDATE_STATISTICS para todas las estadísticas de la tabla Product.

USE AdventureWorks;
GO
EXEC sp_autostats 'Production.Product', 'ON';
GO

C. Deshabilitar AUTO_UPDATE_STATISTICS para un índice especificado

En el ejemplo siguiente, se deshabilita la opción AUTO_UPDATE_STATISTICS para el índice AK_Product_Name de la tabla Product.

USE AdventureWorks;
GO
EXEC sp_autostats 'Production.Product', 'OFF', AK_Product_Name;
GO

Historial de cambios

Contenido actualizado

Revisiones en todo el documento para mejorar la exactitud.

En el tema se hace referencia al nuevo contenido sobre estadísticas del tema Utilizar las estadísticas para mejorar el rendimiento de las consultas.