sp_refreshview (Transact-SQL)
Atualiza os metadados para a exibição não associada a esquema. Os metadados persistentes de uma exibição podem tornar-se desatualizados devido a alterações em objetos subjacentes dos quais a exibição depende.
.gif "Ícone de vínculo de tópico")
Sintaxe
sp_refreshview [ @viewname = ] 'viewname'
Argumentos
- [ @viewname= ] 'viewname'
É o nome da exibição. viewname é nvarchar, sem padrão. viewname pode ser um identificador de várias partes, mas pode apenas se referir a exibições no banco de dados atual.
Valores de código de retorno
0 (êxito) ou um número diferente de zero (falha)
Comentários
Se uma exibição não for criada com associação de esquema, sp_refreshview deve ser executado quando são feitas mudanças nos objetos subjacentes que afetam a definição da exibição. Caso contrário, a exibição pode produzir resultados inesperados quando consultada.
Permissões
Requer permissão ALTER na exibição e permissão REFERENCES em tipos definidos pelo usuário de common language runtime (CLR) e coleções de esquema XML referenciadas por colunas de exibição.
Exemplos
A. Atualizando os metadados de uma exibição
O exemplo a seguir atualiza os metadados da exibição Sales.vIndividualCustomer.
USE AdventureWorks;
GO
EXECUTE sp_refreshview N'Sales.vIndividualCustomer';
B. Criando um script que atualiza todas as exibições com dependências de um objeto alterado
Considera que a tabela Person.Contact foi alterada de certo modo que afeta a definição de qualquer exibição criada a partir dela. O exemplo a seguir cria um script que atualiza os metadados de todas as exibições com dependência da tabela Person.Contact.
USE AdventureWorks;
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.Contact');