PARSENAME (Transact-SQL)

返回对象名称的指定部分。可以检索的对象部分有对象名、所有者名称、数据库名称和服务器名称。

注意注意

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

主题链接图标Transact-SQL 语法约定

语法

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 返回有关 AdventureWorks2008R2 数据库中 Person 表的信息。

USE AdventureWorks2008R2;
SELECT PARSENAME('AdventureWorks2008R2..Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2008R2..Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2008R2..Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2008R2..Person', 4) AS 'Server Name';
GO

下面是结果集:

Object Name

------------------------------

Person

(1 row(s) affected)

Schema Name

------------------------------

(null)

(1 row(s) affected)

Database Name

------------------------------

AdventureWorks2008R2

(1 row(s) affected)

Server Name

------------------------------

(null)

(1 row(s) affected)