sp_refreshview (Transact-SQL)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Actualiza los metadatos de la vista no enlazada a esquema especificada. Los metadatos persistentes de una vista pueden quedar desfasados debido a los cambios realizados en los objetos subyacentes de los que depende la vista.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_refreshview [ @viewname = ] 'viewname'
[ ; ]

Argumentos

[ @viewname = ] 'viewname'

El nombre de la vista. @viewname es nvarchar, sin valor predeterminado. @viewname puede ser un identificador de varias partes, pero solo puede hacer referencia a las vistas de la base de datos actual.

Valores de código de retorno

0 (correcto) o un número distinto de cero (error).

Comentarios

Si no se crea una vista con SCHEMABINDING, sp_refreshview debe ejecutarse cuando se realicen cambios en los objetos subyacentes a la vista, lo que afecta a la definición de la vista. De lo contrario, la vista podría generar resultados inesperados cuando se consulta.

Permisos

Requiere el permiso ALTER en la vista y el permiso REFERENCES en los tipos definidos por el usuario Common Language Runtime (CLR) y las colecciones de esquemas XML a los que hacen referencia las columnas de la vista.

Ejemplos

A Actualización de los metadatos de una vista

En el siguiente ejemplo se actualizan los metadatos de la vista Sales.vIndividualCustomer.

USE AdventureWorks2022;
GO

EXECUTE sp_refreshview N'Sales.vIndividualCustomer';

B. Cree un script que actualice todas las vistas que tienen dependencias en un objeto modificado.

Suponga que la tabla Person.Person se modificó de una forma que afecte a la definición de todas las vistas que se creen en ella. En el siguiente ejemplo se crea un script que actualiza los metadatos de todas las vistas que tienen una dependencia en la tabla Person.Person.

USE AdventureWorks2022;
GO
SELECT DISTINCT 'EXEC sp_refreshview ''' + name + ''''
FROM sys.objects AS so
INNER JOIN sys.sql_expression_dependencies AS sed
    ON so.object_id = sed.referencing_id
WHERE so.type = 'V' AND sed.referenced_id = OBJECT_ID('Person.Person');