Share via

PARSENAME(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)

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

PARSENAME 는 지정된 이름의 개체가 있는지 여부를 나타내지 않습니다. 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바이트를 PARSENAME 초과하면 유효한 sysname이 아니으므로 해당 부분에 대해 반환 NULL 됩니다.

object_piece

반환할 개체 부분입니다. object_piece int이며 다음 값 중 하나일 수 있습니다.

값 Description
1 Object name
2 스키마 이름
3 데이터베이스 이름
4 서버 이름

반환 형식

sysname

설명

PARSENAME 는 다음 조건 중 하나가 true이면 반환 NULL 됩니다.

  • object_name 또는 object_piece .NULL

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

  • 요청된 개체 파트의 0 길이가 유효한 SQL Server 식별자가 아닙니다. 길이가 0인 개체 이름은 한정된 이름 전체를 올바르지 않은 이름으로 렌더링합니다.

예제

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

-- 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)

관련 콘텐츠