PARSENAME (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Gibt den angegebenen Teil eines Objektnamens zurück. Die Teile eines Objekts, die abgerufen werden können, sind der Objektname, der Schemaname, der Datenbankname und der Servername.

Hinweis

Die PARSENAME-Funktion zeigt nicht an, ob ein Objekt mit dem angegebenen Namen vorhanden ist. PARSENAME gibt lediglich den angegebenen Teil des gegebenen Objektnamens zurück.

Transact-SQL-Syntaxkonventionen

Syntax

PARSENAME ('object_name' , object_piece )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

'object_name' ist der Parameter, der den Namen des Objekts beinhaltet, für das der angegebene Objektteil abgerufen werden soll. Dieser Parameter ist ein optional gekennzeichneter Objektname. Wenn alle Teile des Objektnamens gekennzeichnet sind, besteht dieser Name aus vier Teilen: dem Server-, Datenbank, Schema- und Objektnamen. Jeder Teil der Zeichenfolge 'object_name' ist vom Typ sysname, was nvarchar(128) oder 256 Byte entspricht. Wenn ein beliebiger Teil der Zeichenfolge 256 Byte überschreitet, gibt PARSENAME NULL für diesen Teil zurück, da es sich nicht um einen gültigen sysname-Typ handelt.

object_piece
Der Objektteil, der zurückgegeben werden soll. object_piece ist vom Datentyp int und kann folgende Werte haben:
1 = Objektname
2 = Schemaname
3 = Datenbankname
4 = Servername

Rückgabetyp

sysname

Bemerkungen

PARSENAME gibt NULL zurück, wenn eine der folgenden Bedingungen wahr ist:

  • Entweder für object_name oder für object_piece wird NULL zurückgegeben.

  • Ein Syntaxfehler tritt auf.

Der angeforderte Objektteil hat eine Länge von 0 und ist kein gültiger Microsoft SQL Server-Bezeichner. Ein Objektname mit der Länge 0 macht den gesamten qualifizierten Namen ungültig.

Beispiele

Im folgenden Beispiel wird PARSENAME verwendet, um Informationen zur Person-Tabelle in der AdventureWorks2022-Datenbank zurückzugeben.

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

Hier ist das Resultset.

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)

Weitere Informationen