适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
返回对象名称的指定部分。 可检索的对象部分包括对象名称、架构名称、数据库名称和服务器名称。
PARSENAME 不指示指定名称的对象是否存在。 PARSENAME 仅返回指定对象名称的指定部分。
语法
PARSENAME ('object_name' , object_piece )
参数
'object_name'
保存要为其检索指定对象部件的对象的名称的参数。 此参数是可选的限定对象名称。 如果对象名称的所有部分都是限定的，则此名称可包含四部分：服务器名称、数据库名称、架构名称以及对象名称。
“object_name”字符串的每个部分都是 sysname，相当于 nvarchar（128） 或 256 个字节。 如果字符串的任何部分超过 256 个字节， PARSENAME NULL 则返回该部分，因为它不是有效的 sysname。
object_piece
要返回的对象部件。 object_piece为 int，可以是以下值之一：
| 值 | 说明 |
|---|---|
| 1 | Object name |
| 2 | 架构名称 |
| 3 | 数据库名称 |
| 4 | 服务器名称 |
返回类型
sysname
注解
PARSENAMENULL如果下列条件之一为 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)