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

[アーティクル]
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 キーワードが指定されている場合

参照

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

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

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

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

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