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

SE APLICA A: síSQL Server (a partir de 2012) síAzure SQL Database síAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (starting with 2012) yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Devuelve la parte especificada de un nombre de objeto.Returns the specified part of an object name. Las partes de un objeto que se pueden recuperar son el nombre del objeto, nombre del propietario, nombre de la base de datos y nombre del servidor.The parts of an object that can be retrieved are the object name, owner name, database name, and server name.

Nota

La función PARSENAME no indica si existe un objeto con el nombre especificado.The PARSENAME function does not indicate whether an object by the specified name exists. PARSENAME solo devuelve la parte especificada del nombre de objeto especificado.PARSENAME just returns the specified part of the specified object name.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

PARSENAME ( 'object_name' , object_piece )   

ArgumentosArguments

'object_name''object_name'
Es el nombre del objeto del que se desea recuperar la parte de objeto especificada.Is the name of the object for which to retrieve the specified object part. object_name es sysname.object_name is sysname. Este parámetro es un nombre de objeto completo opcionalmente.This parameter is an optionally-qualified object name. Si todas las partes del nombre de objeto están completas, este nombre puede tener cuatro partes: el nombre del servidor, de la base de datos, del propietario y del propio objeto.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
Es la parte del objeto que se va a devolver.Is the object part to return. object_piece es de tipo int y puede tener los valores siguientes:object_piece is of type int, and can have these values:

1 = Nombre del objeto1 = Object name

2 = Nombre del esquema2 = Schema name

3 = Nombre de la base de datos3 = Database name

4 = Nombre del servidor4 = Server name

Tipos devueltosReturn Types

sysnamesysname

NotasRemarks

PARSENAME devuelve NULL cuando se cumple una de las siguientes condiciones:PARSENAME returns NULL if one of the following conditions is true:

  • Tanto object_name como object_piece son NULL.Either object_name or object_piece is NULL.

  • Se produce un error de sintaxis.A syntax error occurs.

La parte del objeto solicitada tiene una longitud 0 y no es un identificador MicrosoftMicrosoft SQL ServerSQL Server válido.The requested object part has a length of 0 and is not a valid MicrosoftMicrosoft SQL ServerSQL Server identifier. Un nombre de objeto de longitud cero hace que el nombre completo no sea válido.A zero-length object name renders the complete qualified name as not valid.

EjemplosExamples

En el siguiente ejemplo se utiliza PARSENAME para devolver información acerca de la tabla Person de la base de datos 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  

El conjunto de resultados es el siguiente.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)

Consulte tambiénSee Also

QUOTENAME (Transact-SQL)QUOTENAME (Transact-SQL)
ALTER TABLE (Transact-SQL) ALTER TABLE (Transact-SQL)
CREATE TABLE (Transact-SQL) CREATE TABLE (Transact-SQL)
Funciones del sistema (Transact-SQL)System Functions (Transact-SQL)