Поделиться через


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 для получения информации о таблице Person в базе данных AdventureWorks2008R2.

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)