다음을 통해 공유


PARSENAME(Transact-SQL)

개체 이름에서 지정된 부분을 반환합니다. 검색 가능한 개체의 부분은 개체 이름, 소유자 이름, 데이터베이스 이름 및 서버 이름입니다.

참고

PARSENAME 함수는 지정된 이름의 개체가 있는지 여부를 나타내지 않으며지정된 개체 이름에서 지정된 부분만 반환합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

적용 대상: SQL Server(SQL Server 2012 - current version), Windows Azure 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 식별자입니다. 길이가 0인 개체 이름은 한정된 이름 전체를 올바르지 않은 이름으로 렌더링합니다.

다음 예에서는 PARSENAME을 사용하여 AdventureWorks2012 데이터베이스의 Person 테이블에 대한 정보를 반환합니다.

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)