sp_tables_ex (Transact-SQL)

Retorna as informações de tabela sobre as tabelas do servidor vinculado especificado.

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

Sintaxe

sp_tables_ex [ @table_server = ] 'table_server' 
     [ , [ @table_name = ] 'table_name' ] 
     [ , [ @table_schema = ] 'table_schema' ]
     [ , [ @table_catalog = ] 'table_catalog' ] 
     [ , [ @table_type = ] 'table_type' ] 
     [ , [@fUsePattern = ] 'fUsePattern' ]

Argumentos

  • [ [ @table_server= ] 'table_server'
    É o nome do servidor vinculado para o qual as informações de tabela devem ser retornadas. table_server é sysname, sem padrão.

  • [ [ , [ @table_name= ] 'table_name']
    É o nome do proprietário da tabela usada para retornar informações de tipo de dados. table_nameé sysname, com um padrão NULL.

  • [ [ @table_schema= ] 'table_schema']
    É o esquema da tabela. table_schemaé sysname, com um padrão NULL.

  • [ [ @table_catalog= ] 'table_catalog'
    É o nome do banco de dados no qual o table_name especificado reside. table_catalog é sysname, com um padrão NULL.

  • [ [ @table_type= ] 'table_type'
    É o tipo da tabela a ser retornada. table_type é sysname, com um padrão NULL, e pode ter um dos valores a seguir.

    Valor

    Descrição

    ALIAS

    Nome de um alias.

    GLOBAL TEMPORARY

    Nome de uma tabela temporária disponível no sistema.

    LOCAL TEMPORARY

    Nome de uma tabela temporária disponível somente para o trabalho atual.

    SYNONYM

    Nome de um sinônimo.

    SYSTEM TABLE

    Nome de uma tabela do sistema.

    SYSTEM VIEW

    Nome de uma exibição do sistema.

    TABLE

    Nome de uma tabela de usuário.

    VIEW

    Nome de uma exibição.

  • [ [ @fUsePattern= ] 'fUsePattern'
    Determina se os caracteres _, %, [ e ] são interpretados como caracteres curinga. São valores válidos 0 (correspondência de padrão desativada) e 1 (correspondência de padrão ativada). fUsePattern é bit, com um padrão de 1.

Valores de código de retorno

Nenhum

Conjuntos de resultados

Nome da coluna

Tipo de dados

Descrição

TABLE_CAT

sysname

Nome do qualificador de tabela. Vários produtos de DBMS dão suporte à nomeação de três partes de tabelas (qualificador.proprietário.nome). No SQL Server 2008, esta coluna representa o nome do banco de dados. Em outros produtos, representa o nome do servidor do ambiente de banco de dados da tabela. Este campo pode ser NULL.

TABLE_SCHEM

sysname

Nome do proprietário da tabela. No SQL Server, esta coluna representa o nome do usuário de banco de dados que criou a tabela. Este campo sempre retorna um valor.

TABLE_NAME

sysname

Nome da tabela. Este campo sempre retorna um valor.

TABLE_TYPE

varchar(32)

Tabela, tabela do sistema ou exibição.

REMARKS

varchar(254)

SQL Server não retorna um valor para esta coluna.

Comentários

sp_primarykeys é executado consultando o conjunto de linhas TABLES da interface IDBSchemaRowset do provedor OLE DB correspondente a table_server. Os parâmetros table_name, table_schema, table_catalog e column são passados a essa interface para restringir as linhas retornadas.

sp_tables_ex retorna um conjunto de resultados vazio se o provedor OLE DB do servidor vinculado especificado não oferecer suporte ao conjunto de linhas TABLES da interface IDBSchemaRowset.

Permissões

Requer a permissão SELECT no esquema.

Exemplos

O exemplo a seguir retorna informações sobre as tabelas que estão contidas no esquema HumanResources do banco de dados AdventureWorks do servidor vinculado LONDON2.

EXEC sp_tables_ex @table_server = 'LONDON2', 
@table_catalog = 'AdventureWorks', 
@table_schema = 'HumanResources', 
@table_type = 'TABLE'