sp_tables (Transact-SQL)

Aplica-se a:SQL Server Base de Dados SQL do Azure Instância Gerida do Azure SQL Azure Synapse Analytics Sistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft Fabric Armazém no Microsoft Fabric Base de Dados SQL no Microsoft Fabric

Devolve uma lista de objetos que podem ser consultados no ambiente atual. Isto significa qualquer tabela ou vista, exceto objetos sinónimos.

Observação

Para determinar o nome do objeto base de um sinónimo, consulte a vista de catálogo sys.synonyms .

Transact-SQL convenções de sintaxe

Sintaxe

Syntax for SQL Server, Azure SQL Database, Azure Synapse Analytics, Analytics Platform System (PDW):

sp_tables
    [ [ @table_name = ] N'table_name' ]
    [ , [ @table_owner = ] N'table_owner' ]
    [ , [ @table_qualifier = ] N'table_qualifier' ]
    [ , [ @table_type = ] 'table_type' ]
    [ , [ @fUsePattern = ] fUsePattern ]
[ ; ]

Arguments

[ @table_name = ] N'table_name'

A tabela usada para devolver a informação do catálogo. @table_name é nvarchar(384), com um padrão de NULL. É suportada a correspondência de padrões wildcard.

[ @table_owner = ] N'table_owner'

O proprietário da mesa era usado para devolver a informação do catálogo. @table_owner é nvarchar(384), com um padrão de NULL. É suportada a correspondência de padrões wildcard. Se o proprietário não for especificado, aplicam-se as regras padrão de visibilidade da tabela do SGBD subjacente.

No SQL Server, se o utilizador atual possuir uma tabela com o nome especificado, as colunas dessa tabela são devolvidas. Se o proprietário não for especificado e o utilizador atual não possuir uma tabela com o nome especificado, este procedimento procura uma tabela com o nome especificado pertencente ao proprietário da base de dados. Se existir, as colunas dessa tabela são devolvidas.

[ @table_qualifier = ] N'table_qualifier'

O nome do qualificador da tabela. @table_qualifier é sysname, com um padrão de NULL. Vários produtos SGBD suportam a nomenclatura em três partes para tabelas (<qualifier>.<owner>.<name>). No SQL Server, esta coluna representa o nome da base de dados. Em alguns produtos, representa o nome do servidor do ambiente de base de dados da tabela.

[ @table_type = ] 'table_type'

Uma lista de valores, separados por vírgulas, que fornece informação sobre todas as tabelas dos tipos de tabela especificados. Estes incluem TABLE, SYSTEMTABLE, e VIEW. @table_type é varchar(100), com um padrão de NULL.

Aspas simples devem envolver cada tipo de tabela, e aspas duplas devem abranger todo o parâmetro. Os tipos de tabela devem ser maiúsculos. Se SET QUOTED_IDENTIFIER for ON, cada aspas simples deve ser duplicada e todo o parâmetro deve ser incluído em aspas simples.

[ @fUsePattern = ] fUsePattern

Determina se os caracteres sublinhado (_), percent (%) e parênteses ([ ou ]) são interpretados como caracteres curinga. Os valores válidos são 0 (a correspondência de padrões está desligada) e 1 (a correspondência de padrões está ativada). @fUsePattern é bit, com um padrão de 1.

Valores de código de retorno

Nenhum.

Conjunto de resultados

Nome da coluna	Tipo de dados	Description
`TABLE_QUALIFIER`	sysname	Nome do qualificador da tabela. No SQL Server, esta coluna representa o nome da base de dados. Este campo pode ser `NULL`.
`TABLE_OWNER`	sysname	Nome do dono da mesa. No SQL Server, esta coluna representa o nome do utilizador da base de dados que criou a tabela. Este campo devolve sempre um valor.
`TABLE_NAME`	sysname	Nome da tabela. Este campo devolve sempre um valor.
`TABLE_TYPE`	varchar(32)	Tabela, tabela do sistema ou vista.
`REMARKS`	Varchar (254)	O SQL Server não devolve um valor para esta coluna.

Observações

Para máxima interoperabilidade, o cliente gateway deve assumir apenas correspondência de padrões SQL padrão SQL-92 (os caracteres curinga % e _).

A informação de privilégios sobre o acesso de leitura ou escrita do utilizador atual a uma tabela específica nem sempre é verificada. Portanto, o acesso não é garantido. Este conjunto de resultados inclui não só tabelas e vistas, mas também sinónimos e pseudónimos para gateways de produtos DBMS que suportam esses tipos. Se o atributo ACCESSIBLE_TABLES do servidor for Y no conjunto de resultados para sp_server_info, apenas as tabelas que podem ser acedidas pelo utilizador atual são devolvidas.

sp_tables é equivalente a SQLTables em ODBC. Os resultados devolvidos estão ordenados por TABLE_TYPE, TABLE_QUALIFIER, TABLE_OWNER, e TABLE_NAME.

Permissions

A visibilidade dos metadados nas visualizações de catálogo é limitada aos itens de segurança que um utilizador possui ou nos quais o utilizador recebeu alguma permissão. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Examples

A. Devolva uma lista de objetos que podem ser consultados no ambiente atual

O exemplo seguinte devolve uma lista de objetos que podem ser consultas no ambiente atual.

EXECUTE sp_tables;

B. Devolver informação sobre as tabelas num esquema especificado

O exemplo seguinte devolve informações sobre as tabelas que pertencem ao Person esquema na base de dados AdventureWorks2025.

USE AdventureWorks2022;
GO

EXECUTE sp_tables
    @table_name = '%',
    @table_owner = 'Person',
    @table_qualifier = 'AdventureWorks2022';

Exemplos: Azure Synapse Analytics and Analytics Platform System (PDW)

C. Devolva uma lista de objetos que podem ser consultados no ambiente atual