Megosztás a következőn keresztül:


PARSENAME (Transact-SQL)

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

Visszaadja az objektum nevének megadott részét. Az objektum lekérhető részei az objektum neve, séma neve, adatbázis neve és szerver neve.

PARSENAME nem jelzi, hogy létezik-e egy meghatározott névű objektum. PARSENAME csak a megadott objektumnév megadott részét adja vissza.

Transact-SQL szintaxis konvenciók

Szemantika

PARSENAME ('object_name' , object_piece )

Arguments

'object_name'

Az a paraméter, amely tartalmazza annak az objektumnak a nevét, amelyhez a megadott objektum rész visszahívása szükséges. Ez a paraméter opcionálisan minősített objektumnév. Ha az objektum nevének minden része minősített, ez a név négy részből állhat: a szerver neve, az adatbázis neve, a séma neve és az objektum neve.

A 'object_name' húr minden része sysname, ami megfelel a nvarchar(128) vagy 256 bájtnak. Ha a string bármely része meghaladja a 256 bájtot, PARSENAME akkor NULL visszatér az adott részre, mivel nem érvényes rendszernév.

object_piece

A vissza kell térni a tárgy részt. object_pieceint, és lehet az alábbi értékek egyike:

Érték Description
1 Objektum neve
2 Séma neve
3 Adatbázis neve
4 Kiszolgáló neve

Visszatérési típusok

sysname

Megjegyzések

PARSENAME akkor tér vissza NULL , ha az alábbi feltételek egyike igaz:

  • Vagy object_name, vagy object_piece .NULL

  • Szintaktishiba jelentkezik.

  • A kért objektum rész hossza van, 0 és nem érvényes SQL Server azonosító. Egy nulla hosszúságú objektumnév a teljes minősített nevet nem érvényessé teszi.

Példák

A következő példa PARSENAME az adatbázisban található Person tábláról AdventureWorks2025 szóló információk visszaküldésére szolgál.

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

Itt van az eredmények összessége.

Object Name
------------------------------
Person

Schema Name
------------------------------
Person

Database Name
------------------------------
AdventureWorks2022

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