通过

  • 项目

sp_tables (Transact-SQL)

返回可在当前环境中查询的对象列表。也就是说，返回任何用户表、系统表或视图（不包括同义词对象）。

注意注意

若要确定同义词的基对象名称，请查询 sys.synonyms 目录视图。

主题链接图标Transact-SQL 语法约定

语法

sp_tables [ [ @table_name = ] 'name' ] 
     [ , [ @table_owner = ] 'owner' ] 
     [ , [ @table_qualifier = ] 'qualifier' ] 
     [ , [ @table_type = ] "type" ] 
     [ , [@fUsePattern = ] 'fUsePattern'];

参数

  • [ @table_name= ] 'name'
    用于返回目录信息的表或视图。name 的数据类型为 nvarchar(384)，默认值为 NULL。支持通配符模式匹配。

  • [ @table_owner= ] 'owner'
    用于返回目录信息的表的所有者。owner 的数据类型为 nvarchar(384)，默认值为 NULL。支持通配符模式匹配。如果未指定所有者，则遵循基础 DBMS 的默认表可见性规则。

    在 SQL Server 中，如果当前用户拥有一个具有指定名称的表，则返回该表的列。如果未指定所有者，且当前用户未拥有指定名称的表，则该过程查找由数据库所有者拥有的具有指定名称的表。如果有，则返回该表的列。

  • [ @table_qualifier= ] 'qualifier'
    表限定符的名称。qualifier 的数据类型为 sysname，默认值为 NULL。许多 DBMS 产品都支持表的三部分构成命名方式 (qualifier**.owner.**name)。在 SQL Server 中，此列表示数据库名称。在某些产品中，此列表示表所在的数据库环境的服务器名称。

  • [ , [ @table_type= ] "'type', 'type'" ]
    由逗号分隔的值列表，该列表提供有关所有指定的表类型的表的信息。这些类型包括 TABLE、SYSTEMTABLE 和 VIEW。type 的数据类型为 varchar(100)，默认值为 NULL。

    注意注意

    每个表类型都必须用单引号引起来，整个参数必须用双引号引起来。表类型必须大写。如果 SET QUOTED_IDENTIFIER 为 ON，则每个单引号必须换成双引号，整个参数必须用单引号引起来。

  • [ @fUsePattern = ] 'fUsePattern'
    确定下划线 (_)、百分号 (%) 和方括号（[ 或 ]）是否解释为通配符。有效值为 0（模式匹配为关闭状态）和 1（模式匹配为打开状态）。fUsePattern 的数据类型为 bit，默认值为 1。

返回代码值

无

结果集

列名

数据类型

说明

TABLE_QUALIFIER

sysname

表限定符名称。在 SQL Server 中，此列表示数据库名称。该字段可以为 NULL。

TABLE_OWNER

sysname

表所有者名称。在 SQL Server 中，此列表示创建该表的数据库用户的名称。该字段始终返回值。

TABLE_NAME

sysname

表名。该字段始终返回值。

TABLE_TYPE

varchar(32)

表、系统表或视图。

REMARKS

varchar(254)

SQL Server 不为此列返回值。

注释

为达到最大互操作性，网关客户端应假定只有 SQL-92 标准的 SQL 模式匹配（% 和 _ 通配符字符）。

并不总是检查有关当前用户对特定表的读写权限的权限信息。因此，访问得不到保障。该结果集不仅包含表和视图，还包含网关的同名和别名，这些网关通往支持这些类型的 DBMS 产品。如果在 sp_server_info 的结果集中，服务器属性 ACCESSIBLE_TABLES 为 Y，则只返回当前用户可访问的表。

sp_tables 等价于 ODBC 中的 SQLTables。返回的结果按 TABLE_TYPE、TABLE_QUALIFIER、TABLE_OWNER 和 TABLE_NAME 顺序排列。

权限

需要对架构的 SELECT 权限。

示例

A. 返回可在当前环境中查询的对象列表

以下示例返回可在当前环境中查询的对象列表。

EXEC sp_tables ;

B. 返回有关某一数据库中的表的信息

以下示例返回有关 AdventureWorks2008R2 数据库中的 Person 架构所拥有的表的信息。

USE AdventureWorks2008R2;
GO
EXEC sp_tables 
   @table_name = '%',
   @table_owner = 'Person',
   @table_qualifier = 'AdventureWorks2008R2';