sp_refreshview (Transact-SQL)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Met à jour les métadonnées de la vue non liée au schéma spécifiée. Les métadonnées persistantes d'une vue peuvent devenir obsolètes en raison des modifications des objets sous-jacents dont dépend l'affichage.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @viewname = ] 'viewname'

Nom de la vue. @viewname est nvarchar, sans valeur par défaut. @viewname peut être un identificateur à plusieurs parties, mais ne peut faire référence qu’aux vues de la base de données active.

Valeurs des codes de retour

0 (réussite) ou nombre différent de zéro (échec).

Notes

Si une vue n’est pas créée avec SCHEMABINDING, sp_refreshview doit être exécutée lorsque des modifications sont apportées aux objets sous-jacents à la vue, ce qui affecte la définition de la vue. Sinon, la vue peut produire des résultats inattendus lorsqu’il est interrogé.

autorisations

Requiert l'autorisation ALTER sur la vue ainsi que l'autorisation REFERENCES sur les types CLR (Common Language Runtime) définis par l'utilisateur et sur les collections de schémas XML référencés par les colonnes de la vue.

Exemples

R. Mettre à jour les métadonnées d’une vue

L'exemple suivant actualise les métadonnées de la vue Sales.vIndividualCustomer.

USE AdventureWorks2022;
GO

EXECUTE sp_refreshview N'Sales.vIndividualCustomer';

B. Créer un script qui met à jour toutes les vues qui ont des dépendances sur un objet modifié

Supposez que la table Person.Person a été modifiée d'une manière qui affecte la définition de toute vue créée dessus. L'exemple suivant crée un script qui actualise les métadonnées de toutes les vues qui ont une dépendance envers une table 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');