PARSENAME(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

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

참고

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

Transact-SQL 구문 표기 규칙

Syntax

PARSENAME ('object_name' , object_piece )

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

'object_name' 지정된 개체 부분을 검색할 개체의 이름을 보관하는 매개 변수입니다. 이 매개 변수는 선택적으로 한정된 개체 이름입니다. 개체 이름의 모든 부분이 정규화된 경우 이 이름은 서버 이름, 데이터베이스 이름, 스키마 이름, 개체 이름의 네 부분으로 이루어질 수 있습니다. 'object_name' 문자열의 각 부분은 nvarchar(128) 또는 256 바이트와 동일한 sysname 형식입니다. 문자열에 256바이트를 초과하는 부분이 있는 경우 유효한 sysname이 아니므로 PARSENAME은 해당 부분에 대해 NULL을 반환합니다.

object_piece
반환할 개체 부분입니다. object_piece는 int 형식이며 다음과 같은 값을 가질 수 있습니다.
1 = 개체 이름
2 = 스키마 이름
3 = 데이터베이스 이름
4 = 서버 이름

반환 형식

sysname

설명

다음 조건 중 하나가 만족되면 PARSENAME이 NULL을 반환합니다.

  • object_name 또는 object_piece가 NULL입니다.

  • 구문 오류가 발생합니다.

요청한 개체 부분의 길이가 0이고 잘못된 Microsoft SQL Server 식별자입니다. 길이가 0인 개체 이름은 한정된 이름 전체를 올바르지 않은 이름으로 렌더링합니다.

예제

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

-- Uses AdventureWorks  
  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 1) AS 'Object Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 2) AS 'Schema Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 3) AS 'Database Name';  
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 4) AS 'Server Name';  
GO

결과 집합은 다음과 같습니다.

Object Name
------------------------------
DimCustomer

(1 row(s) affected)

Schema Name
------------------------------
dbo

(1 row(s) affected)

Database Name
------------------------------
AdventureWorksPDW2012

(1 row(s) affected)

Server Name
------------------------------
(null)

(1 row(s) affected)

참고 항목