sp_tables (Transact-SQL)

更新日期: 2006 年 12 月 12 日

返回可在当前环境中查询的对象列表。也就是说,返回任何能够在 FROM 子句中出现的对象(不包括同义词对象)。

ms186250.note(zh-cn,SQL.90).gif注意:
若要确定同义词的基对象名称,请查询 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'" ]
    由逗号分隔的值列表,该列表提供有关所有指定的表类型的表的信息。这些类型包括 TABLESYSTEMTABLEVIEWtype 的数据类型为 varchar(100),默认值为 NULL。

    ms186250.note(zh-cn,SQL.90).gif注意:
    每个表类型都必须用单引号括起来,整个参数必须用双引号括起来。表类型必须大写。如果 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_TYPETABLE_QUALIFIERTABLE_OWNERTABLE_NAME 顺序排列。

权限

需要对架构的 SELECT 权限。

示例

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

若要返回可在当前环境中查询的对象列表,请执行:

EXEC sp_tables ;

B. 返回有关 AdventureWorks 中的表的信息

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

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

请参阅

参考

目录存储过程 (Transact-SQL)
系统存储过程 (Transact-SQL)

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期 历史记录

2006 年 12 月 12 日

新增内容:
  • 阐明了 sp_tables 不返回有关同义词对象这一情况。