ALTER FUNCTION (Transact-SQL)

2025-06-26

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric Warehouse Microsoft Fabric SQL Database

CREATE FUNCTION ステートメントを実行して以前に作成した既存の Transact-SQL または CLR 関数を、アクセス許可を変更せず、依存関数、ストアドプロシージャ、またはトリガーに影響を与えずに変更します。

ヒント

CREATE OR ALTER FUNCTIONを指定して、その名前で新しい関数が存在しない場合は作成するか、1 つのステートメントで既存の関数を変更できます。

Transact-SQL 構文表記規則

構文

-- Transact-SQL Scalar Function Syntax    
ALTER FUNCTION [ schema_name. ] function_name   
( [ { @parameter_name [ AS ][ type_schema_name. ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
  ]  
)  
RETURNS return_data_type  
    [ WITH <function_option> [ ,...n ] ]  
    [ AS ]  
    BEGIN   
        function_body   
        RETURN scalar_expression  
    END  
[ ; ]

-- Transact-SQL Inline Table-Valued Function Syntax
ALTER FUNCTION [ schema_name. ] function_name   
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
  ]  
)  
RETURNS TABLE  
    [ WITH <function_option> [ ,...n ] ]  
    [ AS ]  
    RETURN [ ( ] select_stmt [ ) ]  
[ ; ]

-- Transact-SQL Multistatement Table-valued Function Syntax
ALTER FUNCTION [ schema_name. ] function_name   
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
  ]  
)  
RETURNS @return_variable TABLE <table_type_definition>  
    [ WITH <function_option> [ ,...n ] ]  
    [ AS ]  
    BEGIN   
        function_body   
        RETURN  
    END  
[ ; ]

-- Transact-SQL Function Clauses   
<function_option>::=   
{  
    [ ENCRYPTION ]  
  | [ SCHEMABINDING ]  
  | [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]  
  | [ EXECUTE_AS_Clause ]  
} 

<table_type_definition>:: =   
( { <column_definition> <column_constraint>   
  | <computed_column_definition> }   
    [ <table_constraint> ] [ ,...n ]  
)   
<column_definition>::=  
{  
    { column_name data_type }  
    [ [ DEFAULT constant_expression ]   
      [ COLLATE collation_name ] | [ ROWGUIDCOL ]  
    ]  
    | [ IDENTITY [ (seed , increment ) ] ]  
    [ <column_constraint> [ ...n ] ]   
}  

<column_constraint>::=   
{  
    [ NULL | NOT NULL ]   
    { PRIMARY KEY | UNIQUE }  
      [ CLUSTERED | NONCLUSTERED ]   
        [ WITH FILLFACTOR = fillfactor   
        | WITH ( < index_option > [ , ...n ] )  
      [ ON { filegroup | "default" } ]  
  | [ CHECK ( logical_expression ) ] [ ,...n ]  
}  

<computed_column_definition>::=  
column_name AS computed_column_expression   

<table_constraint>::=  
{   
    { PRIMARY KEY | UNIQUE }  
      [ CLUSTERED | NONCLUSTERED ]   
      ( column_name [ ASC | DESC ] [ ,...n ] )  
        [ WITH FILLFACTOR = fillfactor   
        | WITH ( <index_option> [ , ...n ] )  
  | [ CHECK ( logical_expression ) ] [ ,...n ]  
}  

<index_option>::=  
{   
    PAD_INDEX = { ON | OFF }   
  | FILLFACTOR = fillfactor   
  | IGNORE_DUP_KEY = { ON | OFF }  
  | STATISTICS_NORECOMPUTE = { ON | OFF }   
  | ALLOW_ROW_LOCKS = { ON | OFF }  
  | ALLOW_PAGE_LOCKS ={ ON | OFF }   
}

-- CLR Scalar and Table-Valued Function Syntax
ALTER FUNCTION [ schema_name. ] function_name   
( { @parameter_name [AS] [ type_schema_name. ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
)  
RETURNS { return_data_type | TABLE <clr_table_type_definition> }  
    [ WITH <clr_function_option> [ ,...n ] ]  
    [ AS ] EXTERNAL NAME <method_specifier>  
[ ; ]

-- CLR Function Clauses
<method_specifier>::=  
    assembly_name.class_name.method_name  

<clr_function_option>::=  
}  
    [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]  
  | [ EXECUTE_AS_Clause ]  
}  

<clr_table_type_definition>::=   
( { column_name data_type } [ ,...n ] )

-- Syntax for In-Memory OLTP: Natively compiled, scalar user-defined function  
ALTER FUNCTION [ schema_name. ] function_name    
 ( [ { @parameter_name [ AS ][ type_schema_name. ] parameter_data_type   
    [ NULL | NOT NULL ] [ = default ] }   
    [ ,...n ]   
  ]   
)   
RETURNS return_data_type  
    [ WITH <function_option> [ ,...n ] ]   
    [ AS ]   
    BEGIN ATOMIC WITH (set_option [ ,... n ])  
        function_body   
        RETURN scalar_expression  
    END  

<function_option>::=   
{ |  NATIVE_COMPILATION   
  |  SCHEMABINDING   
  | [ EXECUTE_AS_Clause ]   
  | [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]   
}

引数

schema_name

ユーザー定義関数が属するスキーマの名前。

function_name

変更するユーザー定義関数。

注

パラメーターを指定しない場合でも、関数名の後にはかっこが必要です。

@ parameter_name

ユーザー定義関数のパラメータ。 1 つ以上のパラメーターを宣言できます。

1 つの関数では、最高 2,100 個のパラメーターを使用できます。宜言した各パラメーターの値は、関数の実行時に、ユーザーが指定する必要があります (そのパラメーターの既定値が定義されていない場合)。

パラメーター名は、最初の文字をアットマーク ( @ ) にして指定します。パラメーター名は識別子のルールに従っている必要があります。パラメーターは関数に対してローカルです。同じパラメーター名を他の関数で使用できます。パラメーターは定数の代わりとしてのみ使用できます。パラメーターは、テーブル名、列名、またはその他のデータベースオブジェクト名の代わりに使用することはできません。

注

ストアドプロシージャでパラメーターを引き渡す場合や、バッチステートメントで変数を宣言または設定する場合、またはユーザー定義関数においては、ANSI_WARNINGS は無視されます。たとえば、変数を char(3) と定義し、これに 4 文字以上の値を設定すると、データが定義されたサイズに合わせて切り捨てられてから、INSERT または UPDATE ステートメントが成功します。

[ type_schema_name。 ] parameter_data_type

パラメーターのデータ型です。このデータ型が属するスキーマを指定することもできます。 Transact-SQL 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、timestamp を除くすべてのデータ型を指定できます。 CLR 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、text、ntext、image、timestamp を除くすべてのデータ型を指定できます。非スカラー型である cursor と table は、Transact-SQL または CLR 関数でパラメーターデータ型として指定できません。

type_schema_name が指定されていない場合、SQL Server データベースエンジンによって、次の順序で parameter_data_type が検索されます。

SQL Server システムデータ型の名前を含むスキーマ
現在のデータベースにおける現在のユーザーの既定のスキーマ。
現在のデータベースの dbo スキーマ。

[ = 既定値 ] **

パラメータのデフォルト値。 default 値が定義されている場合は、パラメーターに値を指定せずに関数を実行できます。

注

varchar(max) および varbinary(max) データ型の場合を除いて、CLR 関数には既定のパラメーター値を指定できます。

関数のパラメーターが既定値を持つ場合は、既定値を得るために、関数を呼び出すときに DEFAULT キーワードを指定する必要があります。この動作は、ストアドプロシージャで既定値を持つパラメーターを使用する場合とは異なります。ストアドプロシージャの場合は、パラメーターを省略すると既定値が暗黙的に使用されます。

return_data_type

スカラーユーザー定義関数の戻り値。 Transact-SQL 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、timestamp を除くすべてのデータ型を指定できます。 CLR 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、text、ntext、image、timestamp を除くすべてのデータ型を指定できます。非スカラー型である cursor と table は、Transact-SQL または CLR 関数で戻りデータ型として指定できません。

function_body

総合して副作用 (テーブルの変更など) がない一連の Transact-SQL ステートメントが、関数の値を定義することを指定します。 function_body は、スカラー関数と複数ステートメントのテーブル値関数でのみ使用されます。

スカラー関数の function_body は、総合してスカラー値と評価される一連の Transact-SQL ステートメントです。

複数ステートメントのテーブル値関数の function_body は、TABLE 戻り変数にデータを格納する一連の Transact-SQL ステートメントです。

scalar_expression

スカラー関数がスカラー値を返すように指定します。

テーブル

テーブル値関数の戻り値がテーブルになるように指定します。テーブル値関数に渡すことができるのは、定数と @local_variables だけです。

インラインテーブル値関数の TABLE 戻り値は、単一の SELECT ステートメントを使用して定義します。インライン関数には、関連付けられている戻り変数はありません。

複数ステートメントのテーブル値関数の @return_variable は TABLE 変数で、その関数の値として返される行の格納および蓄積に使用されます。 @ return_variable は、Transact-SQL 関数にのみ指定でき、CLR 関数には指定できません。

select-stmt

インラインテーブル値関数の戻り値を定義する単一の SELECT ステートメント。

EXTERNAL NAME <method_specifier>assembly_name.class_name。method_name

適用対象: SQL Server 2008 (10.0.x) 以降のバージョン。

関数にバインドするアセンブリのメソッドを指定します。 assembly_name は、表示がオンになっている現在のデータベースに存在する SQL Server のアセンブリと一致している必要があります。class_name は、有効な SQL Server 識別子であること、およびアセンブリにクラスとして存在していることが必要です。名前空間部分を区切るためにピリオド ( . ) を使う名前空間修飾名がクラスにある場合は、クラス名をかっこ ( [ ] ) または引用符 ( "" ) で区切る必要があります。 method_name は、有効な SQL Server 識別子であること、および指定されているクラスの静的メソッドとして存在していることが必要です。

注

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

注

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

< table_type_definition>( { <column_definition><column_constraint> | <computed_column_definition> } [ <table_constraint> ] [ ,...n ] )

Transact-SQL 関数のテーブルデータ型を定義します。テーブルの定義には、列の定義、および列またはテーブルの制約が含まれます。

< clr_table_type_definition > ( { column_namedata_type } [ ,...n ] )

適用対象: SQL Server 2008 (10.0.x) 以降、SQL Database (一部のリージョンではプレビュー)。

CLR 関数のテーブルデータ型を定義します。テーブルの定義には、列名およびデータ型のみが含まれます。

NULL|NOT NULL

ネイティブにコンパイルされた、スカラーユーザー定義関数でのみサポートされます。詳しくは、「インメモリ OLTP でのユーザー定義のスカラー関数」をご覧ください。

ネイティブコンパイル

ユーザー定義の関数をネイティブでコンパイルするかどうかを示します。この引数は、ネイティブにコンパイルされたスカラーユーザー定義関数に必要です。

NATIVE_COMPILATION 引数は、関数に対して ALTER を適用する場合に必要であり、関数が NATIVE_COMPILATION 引数を使用して作成されている場合にのみ使用できます。

アトミックの始まり

ネイティブにコンパイルされたスカラーユーザー定義関数でのみサポートされます。これは必須です。詳細については、ネイティブプロシージャのアトミックブロックを参照してください。

SCHEMABINDING

SCHEMABINDING の引数は、ネイティブにコンパイルされたスカラーユーザー定義関数に必要です。

<function_option>::= および <clr_function_option>::=

関数に以下のオプションを 1 つ以上指定します。

暗号化

適用対象: SQL Server 2008 (10.0.x) 以降のバージョン。

データベースエンジンが、 ALTER FUNCTION ステートメントのテキストを含むカタログビュー列を暗号化することを示します。 ENCRYPTION を使用すると、その関数を SQL Server レプリケーションの一部としてパブリッシュできなくなります。 CLR 関数には ENCRYPTION を指定できません。

SCHEMABINDING

参照するデータベースオブジェクトに対して、その関数がバインドされるように指定します。 SCHEMABINDING を指定した場合、ベースオブジェクトに対して関数定義に影響を与えるような変更は行えません。最初に関数定義自体を変更または削除して、変更するオブジェクトへの依存関係を削除する必要があります。

関数が参照するオブジェクトへのバインドは、次のいずれかの操作が行われた場合にのみ削除されます。

関数を削除した場合。
関数を、SCHEMABINDING オプションを指定せずに ALTER ステートメントを使用して変更した場合。

関数をスキーマバインドにする前に必要な条件の一覧については、「CREATE FUNCTION (Transact-SQL)」を参照してください。

NULL 入力で NULL を返す |NULL 入力で呼び出されました

スカラー値関数の OnNULLCall 属性を指定します。指定しない場合、デフォルトで CALLED ON NULL INPUT が暗黙的に指定されます。つまり、 NULL が引数として渡された場合でも、関数本体が実行されます。

CLR 関数で RETURNS NULL ON NULL INPUT が指定されている場合、受け取る引数のいずれかが NULL の場合に、関数の本体を実際に呼び出さずに SQL Server が NULL を返すことができることを示します。 <method_specifier>で指定されたメソッドに、RETURNS NULL ON NULL INPUTを示すカスタム属性が既にあるが、ALTER FUNCTION ステートメントがCALLED ON NULL INPUTを示している場合は、ALTER FUNCTION ステートメントが優先されます。 CLR テーブル値関数には、 OnNULLCall 属性を指定できません。

EXECUTE AS 句

ユーザー定義関数が実行されるセキュリティコンテキストを指定します。これにより、SQL Server が、関数で参照されているデータベースオブジェクトに対する権限を検証する際に使用するユーザーアカウントを制御できます。

注

インラインユーザー定義関数には EXECUTE AS を指定できません。

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

< column_definition >::=

Table データ型を定義します。テーブルの宣言には、列の定義および制約が含まれます。 CLR 関数では、column_name と data_type のみを指定できます。

column_name

テーブル内の列の名前。列名は、識別子のルールに従っていること、およびテーブル内で一意であることが必要です。 column_name は 1 ～ 128 文字で指定できます。

data_type

列のデータ型を指定します。 Transact-SQL 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、timestamp を除くすべてのデータ型を指定できます。 CLR 関数の場合は、CLR ユーザー定義型を含めたデータ型のうち、text、ntext、image、char、varchar、varchar(max)、timestamp を除くすべてのデータ型を指定できます。非スカラー型の cursor は、Transact-SQL 関数と CLR 関数の両方で、列のデータ型として指定できません。

デフォルトの constant_expression

挿入の際に明示的な値を指定しない場合に、列に入力される値を指定します。 constant_expression は、定数、 NULL、またはシステム関数の値です。 DEFAULT 定義は、IDENTITY プロパティを持つ列を除くすべての列に適用できます。 CLR テーブル値関数には DEFAULT を指定できません。

照合 collation_name

列の照合順序を指定します。指定しない場合、データベースの既定の照合順序が列に割り当てられます。照合順序名には、Windows 照合順序名または SQL 照合順序名を指定できます。詳細については、「 Windows 照合順序名」および「SQL Server 照合順序名」を参照してください。

COLLATE 句を使用して照合順序を変更できるのは、char、varchar、nchar、nvarchar データ型の列だけです。

CLR テーブル値関数には COLLATE を指定できません。

ROWGUIDCOL

新しい列が行グローバル一意識別子列であることを指定します。 ROWGUIDCOL 列として指定できるのは、テーブルごとに 1 つの uniqueidentifier 列だけです。 ROWGUIDCOL プロパティは、uniqueidentifier 列にのみ割り当てることができます。

ROWGUIDCOL プロパティは、列に格納されている値の一意性を設定しません。また、テーブルに挿入される新しい行の値を自動的に生成しません。各列に一意の値を生成するには、NEWID ステートメントで INSERT 関数を使用します。既定値を指定できます。ただし、 NEWID を既定値として指定することはできません。

アイデンティティ

新しい列が ID 列であることを指定します。テーブルに行が新しく追加されると、SQL Server は列に一意な増加値を設定します。 ID 列は通常、PRIMARY KEY 制約と共に使用され、テーブルの一意な行識別子 (ROWID) の役割を果たします。 IDENTITY プロパティは、tinyint、smallint、int、bigint、decimal(p,0) 、numeric(p,0) のいずれかの列に割り当てることができます。 ID 列は 1 つのテーブルにつき 1 つだけ作成できます。バインドされた既定値および DEFAULT 制約を ID 列と共に使用することはできません。 seed と increment は、両方を指定するか、どちらも指定しないでください。どちらも指定しないときの既定値は (1,1) です。

CLR テーブル値関数には IDENTITY を指定できません。

種

テーブルの最初のローに割り当てられる整数値。

インクリメント

テーブル内の連続するローの シード 値に追加する整数値。

< column_constraint >::= と < table_constraint>::=

指定された列またはテーブルの制約を定義します。 CLR 関数の場合、制約の種類として指定できるのは NULL だけです。名前付き制約は使用できません。

NULL |NOT NULL

列で NULL 値を許すかどうかを示します。 NULL は厳密には制約ではありませんが、 NOT NULLと同じように指定できます。 NOT NULL CLR テーブル値関数には指定できません。

主キー

一意のインデックスを使用して、指定した列のエンティティ整合性を強制する制約。テーブル値ユーザー定義関数では、1 つのテーブルにつき 1 つの列にのみ PRIMARY KEY 制約を作成できます。 CLR テーブル値関数には PRIMARY KEY を指定できません。

ユニーク

一意なインデックスによって、指定された 1 つ以上の列にエンティティの整合性を提供する制約。 1 つのテーブルには複数の UNIQUE 制約を指定できます。 CLR テーブル値関数には UNIQUE を指定できません。

CLUSTERED |NONCLUSTERED

PRIMARY KEY または UNIQUE 制約に対して、クラスター化インデックスまたは非クラスター化インデックスを作成することを示します。 PRIMARY KEY 制約では CLUSTERED が、UNIQUE 制約では NONCLUSTERED が、それぞれ使用されます。

CLUSTERED は 1 つの制約にのみ指定できます。 UNIQUE 制約で CLUSTERED が指定され、PRIMARY KEY 制約も指定した場合には、PRIMARY KEY は NONCLUSTERED を使用します。

CLR テーブル値関数には、CLUSTERED および NONCLUSTERED を指定できません。

確認

1 つ以上の列に入力できる値を制限することによってドメインの整合性を設定する制約。 CLR テーブル値関数には CHECK 制約を指定できません。

logical_expression

TRUE または FALSE を返す論理式。

<computed_column_definition>::=

計算列を指定します。計算列の詳細については、「CREATE TABLE (Transact-SQL)」を参照してください。

column_name

計算カラムの名前。

computed_column_expression

計算列の値を定義する式。

<index_option>::=

PRIMARY KEY インデックスまたは UNIQUE インデックスのインデックスオプションを指定します。インデックスオプションの詳細については、「CREATE INDEX (Transact-SQL)」を参照してください。

PAD_INDEX = { ON |OFF }

インデックスの埋め込みを指定します。既定値は OFF です。

FILLFACTOR = fillfactor

インデックスの作成時または変更時に、データベースエンジンが各インデックスページのリーフレベルをどの程度まで埋めるかを、パーセント値で指定します。 fillfactor 値には、1 ～ 100 の整数値を指定してください。既定値は 0 です。

IGNORE_DUP_KEY = { ON |OFF }

挿入操作で、一意のインデックスに重複するキー値を挿入しようとした場合のエラー応答を指定します。 IGNORE_DUP_KEY オプションは、インデックスが作成または再構築された後の挿入操作のみに適用されます。既定値は OFF です。

STATISTICS_NORECOMPUTE = { ON |OFF }

分布統計を再計算するかどうかを指定します。既定値は OFF です。

ALLOW_ROW_LOCKS = { ON |OFF }

行ロックを許可するかどうかを指定します。既定値は ON です。

ALLOW_PAGE_LOCKS = { ON |OFF }

ページロックを許可するかどうかを指定します。既定値は ON です。

解説

ALTER FUNCTION を使用してスカラー値関数をテーブル値関数に変更することも、その逆の変更を行うこともできません。さらに、ALTER FUNCTION を使用してインライン関数を複数ステートメント関数に変更することも、その逆の変更を行うこともできません。 ALTER FUNCTION を使用して Transact-SQL 関数を CLR 関数に変更したり、その逆の変更を行ったりすることもできません。

以下の Service Broker ステートメントは、Transact-SQL ユーザー定義関数の定義に含めることができません。

BEGIN DIALOG CONVERSATION
END CONVERSATION
GET CONVERSATION GROUP
MOVE CONVERSATION
RECEIVE
SEND

アクセス許可

関数またはスキーマに対する ALTER 権限が必要です。関数でユーザー定義型が指定されている場合は、その型に対する EXECUTE 権限が必要です。

Microsoft Fabric では、Fabric ワークスペース管理者ロール、メンバーロール、および共同作成者ロールのメンバーが関数を作成できます。

次の方法で共有

ALTER FUNCTION (Transact-SQL)

構文

引数

schema_name

function_name

@ parameter_name

[ type_schema_name。 ] parameter_data_type

[ = 既定値 ] **

return_data_type

function_body

scalar_expression

テーブル

select-stmt

EXTERNAL NAME <method_specifier>assembly_name.class_name。method_name

< table_type_definition>( { <column_definition><column_constraint> | <computed_column_definition> } [ <table_constraint> ] [ ,...n ] )

< clr_table_type_definition > ( { column_namedata_type } [ ,...n ] )

NULL|NOT NULL

ネイティブコンパイル

アトミックの始まり

SCHEMABINDING

暗号化

SCHEMABINDING

NULL 入力で NULL を返す |NULL 入力で呼び出されました

EXECUTE AS 句

column_name

data_type

デフォルトの constant_expression

照合 collation_name

ROWGUIDCOL

アイデンティティ

種

インクリメント

NULL |NOT NULL

主キー

ユニーク

CLUSTERED |NONCLUSTERED

確認

logical_expression

column_name

computed_column_expression

PAD_INDEX = { ON |OFF }

FILLFACTOR = fillfactor

IGNORE_DUP_KEY = { ON |OFF }

STATISTICS_NORECOMPUTE = { ON |OFF }

ALLOW_ROW_LOCKS = { ON |OFF }

ALLOW_PAGE_LOCKS = { ON |OFF }

解説

アクセス許可

関連コンテンツ

フィードバック

その他のリソース