• Artigo

sp_depends (Transact-SQL)

Exibe informações sobre dependências de objeto de banco de dados, como as exibições e procedimentos que dependem de uma tabela ou exibição e, as tabelas e exibições que dependem da exibição ou procedimento. Não são informadas referências para objetos fora do banco de dados atual.

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. É recomendado usar sys.dm_sql_referencing_entities e sys.dm_sql_referenced_entities.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_depends [ @objname = ] '<object>' 

<object> ::=
{
    [ database_name. [ schema_name ] . | schema_name.
        object_name
}

Argumentos

  • database_name
    É o nome do banco de dados.

  • schema_name
    É o nome do esquema ao qual o objeto pertence.

  • object_name
    É o objeto de banco de dados que será examinado para verificar se há dependências. O objeto pode ser uma tabela, exibição, procedimento armazenado, função definida pelo o usuário ou gatilho.bject_name é nvarchar(776), sem padrão.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

sp_depends exibe dois conjuntos de resultados.

O conjunto de resultados seguinte mostra os objetos dos quais o <objeto> depende.

Nome da coluna

Tipo de dados

Descrição

name

nvarchar(257)

Nome do item para o qual uma dependência existe.

type

nvarchar(16)

O tipo do item.

updated

nvarchar(7)

Caso o item seja atualizado.#

selected

nvarchar(8)

Se o item é usado em uma instrução SELECT.

column

sysname

Coluna ou parâmetro em que a dependência existe.

O conjunto de resultados a seguir mostra os objetos que dependem de <object>.

Nome da coluna

Tipo de dados

Descrição

name

nvarchar(257)

Nome do item para o qual uma dependência existe.

type

nvarchar(16)

O tipo do item.

Permissões

Requer associação na função public.

Exemplos

A. Listando as dependências em uma tabela

O exemplo a seguir lista os objetos de banco de dados que dependem da tabela Sales.Customer do banco de dados AdventureWorks. São especificados o nome do esquema e da tabela.

USE AdventureWorks
GO
EXEC sp_depends @objname = N'Sales.Customer' ;

B. Listando as dependências de um gatilho

O exemplo a seguir lista os objetos de banco de dados dos quais o gatilho depende iWorkOrder.

EXEC sp_depends @objname = N'AdventureWorks.Production.iWorkOrder' ;