PARSENAME (Transact-SQL)
适用于:SQL Server
Azure SQL 数据库
Azure SQL 托管实例
Azure Synapse Analytics
Analytics Platform System (PDW)
返回对象名称的指定部分。 可检索的对象部分包括对象名称、架构名称、数据库名称和服务器名称。
PARSENAME
不指示指定名称的对象是否存在。 PARSENAME
仅返回指定对象名称的指定部分。
语法
PARSENAME ('object_name' , object_piece )
注意
若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法,请参阅早期版本文档。
参数
'object_name'
保存要为其检索指定对象部件的对象的名称的参数。 此参数是可选的限定对象名称。 如果对象名称的所有部分都是限定的,则此名称可包含四部分:服务器名称、数据库名称、架构名称以及对象名称。
“object_name”字符串的每个部分都是 sysname,相当于 nvarchar(128) 或 256 个字节。 如果字符串的任何部分超过 256 个字节, PARSENAME
NULL
则返回该部分,因为它不是有效的 sysname。
object_piece
要返回的对象部件。 object_piece为 int,可以是以下值之一:
值 | 说明 |
---|---|
1 | Object name |
2 | 架构名称 |
3 | 数据库名称 |
4 | 服务器名称 |
返回类型
sysname
注解
PARSENAME
NULL
如果下列条件之一为 true,则返回:
object_name或object_piece为
NULL
。发生语法错误。
请求的对象部件的长度
0
长度不是有效的 SQL Server 标识符。 长度为零的对象的名称将使整个限定名称无效。
示例
以下示例使用 PARSENAME
返回有关 Person
数据库中 AdventureWorks2022
表的信息。
-- Uses AdventureWorks
SELECT PARSENAME('AdventureWorks2022.Person.Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 4) AS 'Server Name';
GO
下面是结果集:
Object Name
------------------------------
Person
Schema Name
------------------------------
Person
Database Name
------------------------------
AdventureWorks2022
Server Name
------------------------------
(null)