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


PARSENAME (Transact-SQL)

Возвращает указанную часть имени объекта. Части объекта, к которым можно получить доступ: имя объекта, имя владельца, имя базы данных и имя сервера.

Примечание

Функция PARSENAME не показывает, существует ли на самом деле объект с данным именем.PARSENAME возвращает всего лишь указанную часть имени объекта.

Значок ссылки на раздел Cинтаксические обозначения в Transact-SQL

Применимо для следующих объектов: SQL Server (SQL Server 2012 по текущую версию), База данных SQL Windows Azure (С первоначального выпуска по текущий выпуск).

Синтаксис

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 в базе данных AdventureWorks2012.

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

Ниже приводится результирующий набор.

Object Name

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

Person

(1 row(s) affected)

Schema Name

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

(null)

(1 row(s) affected)

Database Name

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

AdventureWorks2012

(1 row(s) affected)

Server Name

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

(null)

(1 row(s) affected)

См. также

Справочник

ALTER TABLE (Transact-SQL)

CREATE TABLE (SQL Server)

Системные функции (Transact-SQL)