Sdílet prostřednictvím


PARSENAME (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)databáze SQL v Microsoft Fabric

Vrací zadanou část názvu objektu. Části objektu, které lze získat, jsou název objektu, název schématu, název databáze a název serveru.

PARSENAME neuvádí, zda existuje objekt s tímto jménem. PARSENAME pouze vrátí zadanou část názvu objektu.

Transact-SQL konvence syntaxe

Syntaxe

PARSENAME ('object_name' , object_piece )

Arguments

'object_name'

Parametr, který obsahuje název objektu, pro který se má získat zadaný objekt. Tento parametr je volitelně kvalifikovaný název objektu. Pokud jsou všechny části názvu objektu kvalifikované, může mít toto jméno čtyři části: název serveru, název databáze, název schématu a název objektu.

Každá část řetězce 'object_name' je sysname, což odpovídá nvarchar(128) nebo 256 bajtům. Pokud některá část řetězce přesahuje 256 bajtů, vrací PARSENAMENULL pro tuto část, protože to není platné jméno sysname.

object_piece

Předmět se vrací. object_piece je int a může být jednou z těchto hodnot:

Hodnota Description
1 Název objektu
2 Název schématu
3 Název databáze
4 Název serveru

Návratové typy

sysname

Poznámky

PARSENAME vrací NULL , pokud je splněna jedna z následujících podmínek:

  • Buď object_name, nebo object_piece je .NULL

  • Dochází k chybě v syntaxi.

  • Požadovaná část objektu má délku a 0 není platným identifikátorem SQL Serveru. Název objektu s nulovou délkou znamená, že úplné kvalifikované jméno není platné.

Examples

Následující příklad slouží PARSENAME k vrácení Person informací o tabulce AdventureWorks2025 v databázi.

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

Tady je soubor výsledků.

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

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

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

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