PARSENAME (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

返回对象名称的指定部分。 可检索的对象部分包括对象名称、架构名称、数据库名称和服务器名称。

注意

PARSENAME 函数不指示指定名称的对象是否存在。 PARSENAME 仅返回指定对象名称的指定部分。

Transact-SQL 语法约定

语法

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 = 对象名称
2 = 架构名称
3 = 数据库名称
4 = 服务器名称

返回类型

sysname

备注

如果存在下列条件之一，则 PARSENAME 返回 NULL：

  • object_name 或 object_piece 为 NULL 。

  • 发生语法错误。

请求的对象部分长度为 0，且不是有效的 Microsoft SQL Server 标识符。 长度为零的对象的名称将使整个限定名称无效。

示例

以下示例使用 PARSENAME 返回有关 Person 数据库中 AdventureWorks2022 表的信息。

-- Uses AdventureWorks  
  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 1) AS 'Object Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 2) AS 'Schema Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 3) AS 'Database Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 4) AS 'Server Name';  
GO

下面是结果集。

Object Name
------------------------------
DimCustomer

(1 row(s) affected)

Schema Name
------------------------------
dbo

(1 row(s) affected)

Database Name
------------------------------
AdventureWorksPDW2012

(1 row(s) affected)

Server Name
------------------------------
(null)

(1 row(s) affected)

另请参阅