PARSENAME (Transact-SQL)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Restituisce la parte specificata del nome di un oggetto. Le parti di un oggetto che è possibile recuperare sono il nome dell'oggetto, il nome dello schema, il nome del database e il nome del server.

Nota

La funzione PARSENAME non indica se esiste un oggetto avente il nome specificato. PARSENAME restituisce solo la parte specificata del nome di oggetto specificato.

Convenzioni di sintassi Transact-SQL

Sintassi

PARSENAME ('object_name' , object_piece )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

'object_name' è il parametro che contiene il nome dell'oggetto per cui recuperare la parte specificata. Questo parametro rappresenta un nome di oggetto che può essere qualificato facoltativamente. Se vengono qualificate tutte le parti del nome dell'oggetto, il nome può essere costituito da quattro parti, ovvero nome del server, nome del database, nome dello schema e nome dell'oggetto. Ogni parte della stringa 'object_name' è di tipo sysname che equivale a nvarchar(128) o a 256 byte. Se una parte della stringa supera i 256 byte, PARSENAME restituirà NULL per tale parte perché non è un valore sysname valido.

object_piece
Parte dell'oggetto da restituire. object_piece è di tipo int. I possibili valori sono i seguenti:
1 = nome dell'oggetto
2 = nome dello schema
3 = nome del database
4 = nome del server

Tipo restituito

sysname

Osservazioni:

PARSENAME restituisce NULL se si verifica una delle condizioni seguenti:

  • object_name o object_piece è NULL.

  • Si verifica un errore di sintassi.

La lunghezza della parte dell'oggetto richiesta è uguale a 0 e la parte dell'oggetto non è un identificatore di Microsoft SQL Server valido. Se la lunghezza del nome dell'oggetto è pari a 0, il nome completo risulta non valido.

Esempi

Nell'esempio seguente viene utilizzato PARSENAME per restituire informazioni sulla tabella Person nel database AdventureWorks2022.

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

Questo è il set di risultati.

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)

Vedi anche