적용 대상:
SQL 서버Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics분석 플랫폼 시스템(PDW)Microsoft Fabric의 SQL 데이터베이스
개체 이름에서 지정된 부분을 반환합니다. 검색 가능한 개체의 부분은 개체 이름, 스키마 이름, 데이터베이스 이름 및 서버 이름입니다.
PARSENAME 는 지정된 이름의 개체가 있는지 여부를 나타내지 않습니다.
PARSENAME 은 지정된 개체 이름의 지정된 부분을 반환합니다.
구문
PARSENAME ('object_name' , object_piece )
인수
'object_name'
지정된 개체 부분을 검색할 개체의 이름을 보유하는 매개 변수입니다. 이 매개 변수는 선택적으로 정규화된 개체 이름입니다. 개체 이름의 모든 부분이 정규화된 경우 이 이름은 서버 이름, 데이터베이스 이름, 스키마 이름, 개체 이름의 네 부분으로 이루어질 수 있습니다.
'object_name' 문자열의 각 부분은 nvarchar(128) 또는 256바이트와 동일한 sysname입니다. 문자열의 일부가 256바이트를 PARSENAME 초과하면 유효한 NULL이 아니으므로 해당 부분에 대해 반환 됩니다.
object_piece
반환할 개체 부분입니다. object_piece int이며 다음 값 중 하나일 수 있습니다.
| 값 | Description |
|---|---|
| 1 | 개체 이름 |
| 2 | 스키마 이름 |
| 3 | 데이터베이스 이름 |
| 4 | 서버 이름 |
반환 형식
sysname
설명
PARSENAME 는 다음 조건 중 하나가 true이면 반환 NULL 됩니다.
object_name 또는 object_piece .
NULL구문 오류가 발생합니다.
요청된 개체 파트의
0길이가 유효한 SQL Server 식별자가 아닙니다. 길이가 0인 개체 이름은 한정된 이름 전체를 올바르지 않은 이름으로 렌더링합니다.
예제
다음 예에서는 PARSENAME을 사용하여 Person 데이터베이스의 AdventureWorks2025 테이블에 대한 정보를 반환합니다.
-- Uses AdventureWorks
SELECT PARSENAME('AdventureWorks2022.Person.Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 4) AS 'Server Name';
GO
결과 집합은 다음과 같습니다.
Object Name
------------------------------
Person
Schema Name
------------------------------
Person
Database Name
------------------------------
AdventureWorks2022
Server Name
------------------------------
(null)