sp_tables_ex (Transact-SQL)
Retorna as informações de tabela sobre as tabelas do servidor vinculado especificado.
Convenções da 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 de tabela. table_schema é sysname, com um padrão NULL.[ @table_catalog= ] 'table_catalog'
É o nome do banco de dados no qual a table_name especificada reside. table_catalog é sysname, com o padrão de NULL.[ @table_type= ] 'table_type'
É o tipo da tabela a ser retornada. table_type é sysname, com o padrão de 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. Os valores válidos são 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 DBMS dão suporte à nomenclatura de três partes de tabelas (qualifier.owner.name). No SQL Server, essa coluna representa o nome do banco de dados. Em outros produtos, ela 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 AdventureWorks2012 do servidor vinculado LONDON2.
EXEC sp_tables_ex @table_server = 'LONDON2',
@table_catalog = 'AdventureWorks2012',
@table_schema = 'HumanResources',
@table_type = 'TABLE';
Consulte também
Referência
Procedimentos armazenados de consultas distribuídas (Transact-SQL)
sp_column_privileges (Transact-SQL)
sp_linkedservers (Transact-SQL)