Delen via


PARSENAAM (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database in Microsoft Fabric

Geeft het opgegeven deel van een objectnaam terug. De onderdelen van een object die kunnen worden opgehaald zijn de objectnaam, schemanaam, databasenaam en servernaam.

PARSENAME geeft niet aan of een object met de opgegeven naam bestaat. PARSENAME geeft alleen het gespecificeerde deel van de opgegeven objectnaam terug.

Transact-SQL syntaxis-conventies

Syntaxis

PARSENAME ('object_name' , object_piece )

Arguments

'object_name'

De parameter die de naam bevat van het object waarvoor het opgegeven objectonderdeel moet worden opgehaald. Deze parameter is een optioneel gekwalificeerde objectnaam. Als alle delen van de objectnaam gekwalificeerd zijn, kan deze naam uit vier delen bestaan: de servernaam, de databasenaam, de schemanaam en de objectnaam.

Elk deel van de 'object_name'-string is sysname, wat gelijkstaat aan nvarchar(128) of 256 bytes. Als een deel van de string meer dan 256 bytes is, PARSENAME wordt dat deel teruggegeven NULL , omdat het geen geldige sysnaam is.

object_piece

Het objectgedeelte om terug te geven. object_piece is int, en kan een van deze waarden zijn:

Waarde Description
1 Objectnaam
2 Schemanaam
3 Databasenaam
4 Servernaam

Retourtypen

sysname

Opmerkingen

PARSENAME geeft terug NULL als een van de volgende voorwaarden waar is:

  • Ofwel object_name of object_piece is NULL.

  • Er treedt een syntaxisfout op.

  • Het gevraagde objectgedeelte heeft een lengte van 0 en is geen geldige SQL Server-identificatie. Een objectnaam van nul-lengte maakt de volledige gekwalificeerde naam ongeldig.

Voorbeelden

Het volgende voorbeeld wordt gebruikt PARSENAME om informatie over de Person tabel in de AdventureWorks2025 database terug te geven.

-- Uses AdventureWorks

SELECT PARSENAME('AdventureWorks2022.Person.Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 4) AS 'Server Name';
GO

Hier is het resultatenoverzicht.

Object Name
------------------------------
Person

Schema Name
------------------------------
Person

Database Name
------------------------------
AdventureWorks2022

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