ユーザー定義関数の表示

2017-06-13

SQL Server Management Studio または Transact-SQL を使用して、SQL Server 2014 のユーザー定義関数の定義またはプロパティに関する情報を取得できます。関数のデータが元のテーブルからどのように抽出されているのかを理解したり、関数で定義されているデータを確認するために、関数の定義を調べたい場合があります。

重要

関数から参照しているオブジェクトの名前を変更する場合は、関数のテキストに新しいオブジェクト名が反映されるように関数を変更する必要があります。したがって、オブジェクトの名前を変更する前に、まずオブジェクトの依存関係を表示して、オブジェクト名の変更により影響を受ける関数があるかどうかを確認してください。

このトピックの内容

作業を開始する準備:

セキュリティ
関数に関する情報を取得するために使用するもの:

SQL Server Management Studio

Transact-SQL

始める前に

セキュリティ

アクセス許可

sys.sql_expression_dependencies を使用して関数のすべての依存関係を検索するには、データベースに対する VIEW DEFINITION 権限とデータベースの sys.sql_expression_dependencies に対する SELECT 権限が必要です。 OBJECT_DEFINITION で返されるようなシステムオブジェクトの定義は公開されます。

SQL Server Management Studio を使用する

ユーザー定義関数のプロパティを表示するには

オブジェクトエクスプローラーで、プロパティを表示する関数を含むデータベースの横にあるプラス記号をクリックします。次に、プラス記号をクリックして [プログラミング] フォルダーを展開します。
プラス記号をクリックして [関数] フォルダーを展開します。
プロパティを表示する関数を含むフォルダーをプラス記号をクリックして展開します。
- テーブル値関数
- スカラー値関数
- 集計関数
プロパティを表示する関数を右クリックし、 [プロパティ]を選択します。

[関数のプロパティ - function_name] ダイアログボックスに、次のプロパティが表示されます。

データベース
この関数を含むデータベースの名前です。

[サーバー]
現在のサーバーインスタンスの名前です。

利用者
この接続のユーザーの名前です。

Created date (作成日)
関数が作成された日付を表示します。

実行時の権限
関数の実行コンテキストです。

名前
現在の関数の名前です。

[スキーマ]
関数を所有するスキーマを表示します。

[システムオブジェクト]
関数がシステムオブジェクトかどうかを指定します。値は True と False です。

[ANSI NULL]
オブジェクトが ANSI NULL オプションで作成されたかどうかを指定します。

暗号化
関数が暗号化されているかどうかを指定します。値は True と False です。

[関数の種類]
ユーザー定義関数の種類です。

[引用符で囲まれた識別子]
オブジェクトが引用符で囲まれた識別子オプションで作成されたかどうかを指定します。

[スキーマバインド]
関数がスキーマバインドされているかどうかを指定します。値は True と False です。スキーマバインド関数の詳細については、「CREATE FUNCTION (Transact-SQL)」の SCHEMABINDING のセクションを参照してください。

Transact-SQL の使用

関数の定義およびプロパティを取得するには

オブジェクトエクスプローラーで、データベースエンジンのインスタンスに接続します。
[標準] ツールバーの [新しいクエリ] をクリックします。

次のいずれかの例をコピーしてクエリウィンドウに貼り付け、 [実行]をクリックします。

USE AdventureWorks2012;  
GO  
-- Get the function name, definition, and relevant properties  
SELECT sm.object_id,   
   OBJECT_NAME(sm.object_id) AS object_name,   
   o.type,   
   o.type_desc,   
   sm.definition,  
   sm.uses_ansi_nulls,  
   sm.uses_quoted_identifier,  
   sm.is_schema_bound,  
   sm.execute_as_principal_id  
-- using the two system tables sys.sql_modules and sys.objects  
FROM sys.sql_modules AS sm  
JOIN sys.objects AS o ON sm.object_id = o.object_id  
-- from the function 'dbo.ufnGetProductDealerPrice'  
WHERE sm.object_id = OBJECT_ID('dbo.ufnGetProductDealerPrice')  
ORDER BY o.type;  
GO

USE AdventureWorks2012;  
GO  
-- Get the definition of the function dbo.ufnGetProductDealerPrice  
SELECT OBJECT_DEFINITION (OBJECT_ID('dbo.ufnGetProductDealerPrice')) AS ObjectDefinition;  
GO

詳細については、「sys.sql_modules (Transact-SQL)」および「OBJECT_DEFINITION (Transact-SQL)」を参照してください。

関数の依存関係を取得するには

オブジェクトエクスプローラーで、データベースエンジンのインスタンスに接続します。
[標準] ツールバーの [新しいクエリ] をクリックします。

次の例をコピーしてクエリウィンドウに貼り付け、 [実行] をクリックします。

USE AdventureWorks2012;  
GO  
-- Get all of the dependency information  
SELECT OBJECT_NAME(sed.referencing_id) AS referencing_entity_name,   
    o.type_desc AS referencing_desciption,   
    COALESCE(COL_NAME(sed.referencing_id, sed.referencing_minor_id), '(n/a)') AS referencing_minor_id,   
    sed.referencing_class_desc, sed.referenced_class_desc,  
    sed.referenced_server_name, sed.referenced_database_name, sed.referenced_schema_name,  
    sed.referenced_entity_name,   
    COALESCE(COL_NAME(sed.referenced_id, sed.referenced_minor_id), '(n/a)') AS referenced_column_name,  
    sed.is_caller_dependent, sed.is_ambiguous  
-- from the two system tables sys.sql_expression_dependencies and sys.object  
FROM sys.sql_expression_dependencies AS sed  
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id  
-- on the function dbo.ufnGetProductDealerPrice  
WHERE sed.referencing_id = OBJECT_ID('dbo.ufnGetProductDealerPrice');  
GO

詳細については、「sys.sql_expression_dependencies (Transact-SQL)」および「sys.objects (Transact-SQL)」を参照してください。