sp_refreshview (Transact-SQL)

Article
03/07/2014

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.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle, Base de données SQL Windows Azure (version initiale via la version actuelle.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sp_refreshview [ @viewname = ] 'viewname'

Arguments

[ @viewname= ] 'viewname'
Nom de la vue. viewname est de type nvarchar et n'a pas de valeur par défaut. viewname peut être un identificateur multipartie, mais ne peut faire référence qu'à des vues de la base de données active.

Valeurs des codes de retour

0 (succès) ou nombre non nul (échec)

Notes

Si aucune vue n'est créée avec schemabinding, sp_refreshview doit être exécutée lorsque des modifications sont apportées aux objets sous-jacents de la vue qui affectent sa définition. Sinon, la vue risque de produire des résultats imprévisibles en cas d'interrogation.

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

A.Mise à jour des métadonnées d'une vue

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

USE AdventureWorks2012;
GO
EXECUTE sp_refreshview N'Sales.vIndividualCustomer';

B.Création d'un script qui met à jour toutes les vues ayant des dépendances envers 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 AdventureWorks2012;
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');