PARSENAME (Transact-SQL)PARSENAME (Transact-SQL)
適用対象:Applies to: 
SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL DatabaseAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsParallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data WarehouseSQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL DatabaseAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsParallel Data WarehouseParallel Data WarehouseParallel 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 構文表記規則 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)