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

適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) はいAzure SQL データベースAzure SQL DatabaseYesAzure SQL データベースAzure SQL Database はいAzure SQL Managed InstanceAzure SQL Managed InstanceYesAzure SQL Managed InstanceAzure SQL Managed Instance はいAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics はいParallel Data WarehouseParallel Data WarehouseyesParallel Data WarehouseParallel Data Warehouse

オブジェクト名の指定した部分を返します。Returns the specified part of an object name. 取得できるオブジェクトの部分は、オブジェクト名、スキーマ名、データベース名、およびサーバー名です。The parts of an object that can be retrieved are the object name, schema name, database name, and server name.

注意

PARSENAME 関数では、指定した名前のオブジェクトが存在するかどうかは示されず、The PARSENAME function does not indicate whether an object by the specified name exists. PARSENAME は、指定したオブジェクト名の指定した部分だけを返します。PARSENAME just returns the specified part of the specified object name.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

PARSENAME ('object_name' , object_piece )

注意

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

引数Arguments

'object_name' は、取得対象となるオブジェクトの名前を保持するパラメーターです。'object_name' Is the parameter that holds the name of the object for which to retrieve the specified object part. このパラメーターは、必要に応じて修飾されたオブジェクト名です。This parameter is an optionally-qualified object name. オブジェクト名のすべての部分が修飾される場合、この名前には、サーバー名、データベース名、スキーマ名、オブジェクト名の 4 つの部分を指定可能です。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. 'object_name' 文字列の各部分は、nvarchar(128) または 256 バイトに相当する sysname 型です。Each part of the 'object_name' string is type sysname which is equivalent to nvarchar(128) or 256 bytes. 文字列のいずれかの部分が 256 バイトを超える場合、有効な sysname ではないため、PARSENAME はその部分に対して NULL を返します。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
返すオブジェクトの部分を指定します。Is the object part to return. object_piece のデータ型は int, 、これらの値を持つことができます。object_piece is of type int, and can have these values:
1 = オブジェクト名1 = Object name
2 = スキーマ名2 = Schema name
3 = データベース名3 = Database name
4 = サーバー名4 = Server name

戻り値の型Return Type

sysnamesysname

解説Remarks

次のいずれかの条件に該当する場合、PARSENAME は NULL を返します。PARSENAME returns NULL if one of the following conditions is true:

  • いずれか object_name または object_piece は NULL です。Either object_name or object_piece is NULL.

  • 構文エラーが発生した。A syntax error occurs.

要求したオブジェクトの部分の長さが 0 で、有効な MicrosoftMicrosoft SQL ServerSQL Server 識別子ではない。The requested object part has a length of 0 and is not a valid MicrosoftMicrosoft SQL ServerSQL Server identifier. 長さ 0 のオブジェクト名は完全修飾名を無効とします。A zero-length object name renders the complete qualified name as not valid.

Examples

次の例では使用 PARSENAME 情報を返す、 Person テーブルに、 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  

結果セットは次のようになります。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)

参照See Also