Share via

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 个字节， PARSENAMENULL 则返回该部分，因为它不是有效的 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)

相关内容