ストアドプロシージャの実行 (データベースエンジン)

[アーティクル]
12/16/2008

ストアドプロシージャを実行するには、Transact-SQL EXECUTE ステートメントを使用します。または、ストアドプロシージャがバッチ内の最初のステートメントである場合は、EXECUTE キーワードを使用せずにストアドプロシージャを実行できます。

システムストアドプロシージャの実行

システムストアドプロシージャは、sp_ という文字で始まります。物理的にはリソースデータベースに格納されますが、論理的には Microsoft SQL Server のインスタンスにある、各システムデータベースとユーザー定義データベースの sys スキーマに表示されます。システムストアドプロシージャは、ストアドプロシージャ名を完全に修飾する必要はなく、どのデータベースからでも実行できます。スキーマ修飾されていない名前とは、sp_someproc のように 1 つの要素で構成される名前か、somedb..sp_someproc のように 2 番目の要素 (スキーマ名) が指定されていない 3 つの要素で構成される名前です。

名前の競合を回避するためには、すべてのシステムストアドプロシージャ名を sys スキーマ名でスキーマ修飾することをお勧めします。次の例は、システムストアドプロシージャの実行に関して推奨されている方法を示しています。

EXEC sys.sp_who;

次の例は、システムストアドプロシージャの実行に関して、旧バージョンと互換性のある方法を示しています。

メモ :
次のシステムストアドプロシージャの実行方法は、今後のバージョンの SQL Server で廃止される予定です。新しい開発作業ではこれらの方法の使用を避け、現在この方法を使用しているアプリケーションは変更を検討してください。

EXEC sp_who;
EXEC master.dbo.sp_who;
EXEC mydatabase..sp_who;
EXEC dbo.sp_who;
EXEC mydatabase.dbo.sp_who;

データベースの照合順序の一致

Microsoft SQL Server 2005 では、システムプロシージャ名を照合するときに、呼び出し元のデータベースの照合順序が使用されます。そのため、アプリケーションでは、システムプロシージャ名の大文字と小文字を常に区別する必要があります。たとえば、次のコードは、大文字と小文字を区別する照合順序が指定されたデータベースのコンテキストで実行された場合は失敗します。

exec SP_heLP; -- Will fail to resolve because SP_heLP does not equal sp_help

正確なシステムストアドプロシージャ名を表示するには、sys.system_objects カタログビューおよび sys.system_parameters カタログビューを使用します。

システム拡張ストアドプロシージャの実行

システム拡張ストアドプロシージャは、xp_ という文字で始まります。物理的にはリソースデータベースに格納されますが、論理的には SQL Server のインスタンスにある、各システムデータベースとユーザー定義データベースの sys スキーマに表示されます。次の例は、システム拡張ストアドプロシージャの実行に関して推奨されている方法を示しています。

EXEC sys.xp_subdirs 'c:\';

ユーザー定義のストアドプロシージャの実行

バッチ内、またはユーザー定義のストアドプロシージャや関数などのモジュール内のいずれかにある、ユーザー定義のストアドプロシージャを実行する場合、ストアドプロシージャ名を少なくともスキーマ名で修飾することを強くお勧めします。

次の例は、ユーザー定義のストアドプロシージャを実行するために推奨されている方法を示しています。

USE AdventureWorks;
GO
EXEC dbo.uspGetEmployeeManagers 50;

または

EXEC AdventureWorks.dbo.uspGetEmployeeManagers 50;
GO

修飾されていないユーザー定義のストアドプロシージャを指定した場合、データベースエンジンでは次の順序でプロシージャが検索されます。

現在のデータベースの sys スキーマ。
バッチまたは動的 SQL で実行された場合は、呼び出し側の既定のスキーマ。または、別のプロシージャ定義の本文の中に非修飾型プロシージャ名がある場合は、そのプロシージャを含んでいるスキーマが次に検索されます。既定のスキーマの詳細については、「ユーザーとスキーマの分離」を参照してください。
現在のデータベースにある dbo スキーマ。

重要 :
ユーザーが作成したストアドプロシージャとシステムストアドプロシージャの名前が同じである場合に、スキーマ以外の修飾名参照を使用していると、ユーザーが作成したストアドプロシージャは実行されません。詳細については、「ストアドプロシージャの作成 (データベースエンジン)」を参照してください。

ユーザーが作成したストアドプロシージャとシステムストアドプロシージャの名前が同じである場合に、スキーマ以外の修飾名参照を使用していると、ユーザーが作成したストアドプロシージャは実行されません。詳細については、「ストアドプロシージャの作成 (データベースエンジン)」を参照してください。

パラメータの指定

パラメータ値を指定できるようにストアドプロシージャが記述されていれば、パラメータ値を指定できます。

指定する値は、定数または変数である必要があります。パラメータ値には関数名は指定できません。変数には、ユーザー定義変数や @@spid などのシステム変数を使用できます。

次の例では、パラメータ値をストアドプロシージャ uspGetWhereUsedProductID に渡す方法を示しています。プロシージャには、製品 ID と日付の 2 つの入力パラメータの値が渡されます。この例では、定数および変数としてパラメータを渡す方法を示しています。また、変数を使用して関数の値を渡す方法も示しています。

USE AdventureWorks;
GO
-- Passing values as constants.
EXEC dbo.uspGetWhereUsedProductID 819, '20050225';
GO
-- Passing values as variables.
DECLARE @ProductID int, @CheckDate datetime;
SET @ProductID = 819;
SET @CheckDate = '20050225';
EXEC dbo.uspGetWhereUsedProductID @ProductID, @CheckDate;
GO
-- Try to use a function as a parameter value.
-- This produces an error message.
EXEC dbo.uspGetWhereUsedProductID 819, GETDATE();
GO
-- Passing the function value as a variable.
DECLARE @CheckDate datetime;
SET @CheckDate = GETDATE();
EXEC dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO

ストアドプロシージャの定義と異なる順序でパラメータを指定する場合は、パラメータに名前を付ける必要があります。詳細については、「パラメータ名の指定」を参照してください。

パラメータから呼び出し元のプログラムに値を返すように指定するには、OUTPUT キーワードを使用します。詳細については、「パラメータの方向の指定」を参照してください。

パラメータの順序の指定

**@parameter =**value という形式でパラメータを指定すると、パラメータを任意の順序で指定することができます。また、既定値が与えられているパラメータは省略することもできます。1 つのパラメータを **@parameter =value の形式で指定した場合は、後続のパラメータもすべてこの形式で指定する必要があります。@parameter =**value の形式を使用しない場合は、CREATE PROCEDURE ステートメントで定義された順番でパラメータを指定する必要があります。

ストアドプロシージャを実行する場合、プロシージャの作成時にパラメータの一覧に含まれていないパラメータは、サーバーに拒否されます。参照渡し (パラメータ名を明示的に渡すこと) のパラメータは、パラメータ名が一致しないと受け入れられません。

パラメータでの既定値の使用

既定値が指定されているパラメータは省略できますが、パラメータの一覧を切り捨てることしかできません。たとえば、ストアドプロシージャに 5 つのパラメータがある場合、4 番目と 5 番目のパラメータを両方とも省略することはできますが、**@parameter =**value の形式でパラメータを指定しない限り、4 番目のパラメータだけを省略して 5 番目のパラメータを指定することはできません。

パラメータの既定値は、ストアドプロシージャ内でパラメータに定義されていると、次の場合に使用できます。

ストアドプロシージャの実行時にパラメータの値が指定されていない場合
パラメータの値として DEFAULT キーワードが指定されている場合

参照

次の方法で共有

ストアドプロシージャの実行 (データベースエンジン)

システムストアドプロシージャの実行

データベースの照合順序の一致

システム拡張ストアドプロシージャの実行

ユーザー定義のストアドプロシージャの実行

パラメータの指定

パラメータの順序の指定

パラメータでの既定値の使用

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース

次の方法で共有

ストアド プロシージャの実行 (データベース エンジン)

システム ストアド プロシージャの実行

データベースの照合順序の一致

システム拡張ストアド プロシージャの実行

ユーザー定義のストアド プロシージャの実行

パラメータの指定

パラメータの順序の指定

パラメータでの既定値の使用

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース

ストアドプロシージャの実行 (データベースエンジン)

システムストアドプロシージャの実行

システム拡張ストアドプロシージャの実行

ユーザー定義のストアドプロシージャの実行