@return_status

モジュールから返されるステータス番号を格納する整数型の変数を指定します (省略可能)。この変数は、EXECUTE ステートメントで使う前に、バッチ、ストアド プロシージャ、または関数の中で宣言する必要があります。

@return_status 変数をユーザー定義のスカラ値関数の呼び出しに使用する場合は、任意のスカラ データ型を指定できます。

module_name

呼び出されるストアド プロシージャやユーザー定義のスカラ値関数の、完全修飾名または部分的な修飾名を指定します。モジュール名は、識別子の規則に従っている必要があります。拡張ストアド プロシージャの名前では、サーバーの照合順序に関係なく、常に大文字と小文字が区別されます。

別のデータベース内で作成されたモジュールを実行するには、実行するユーザーがモジュールを所有しているか、そのデータベース内のモジュールを実行する適切な権限がユーザーに与えられている必要があります。SQL Server を実行している別のサーバーでモジュールを実行するには、実行するユーザーに対して、そのサーバーを使用する適切な権限 (リモート アクセス) と、そのデータベース内のモジュールを実行する適切な権限が与えられている必要があります。サーバー名だけを指定してデータベース名を指定しない場合、SQL Server データベース エンジンでは、ユーザーの既定のデータベース内でモジュールが検索されます。

; number

同じ名前のプロシージャのグループ化に使用される整数です (省略可能)。このパラメータは、拡張ストアド プロシージャでは使用できません。

メモ :
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。

プロシージャ グループの詳細については、「CREATE PROCEDURE (Transact-SQL)」を参照してください。

@module_name_var

モジュール名を表すローカル変数の名前を指定します。

@parameter

モジュールで定義される、module_name 用のパラメータを指定します。パラメータ名の先頭にはアット マーク (@) を付ける必要があります。@parameter_name=value の形式で使用する場合、パラメータ名と定数は、モジュールで定義されている順序で指定する必要はありません。ただし、@parameter_name=value の形式をパラメータとして使用した場合は、以降のすべてのパラメータは、この形式で指定する必要があります。

既定では、パラメータに NULL 値は許容されます。

value

モジュールまたはパススルー コマンドに渡すパラメータの値を指定します。パラメータ名を指定しない場合、パラメータ値は、モジュールで定義された順序で指定する必要があります。

リンク サーバーに対してパススルー コマンドを実行するとき、パラメータ値の順序は、リンク サーバーの OLE DB プロバイダに依存します。ほとんどの OLE DB プロバイダでは、左から右へパラメータに値がバインドされます。

パラメータの値がオブジェクト名や文字列であったり、データベース名やスキーマ名によって修飾されている場合は、その名前全体を単一引用符で囲む必要があります。パラメータの値がキーワードの場合は、そのキーワードを二重引用符で囲む必要があります。

既定値がモジュール内で定義されている場合、ユーザーはパラメータを指定せずにモジュールを実行できます。

既定値を NULL にすることもできます。パラメータ値が NULL の場合の操作は、通常、モジュールの定義で指定します。

@variable

パラメータと戻りパラメータを格納する変数です。

OUTPUT

モジュールまたはコマンド文字列でパラメータを返すよう指定します。モジュールまたはコマンド文字列内で一致するパラメータも、キーワード OUTPUT を使って作成されている必要があります。このキーワードは、カーソル変数をパラメータとして使用するときに指定します。

リンク サーバーに対して実行するモジュールの OUTPUT として value を定義した場合、対応する @parameter に対して、OLE DB プロバイダによる変更が加えられていると、その変更内容がモジュール実行の最後に変数にコピーされて戻されます。

OUTPUT パラメータを使用し、呼び出し元のバッチまたはモジュール内の他のステートメントで戻り値を使用する場合は、パラメータの値を @parameter = @variable のように変数として引き渡す必要があります。モジュール内で OUTPUT パラメータとして定義されていないパラメータには、OUTPUT を指定してモジュールを実行することはできません。OUTPUT を使って定数をモジュールに引き渡すことはできません。戻りパラメータには変数名が必要です。プロシージャを実行する前に、必ず変数のデータ型を宣言し、値を割り当ててください。

リモート ストアド プロシージャに対して EXECUTE を使用する場合や、リンク サーバーに対してパススルー コマンドを実行する場合は、OUTPUT パラメータにラージ オブジェクト (LOB) 型を指定することはできません。

戻りパラメータには、LOB 型以外のデータ型を指定できます。

DEFAULT

モジュールで定義されているパラメータの既定値を使用します。パラメータに値を必要とするモジュールでパラメータの既定値が定義されていない場合、パラメータを指定しなかったり、DEFAULT キーワードを指定すると、エラーが発生します。

WITH RECOMPILE

モジュール実行後に、新しいプランを強制的にコンパイル、使用、および破棄します。モジュールに既存のクエリ プランがある場合、このプランはキャッシュに残ります。

指定するパラメータが一定しない場合であったり、データが大きく変更されたときにこのオプションを使用してください。このオプションは、拡張ストアド プロシージャには使用しません。このオプションは負荷を伴うので、あまり使用しないことをお勧めします。

メモ :
OPENDATASOURCE 構文を使用するストアド プロシージャを呼び出す場合、WITH RECOMPILE は使用できません。4 部構成のオブジェクト名が指定されている場合、WITH RECOMPILE オプションは無視されます。

@string_variable

ローカル変数の名前を指定します。@string_variable には、char、varchar、nchar、または nvarchar 型が許可されます。これには、(max) 型も含まれます。

[N] 'tsql_string'

定数文字列を指定します。tsql_string には、nvarchar または varchar 型が許可されます。N が含まれる場合、文字列は nvarchar 型として解釈されます。

AS <context_specification>

ステートメントを実行するコンテキストを指定します。詳細については、「実行コンテキストについて」を参照してください。

LOGIN

権限を借用するコンテキストがログインであることを指定します。権限借用のスコープはサーバーです。

USER

権限を借用するコンテキストが、現在のデータベース内のユーザーであることを指定します。権限借用のスコープは、現在のデータベースに限定されます。コンテキスト スイッチの対象がデータベース ユーザーであっても、そのユーザーのサーバー レベルの権限は継承されません。

重要 :
データベース ユーザーに対するコンテキスト スイッチがアクティブであるときに、データベース外部のリソースへアクセスを試みると、ステートメントが失敗する原因となります。たとえば、USE database ステートメントや分散クエリ、3 部または 4 部構成の識別子を使用する別のデータベースを参照するクエリなどは実行しないでください。コンテキスト スイッチのスコープを、現在のデータベースの外部まで拡張する方法については、「EXECUTE AS の使用によるデータベースの権限借用の拡張」を参照してください。

'name'

有効なユーザーまたはログイン名を指定します。name は、sysadmin 固定サーバー ロールのメンバであるか、sys.database_principals または sys.server_principals のプリンシパルとして存在する必要があります。

name には、NT AUTHORITY\LocalService、NT AUTHORITY\NetworkService、NT AUTHORITY\LocalSystem などのビルトイン アカウントは指定できません。

詳細については、後の「ユーザーまたはログイン名の指定」を参照してください。

[N] 'command_string'

リンク サーバーにパススルーされるコマンドを含む定数文字列を指定します。N が含まれる場合、文字列は nvarchar 型として解釈されます。

[?]

パススルー コマンドの <arg-list> で値が提供されるパラメータを表します。このパススルー コマンドは、EXEC('...', <arg-list>) AT <linkedsrv> ステートメントで使用されるものです。

AT linked_server_name

command_string を linked_server_name に対して実行し、結果が返された場合はそれをクライアントに返します。linked_server_name は、ローカル サーバー内の既存のリンク サーバー定義を参照している必要があります。リンク サーバーは、sp_addlinkedserver を使って定義されます。

パラメータは、value または @parameter_name = value を使って指定できます。パラメータはトランザクションの一部ではないため、トランザクションでパラメータが変更され、後でロールバックされても、パラメータの値を前の値に戻すことはできません。呼び出し元に返される値は常に、モジュールから戻る時点での値になります。

1 つのモジュールで、別のモジュールが呼び出されるか、共通言語ランタイム (CLR) モジュール、ユーザー定義型、または集計の参照によりマネージ コードが実行されるとき、入れ子が発生します。入れ子のレベルは、呼び出されたモジュールまたはマネージ コード参照の実行開始時に増加し、呼び出されたモジュールやマネージ コード参照の終了時に減少します。入れ子のレベルが最大値 32 を超えると、呼び出しチェーン全体が失敗します。現在の入れ子レベルは、@@NESTLEVEL システム関数に格納されます。

リモート プロシージャと拡張ストアド プロシージャは、BEGIN DISTRIBUTED TRANSACTION ステートメントの中で実行されない限り、または各種の構成オプションと共に使用されない限り、トランザクションのスコープ外となります。したがって、これらのプロシージャを呼び出して実行したコマンドはロールバックできません。詳細については、「システム ストアド プロシージャ (Transact-SQL)」および「BEGIN DISTRIBUTED TRANSACTION (Transact-SQL)」を参照してください。

カーソル変数を使用するとき、カーソル変数にカーソルを渡すプロシージャを実行し、このカーソルがプロシージャに割り当てられているカーソルであった場合は、エラーが発生します。

ステートメントがバッチ内の最初のステートメントの場合は、モジュールを実行するときに EXECUTE キーワードを指定する必要はありません。

ストアド プロシージャでの EXECUTE の使用

文字列での EXECUTE の使用

USE master; EXEC ('USE AdventureWorks; SELECT EmployeeID, Title FROM HumanResources.Employee;');

コンテキストの切り替え

EXECUTE ステートメントの実行に権限は必要ありませんが、EXECUTE 文字列内で参照されるセキュリティ保護可能なリソースに対しては権限が必要です。たとえば、文字列に INSERT ステートメントが含まれる場合、EXECUTE ステートメントの呼び出し元には、対象のテーブルに対する INSERT 権限が必要です。EXECUTE ステートメントは、モジュール内に含まれている場合でも、検出されるたびに権限が確認されます。

モジュールの EXECUTE 権限は、既定ではモジュールの所有者に与えられており、所有者はその権限を別のユーザーに譲渡できます。文字列を実行するモジュールが実行されるとき、権限は、モジュールを作成したユーザーのコンテキストではなく、モジュールを実行しているユーザーのコンテキストに基づいて確認されます。ただし、呼び出すモジュールと呼び出されるモジュールを所有するユーザーが同じ場合、2 番目のモジュールに対しては EXECUTE 権限の確認は行われません。詳細については、「所有権の継承」を参照してください。

モジュールで他のデータベース オブジェクトにアクセスする場合は、モジュールに対する EXECUTE 権限があり、次のいずれかに該当する場合にのみ、実行は成功します。

• モジュールが EXECUTE AS USER または SELF としてマークされており、モジュール所有者が、参照されるオブジェクトに対して必要な権限を保持している。
  
• モジュールが EXECUTE AS CALLER としてマークされており、オブジェクトに対して必要な権限を保持している。
  
• モジュールが EXECUTE AS user_name としてマークされており、user_name が、オブジェクトに対して必要な権限を保持している。
  

コンテキスト切り替え権限

A. EXECUTE を使用して 1 つのパラメータを引き渡す

USE AdventureWorks;
GO
EXEC dbo.uspGetEmployeeManagers 6;
GO

EXEC dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

dbo.uspGetEmployeeManagers 6;
GO
--Or
dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

B. 複数のパラメータを使用する

USE AdventureWorks;
GO
DECLARE @CheckDate datetime;
SET @CheckDate = GETDATE();
EXEC dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO

C. EXECUTE 'tsql_string' を変数と共に使用する

USE AdventureWorks;
GO
DECLARE tables_cursor CURSOR
   FOR
   SELECT s.name, t.name 
   FROM sys.objects AS t
   JOIN sys.schemas AS s ON s.schema_id = t.schema_id
   WHERE t.type = 'U';
OPEN tables_cursor;
DECLARE @schemaname sysname;
DECLARE @tablename sysname;
FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
WHILE (@@FETCH_STATUS <> -1)
BEGIN;
   EXECUTE ('ALTER INDEX ALL ON ' + @schemaname + '.' + @tablename + ' REBUILD;');
   FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
END;
PRINT 'The indexes on all tables have been rebuilt.';
CLOSE tables_cursor;
DEALLOCATE tables_cursor;
GO

D. EXECUTE をリモート ストアド プロシージャと共に使用する

DECLARE @retstat int;
EXECUTE @retstat = SQLSERVER1.AdventureWorks.dbo.uspGetEmployeeManagers @EmployeeID = 6;

E. EXECUTE をストアド プロシージャ変数と共に使用する

DECLARE @proc_name varchar(30);
SET @proc_name = 'sys.sp_who';
EXEC @proc_name;

F. EXECUTE を DEFAULT と共に使用する

G. EXECUTE を AT linked_server_name と共に使用する

EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
EXECUTE ( 'CREATE TABLE AdventureWorks.dbo.SalesTbl 
(SalesID int, SalesName varchar(10)) ; ' ) AT SeattleSales;
GO

H. EXECUTE WITH RECOMPILE を使用する

EXECUTE dbo.Proc_Test_Defaults @p2 = 'A' WITH RECOMPILE;
GO

I. EXECUTE をユーザー定義関数と共に使用する

USE AdventureWorks;
GO
DECLARE @returnstatus nvarchar(15);
SET @returnstatus = NULL;
EXEC @returnstatus = dbo.ufnGetSalesOrderStatusText @Status = 2;
PRINT @returnstatus;
GO

J. EXECUTE を使用して、リンク サーバー上の Oracle データベースに対してクエリを実行する

-- Setup the linked server.
EXEC sp_addlinkedserver  
        @server='ORACLE',
        @srvproduct='Oracle',
        @provider='OraOLEDB.Oracle', 
        @datasrc='ORACLE10';

EXEC sp_addlinkedsrvlogin 
    @rmtsrvname='ORACLE',
    @useself='false', 
    @locallogin=null, 
    @rmtuser='scott', 
    @rmtpassword='tiger';
 
EXEC sp_serveroption 'ORACLE', 'rpc out', true;
GO
 
-- Execute several statements on the linked Oracle server.
EXEC ( 'SELECT * FROM scott.emp') AT ORACLE;
GO
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', 7902) AT ORACLE;
GO
DECLARE @v INT; 
SET @v = 7902;
EXEC ( 'SELECT * FROM scott.emp WHERE MGR = ?', @v) AT ORACLE;
GO

K. EXECUTE AS USER を使用して、コンテキストを別のユーザーに切り替える

USE AdventureWorks;
GO
EXECUTE ('CREATE TABLE Sales.SalesTable (SalesID int, SalesName varchar(10));')
AS USER = 'User1';
GO

L. EXECUTE および AT linked_server_name と共にパラメータを使用する

-- Setup the linked server.
EXEC sp_addlinkedserver 'SeattleSales', 'SQL Server'
GO
-- Execute the SELECT statement.
EXECUTE ('SELECT ProductID, Name 
    FROM AdventureWorks.Production.Product
    WHERE ProductID = ? ', 952) AT SeattleSales;
GO

関連項目

その他の技術情報

ヘルプおよび情報