PARSENAME (Transact-SQL)

Gibt den angegebenen Teil eines Objektnamens zurück. Die Teile eines Objekts, die abgerufen werden können, sind der Objektname, der Besitzername, 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 ) 

Argumente

'object_name'

Der Name des Objekts, für das der angegebene Objektteil abgerufen werden soll. object_name ist vom sysname-Datentyp. Dieser Parameter ist ein optional gekennzeichneter Objektname. Wenn alle Teile des Objektnamens gekennzeichnet sind, besteht dieser Name aus vier Teilen:dem Servernamen, dem Datenbanknamen, dem Besitzernamen und dem Objektnamen.

object_piece

Dies ist der zurückzugebende Objektteil. object_piece ist vom int-Datentyp und kann die folgenden Werte haben.

1 = Objektname

2 = Schemaname

3 = Datenbankname

4 = Servername

Rückgabetypen

nchar

Hinweise

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

• Entweder object_name oder object_piece ist NULL.
• Ein Syntaxfehler tritt auf.

Der angeforderte Objektteil hat eine Länge von 0 und ist kein gültiger Microsoft SQL Server 2005-Bezeichner. Ein Objektname mit der Länge 0 macht den kompletten gekennzeichneten Namen ungültig. Weitere Informationen finden Sie unter Verwenden von Bezeichnern als Objektnamen.

Beispiele

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

USE AdventureWorks;
SELECT PARSENAME('AdventureWorks..Contact', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks..Contact', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks..Contact', 3) AS 'Database Name;'
SELECT PARSENAME('AdventureWorks..Contact', 4) AS 'Server Name';
GO

Dies ist das Resultset. 

Object Name                    
------------------------------ 
Contact                        

(1 row(s) affected)

Schema Name                     
------------------------------ 
(null)                         

(1 row(s) affected)

Database Name                  
------------------------------ 
AdventureWorks                           

(1 row(s) affected)

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

(1 row(s) affected)

Siehe auch

Verweis

ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL)
Systemfunktionen (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005