ALTER PROCEDURE (Transact-SQL)

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス Microsoft Fabric の SQL データベース

SQL Server でCREATE PROCEDURE文を実行して作成した既に作成された手続きを修正します。

Transact-SQL 構文表記規則 (Transact-SQL)

構文

-- Syntax for SQL Server and Azure SQL Database
  
ALTER { PROC | PROCEDURE } [schema_name.] procedure_name [ ; number ]   
    [ { @parameter_name [ type_schema_name. ] data_type }   
        [ VARYING ] [ = default ] [ OUT | OUTPUT ] [READONLY]  
    ] [ ,...n ]   
[ WITH <procedure_option> [ ,...n ] ]  
[ FOR REPLICATION ]   
AS { [ BEGIN ] sql_statement [;] [ ...n ] [ END ] }  
[;]  
  
<procedure_option> ::=   
    [ ENCRYPTION ]  
    [ RECOMPILE ]  
    [ EXECUTE AS Clause ]

-- Syntax for SQL Server CLR Stored Procedure  
  
ALTER { PROC | PROCEDURE } [schema_name.] procedure_name [ ; number ]   
    [ { @parameter_name [ type_schema_name. ] data_type }   
        [ = default ] [ OUT | OUTPUT ] [READONLY]  
    ] [ ,...n ]   
[ WITH EXECUTE AS Clause ]  
AS { EXTERNAL NAME assembly_name.class_name.method_name }  
[;]

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse and Microsoft Fabric
  
ALTER { PROC | PROCEDURE } [schema_name.] procedure_name  
    [ { @parameterdata_type } [= ] ] [ ,...n ]  
AS { [ BEGIN ] sql_statement [ ; ] [ ,...n ] [ END ] }  
[;]

引数

schema_name
プロシージャが属するスキーマの名前を指定します。

procedure_name
変更するプロシージャの名前です。プロシージャ名は、識別子のルールに従っている必要があります。

;number
同名の手続きをグループ化し、1つの DROP PROCEDURE 文でまとめてまとめられるようにするための既存のオプション整数です。

Note

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

@ parameter_name
プロシージャ内のパラメーターです。パラメーターは 2,100 個まで指定できます。

[ type_schema_name。 ] data_type
パラメーターのデータ型とそれが属するスキーマです。

データ型制限については、 CREATE PROCEDURE (Transact-SQL)を参照してください。

VARYING
出力パラメーターとしてサポートされている結果セットを指定します。このパラメーターはストアドプロシージャによって動的に作成され、その内容は変化します。カーソルパラメーターにのみ適用されます。このオプションは、CLR プロシージャでは無効です。

default
パラメーターの既定値です。

OUT |アウトプット
パラメーターが戻りパラメーターであることを示します。

READONLY
パラメーターをプロシージャの本体内で更新または変更できないことを示します。パラメーターの型がテーブル値型の場合は、READONLY を指定する必要があります。

RECOMPILE
データベースエンジンでは、このプロシージャ用のプランをキャッシュせず、実行時にプロシージャを再コンパイルします。

ENCRYPTION
適用対象: SQL Server (SQL Server 2008 (10.0.x) 以降) と Azure SQL データベース。

データベースエンジンがALTER PROCEDURE文の原文を難読化された形式に変換することを示します。暗号化した形式の出力は、SQL Server 内のどのカタログビューでも直接見ることはできません。システムテーブルまたはデータベースファイルへのアクセス権を持たないユーザーは、暗号化した形式のテキストを取得できません。ただし、DAC ポート経由でシステムテーブルにアクセスする権限、または直接データベースファイルにアクセスする権限を持っているユーザーは、このテキストを使用できます。また、サーバープロセスにデバッガーをアタッチできるユーザーは、実行時、元のプロシージャをメモリから取得できます。システムメタデータのアクセス方法について詳しくは、「メタデータ表示の構成」をご覧ください。

このオプションを使って作成したプロシージャを、SQL Server レプリケーションの一部として発行することはできません。

このオプションは、共通言語ランタイム (CLR) のストアドプロシージャには指定できません。

Note

データベースエンジンでは、アップグレード中に、sys.sql_modules に格納されている暗号化コメントにより、プロシージャが再作成されます。

EXECUTE AS
アクセス後にストアドプロシージャを実行するセキュリティコンテキストを指定します。

詳細については、「 EXECUTE AS 句 (Transact-SQL)」を参照してください。

レプリケーション用

レプリケーション用に作成したストアドプロシージャは、サブスクライバーでは実行できないことを示します。 FOR REPLICATION オプションを指定して作成したストアドプロシージャは、ストアドプロシージャフィルターとして使用され、レプリケーション時にのみ実行されます。 FOR REPLICATION を指定した場合、パラメーターは宣言できません。このオプションは、CLR プロシージャでは無効です。 RECOMPILE オプションは、FOR REPLICATION を使って作成されたプロシージャでは無視されます。

Note

このオプションは、包含データベースでは使用できません。

{ [ BEGIN ] sql_statement [;][ ...n ] [ END ] }
プロシージャの本体を構成する 1 つ以上の Transact-SQL ステートメントを指定します。省略可能な BEGIN キーワードと END キーワードを使用して、ステートメントを囲むことができます。詳細については、 CREATE PROCEDURE (Transact-SQL)のベストプラクティス、一般的な注釈、制限および制限のセクションをご覧ください。

外部名 assembly_name。class_name。method_name
適用対象: SQL Server 2008 (10.0.x) 以降。

CLR ストアドプロシージャで参照する .NET Framework アセンブリのメソッドを指定します。 class_name は、有効な SQL Server 識別子であること、およびアセンブリにクラスとして存在していることが必要です。クラス名に名前空間とその区切り文字のピリオド (.) が含まれる場合は、クラス名をかっこ ([ ]) または引用符 ("") で区切る必要があります。指定するメソッドは、クラスの静的メソッドであることが必要です。

既定では、SQL Server は CLR コードを実行できません。共通言語ランタイムモジュールを参照するデータベースオブジェクトを作成、変更、および削除することはできますが、SQL Server でこれらの参照を実行するには、clr enabled オプションを有効にする必要があります。このオプションを有効にするには、sp_configure を使用します。

Note

CLR プロシージャは、包含データベースではサポートされていません。

全般的な解説

Transact-SQL ストアドプロシージャを CLR ストアドプロシージャに変更したり、その逆に変更することはできません。

ALTER PROCEDURE 権限を変更しず、依存するストアドプロシージャやトリガーにも影響しません。しかし、 QUOTED_IDENTIFIER および ANSI_NULLS の現在のセッション設定は、ストアドプロシージャが変更される際に含まれています。ストアドプロシージャの最初の作成時に有効であった設定と変更後の設定が異なる場合、ストアドプロシージャの動作が変わる可能性があります。

以前のプロシージャ定義がWITH ENCRYPTIONまたはWITH RECOMPILEで作成された場合、これらのオプションは ALTER PROCEDUREに含まれる場合にのみ有効になります。

ストアドプロシージャの詳細については、 CREATE PROCEDURE (Transact-SQL)を参照してください。

セキュリティ

アクセス許可

プロシージャの ALTER 権限、または db_ddladmin 固定データベースロールのメンバーシップが必要です。

例

次の例では、uspVendorAllInfo ストアドプロシージャを作成します。このプロシージャは、Adventure Works Cycles を提供するすべてのベンダーの名前と、そのベンダーの提供製品、信用格付け、およびベンダーが現時点で製品を提供できるかどうかを返します。このプロシージャを作成した後、別の結果セットを返すように変更されます。

IF OBJECT_ID ( 'Purchasing.uspVendorAllInfo', 'P' ) IS NOT NULL   
    DROP PROCEDURE Purchasing.uspVendorAllInfo;  
GO  
CREATE PROCEDURE Purchasing.uspVendorAllInfo  
WITH EXECUTE AS CALLER  
AS  
    SET NOCOUNT ON;  
    SELECT v.Name AS Vendor, p.Name AS 'Product name',   
      v.CreditRating AS 'Rating',   
      v.ActiveFlag AS Availability  
    FROM Purchasing.Vendor v   
    INNER JOIN Purchasing.ProductVendor pv  
      ON v.BusinessEntityID = pv.BusinessEntityID   
    INNER JOIN Production.Product p  
      ON pv.ProductID = p.ProductID   
    ORDER BY v.Name ASC;  
GO

次の例では、uspVendorAllInfo ストアドプロシージャを変更します。 EXECUTE AS CALLER節を削除し、手続きの本文を修正して、指定された製品を供給するベンダーのみを返すようにします。ここでは、 LEFT 関数および CASE 関数を使用して、結果セットの表示をカスタマイズします。

USE AdventureWorks2022;  
GO  
ALTER PROCEDURE Purchasing.uspVendorAllInfo  
    @Product VARCHAR(25)   
AS  
    SET NOCOUNT ON;  
    SELECT LEFT(v.Name, 25) AS Vendor, LEFT(p.Name, 25) AS 'Product name',   
    'Rating' = CASE v.CreditRating   
        WHEN 1 THEN 'Superior'  
        WHEN 2 THEN 'Excellent'  
        WHEN 3 THEN 'Above average'  
        WHEN 4 THEN 'Average'  
        WHEN 5 THEN 'Below average'  
        ELSE 'No rating'  
        END  
    , Availability = CASE v.ActiveFlag  
        WHEN 1 THEN 'Yes'  
        ELSE 'No'  
        END  
    FROM Purchasing.Vendor AS v   
    INNER JOIN Purchasing.ProductVendor AS pv  
      ON v.BusinessEntityID = pv.BusinessEntityID   
    INNER JOIN Production.Product AS p   
      ON pv.ProductID = p.ProductID   
    WHERE p.Name LIKE @Product  
    ORDER BY v.Name ASC;  
GO

結果セットは次のとおりです。

Vendor               Product name  Rating    Availability  
-------------------- ------------- -------   ------------  
Proseware, Inc.      LL Crankarm   Average   No  
Vision Cycles, Inc.  LL Crankarm   Superior  Yes  
(2 row(s) affected)`

参照

CREATE PROCEDURE (Transact-SQL)
DROP PROCEDURE (Transact-SQL)
実行(Transact-SQL)
EXECUTE AS (Transact-SQL)
イベントデータ (Transact-SQL)
ストアドプロシージャ (データベースエンジン)
sys.procedures (Transact-SQL)

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-06-24

ALTER PROCEDURE (Transact-SQL)

構文

引数

全般的な解説

セキュリティ

アクセス許可

例

参照

フィードバック

その他のリソース