sp_tables (Transact-SQL)
更新日期: 2006 年 12 月 12 日
返回可在当前环境中查询的对象列表。也就是说,返回任何能够在 FROM 子句中出现的对象(不包括同义词对象)。
注意: |
---|
若要确定同义词的基对象名称,请查询 sys.synonyms 目录视图。 |
语法
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'" ]
由逗号分隔的值列表,该列表提供有关所有指定的表类型的表的信息。这些类型包括 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. 返回有关 AdventureWorks 中的表的信息
以下示例返回有关 AdventureWorks
数据库中的 Person
架构所拥有的表的信息。
USE AdventureWorks;
GO
EXEC sp_tables
@table_name = '%',
@table_owner = 'Person',
@table_qualifier = 'AdventureWorks';
请参阅
参考
目录存储过程 (Transact-SQL)
系统存储过程 (Transact-SQL)
帮助和信息
更改历史记录
发布日期 | 历史记录 |
---|---|
2006 年 12 月 12 日 |
|