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

  • 2 minutos para o fim da leitura

Aplica-se a:Applies to: simSQL ServerSQL Server (todas as versões compatíveis) yesSQL ServerSQL Server (all supported versions) SimBanco de Dados SQL do AzureAzure SQL DatabaseYesBanco de Dados SQL do AzureAzure SQL Database SimInstância Gerenciada do Azure SQLAzure SQL Managed InstanceYesInstância Gerenciada do Azure SQLAzure SQL Managed Instance simAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics simParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data WarehouseAplica-se a:Applies to: simSQL ServerSQL Server (todas as versões compatíveis) yesSQL ServerSQL Server (all supported versions) SimBanco de Dados SQL do AzureAzure SQL DatabaseYesBanco de Dados SQL do AzureAzure SQL Database SimInstância Gerenciada do Azure SQLAzure SQL Managed InstanceYesInstância Gerenciada do Azure SQLAzure SQL Managed Instance simAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics simParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse

Retorna a parte especificada de um nome de objeto.Returns the specified part of an object name. As partes de um objeto que podem ser recuperadas são o nome do objeto, o nome do esquema, o nome do banco de dados e o nome do servidor.The parts of an object that can be retrieved are the object name, schema name, database name, and server name.

注意

A função PARSENAME não indica se existe um objeto pelo nome especificado.The PARSENAME function does not indicate whether an object by the specified name exists. PARSENAME apenas retorna a parte especificada do nome de objeto especificado.PARSENAME just returns the specified part of the specified object name.

Ícone de link do tópico Convenções da sintaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

PARSENAME ('object_name' , object_piece )

注意

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

ArgumentosArguments

' object_name ' é o parâmetro que contém o nome do objeto para o qual a parte de objeto especificada deve ser recuperada.'object_name' Is the parameter that holds the name of the object for which to retrieve the specified object part. Este parâmetro é um nome de objeto opcionalmente qualificado.This parameter is an optionally-qualified object name. Se todas as partes do nome do objeto forem qualificadas, esse nome poderá ter quatro partes: o nome do servidor, o nome do banco de dados, o nome do esquema e o nome do objeto.If all parts of the object name are qualified, this name can have four parts: the server name, the database name, the schema name, and the object name. Cada parte da cadeia de caracteres "object_name" é do tipo sysname que é equivalente a nvarchar(128) ou 256 bytes.Each part of the 'object_name' string is type sysname which is equivalent to nvarchar(128) or 256 bytes. Se qualquer parte da cadeia de caracteres exceder 256 bytes, PARSENAME retornará NULL para essa parte, pois não é um sysname válido.If any part of the string exceeds 256 bytes, PARSENAME will return NULL for that part as it is not a valid sysname.

object_pieceobject_piece
É a parte do objeto a ser retornada.Is the object part to return. object_piece é do tipo int e pode ter estes valores:object_piece is of type int, and can have these values:
1 = Nome do objeto1 = Object name
2 = Nome do esquema2 = Schema name
3 = Nome do banco de dados3 = Database name
4 = Nome do servidor4 = Server name

Tipo de retornoReturn Type

sysnamesysname

ComentáriosRemarks

PARSENAME retornará o NULL se uma das seguintes condições for verdadeira:PARSENAME returns NULL if one of the following conditions is true:

  • object_name ou object_piece é NULL.Either object_name or object_piece is NULL.

  • Um erro de sintaxe ocorre.A syntax error occurs.

A parte do objeto solicitada tem um tamanho igual a 0 e não é um identificador do 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. Um nome de objeto de comprimento zero processa o nome qualificado completo como não válido.A zero-length object name renders the complete qualified name as not valid.

ExemplosExamples

O exemplo a seguir usa PARSENAME para retornar informações sobre a tabela Person no banco de dados 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

Este é o conjunto de resultados.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 TambémSee Also