PARSENAME (Transact-SQL)
返回对象名称的指定部分。 可检索的对象部分包括对象名称、所有者名称、数据库名称和服务器名称。
备注
PARSENAME 函数不指示指定名称的对象是否存在。PARSENAME 仅返回指定对象名称的指定部分。
适用范围:SQL Server(SQL Server 2012 至当前版本),Windows Azure SQL Database(初始版本至当前版本)。 |
语法
PARSENAME ( 'object_name' , object_piece )
参数
'object_name'
要检索其指定部分的对象的名称。 object_name 的数据类型为 sysname。 此参数是可选的限定对象名称。 如果对象名称的所有部分都是限定的,则此名称可包含四部分:服务器名称、数据库名称、所有者名称以及对象名称。object_piece
要返回的对象部分。 object_piece 的数据类型为 int,可以为下列值:1 = 对象名称
2 = 架构名称
3 = 数据库名称
4 = 服务器名称
返回类型
nchar
注释
如果存在下列条件之一,则 PARSENAME 返回 NULL:
object_name 或 object_piece 为 NULL。
发生语法错误。
请求的对象部分长度为 0,且不是有效的 Microsoft SQL Server 标识符。 长度为零的对象的名称将使整个限定名称无效。
示例
以下示例使用 PARSENAME 返回有关 AdventureWorks2012 数据库中 Person 表的信息。
USE AdventureWorks2012;
SELECT PARSENAME('AdventureWorks2012..Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2012..Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2012..Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2012..Person', 4) AS 'Server Name';
GO
下面是结果集:
Object Name
------------------------------
Person
(1 row(s) affected)
Schema Name
------------------------------
(null)
(1 row(s) affected)
Database Name
------------------------------
AdventureWorks2012
(1 row(s) affected)
Server Name
------------------------------
(null)
(1 row(s) affected)