PARSENAME(Transact-SQL)

  • 아티클

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

[!참고]

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 식별자입니다. 길이가 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(Transact-SQL)

시스템 함수(Transact-SQL)