sp_autostats (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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 sobre la AUTO_UPDATE_STATISTICS opción, vea ALTER DATABASE SET Options (Transact-SQL) and Statistics .

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_autostats
    [ @tblname = ] N'tblname'
    [ , [ @flagc = ] 'flagc' ]
    [ , [ @indname = ] N'indname' ]
[ ; ]

Argumentos

[ @tblname = ] N'tblname'

Nombre de la tabla o vista indizada para la que se va a mostrar la AUTO_UPDATE_STATISTICS opción. @tblname es nvarchar(776), sin ningún valor predeterminado.

[ @flagc = ] 'flagc'

Novedades o muestra la AUTO_UPDATE_STATISTICS opción . @flagc es varchar(10) y puede ser uno de estos valores:

Valor Descripción
ON Activado
OFF Off
No especificado Muestra la configuración actual AUTO_UPDATE_STATISTICS

[ @indname = ] N'indname'

Nombre de las estadísticas para las que se va a mostrar o actualizar la AUTO_UPDATE_STATISTICS opción. @indname es sysname, con un valor predeterminado de NULL. 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.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Si se especifica @flagc , sp_autostats notifica la acción que se realizó, pero no devuelve ningún conjunto de resultados.

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

Nombre de la columna Tipo de datos Descripción
Index Name sysname Nombre del índice o de las estadísticas.
AUTOSTATS varchar(3) Valor actual de la AUTO_UPDATE_STATISTICS opción.
Last Updated datetime Fecha de la actualización más reciente de las estadísticas.

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

Comentarios

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

AUTO_UPDATE_STATISTICS siempre está desactivado para las tablas optimizadas para memoria.

Permisos

Para cambiar la AUTO_UPDATE_STATISTICS opción, necesita pertenecer al rol fijo de base de datos db_owner o ALTER permiso en @tblname.

Para mostrar la AUTO_UPDATE_STATISTICS opción, necesita pertenecer al rol público .

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 Production.Product.

USE AdventureWorks2022;
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 AUTO_UPDATE_STATISTICS opción para todas las estadísticas de la Production.Product tabla.

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

C. Deshabilitar AUTO_UPDATE_STATISTICS para un índice especificado

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

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

Contenido relacionado