PARSENAME (Transact-SQL)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für