PARSENAME (Transact-SQL)PARSENAME (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2012)ouiAzure SQL DatabaseouiAzure SQL Data Warehouse ouiParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2012)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Retourne la partie spécifiée d'un nom d'objet.Returns the specified part of an object name. Les parties d'un objet pouvant être récupérées sont le nom de l'objet, le nom du propriétaire, le nom de la base de données et le nom du serveur.The parts of an object that can be retrieved are the object name, owner name, database name, and server name.

Note

La fonction PARSENAME n'indique pas s'il existe déjà un objet portant le nom spécifié.The PARSENAME function does not indicate whether an object by the specified name exists. Elle se limite à retourner la partie indiquée du nom d'objet spécifié.PARSENAME just returns the specified part of the specified object name.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

PARSENAME ( 'object_name' , object_piece )   

ArgumentsArguments

'nom_objet''object_name'
Nom de l'objet contenant la partie d'objet spécifiée à extraire.Is the name of the object for which to retrieve the specified object part. nom_objet est sysname.object_name is sysname. Ce paramètre représente un nom d'objet éventuellement qualifié.This parameter is an optionally-qualified object name. Si toutes les parties du nom de l'objet sont qualifiées, ce nom peut se composer de quatre parties : le nom du serveur, le nom de la base de données, le nom du propriétaire et le nom de l'objet.If all parts of the object name are qualified, this name can have four parts: the server name, the database name, the owner name, and the object name.

object_pieceobject_piece
Partie de l'objet à retourner.Is the object part to return. object_piece est de type intet peut prendre les valeurs suivantes :object_piece is of type int, and can have these values:

1 = Nom de l'objet1 = Object name

2 = Nom du schéma2 = Schema name

3 = Nom de la base de données3 = Database name

4 = Nom du serveur4 = Server name

Types de retourReturn Types

ncharnchar

NotesRemarks

La fonction PARSENAME retourne NULL si l'une des conditions suivantes est vraie :PARSENAME returns NULL if one of the following conditions is true:

  • Soit nom_objet ou object_piece a la valeur NULL.Either object_name or object_piece is NULL.

  • une erreur de syntaxe s'est produite.A syntax error occurs.

    La partie d’objet recherchée a une longueur de 0 et n’est pas valide MicrosoftMicrosoft SQL ServerSQL Server identificateur.The requested object part has a length of 0 and is not a valid MicrosoftMicrosoft SQL ServerSQL Server identifier. Un nom d'objet d'une longueur égale à 0 invalide la totalité du nom qualifié.A zero-length object name renders the complete qualified name as not valid.

ExemplesExamples

L'exemple suivant utilise PARSENAME pour retourner des informations sur la table Person de la base de données AdventureWorks2012.The following example uses PARSENAME to return information about the Person table in the AdventureWorks2012 database.

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

Voici l'ensemble des résultats.Here is the result set.

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)

Voir aussiSee Also

ALTER TABLE (Transact-SQL) ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL) CREATE TABLE (Transact-SQL)
Fonctions système ( Transact-SQL )System Functions (Transact-SQL)