ユーザー定義関数の変更

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

SQL Server では、SQL Server Management Studio または Transact-SQL を使用してユーザー定義関数を変更できます。 以下に示す方法でユーザー定義関数を変更しても、関数の権限は変更されません。また、依存関数、ストアド プロシージャ、またはトリガーにも影響はありません。

制限事項と制約事項

ALTER FUNCTION を使用して次の操作を実行することはできません。

• スカラー値関数をテーブル値関数に変更したり、その逆の変更を行ったりする

• インライン関数を複数ステートメント関数に変更したり、その逆の変更を行ったりする

• Transact-SQL 関数を CLR 関数に変更したり、その逆の変更を行ったりする

アクセス許可

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

SQL Server Management Studio の使用 [SQL Server]

1. 変更する関数を含むデータベースの横にあるプラス記号を選択します。

2. Programmability フォルダーの横にあるプラス記号を選択します。

3. 変更する次の関数を含むフォルダーの横にあるプラス記号を選択します。

   • Table-valued Function

   • スカラー値関数

   • 集計関数

4. 変更する関数を右クリックし、 [変更]を選択します。

5. クエリ ウィンドウで、ALTER FUNCTION ステートメントに必要な変更を加えます。

6. [ファイル] メニューの [function_nameを保存]を選びます。

Transact-SQL の使用

1. オブジェクト エクスプローラーで、データベース エンジンのインスタンスに接続します。

2. 標準バーで、 [新しいクエリ] を選択します。

3. 次の例をコピーしてクエリ ウィンドウに貼り付け、[実行] を選択します。

   次のコード サンプルでは、スカラー値関数を変更します。

   -- Scalar-Valued Function
   USE [AdventureWorks2022]
   GO
   ALTER FUNCTION [dbo].[ufnGetAccountingEndDate]()
   RETURNS [datetime]
   AS
   BEGIN
       RETURN DATEADD(millisecond, -2, CONVERT(datetime, '20040701', 112));
   END;
   

   次のコード サンプルでは、テーブル値関数を変更します。

   -- Table-Valued Function
   USE [AdventureWorks2022]
   GO
   ALTER FUNCTION [dbo].[ufnGetContactInformation](@PersonID int)
   RETURNS @retContactInformation TABLE
   (
       -- Columns returned by the function
       [PersonID] int NOT NULL,
       [FirstName] [nvarchar](50) NULL,
       [LastName] [nvarchar](50) NULL,
       [JobTitle] [nvarchar](50) NULL,
       [BusinessEntityType] [nvarchar](50) NULL
   )
   AS
   -- Returns the first name, last name, job title and business entity type for the specified contact.
   -- Since a contact can serve multiple roles, more than one row may be returned.
   BEGIN
   IF @PersonID IS NOT NULL
   BEGIN
        IF EXISTS(SELECT * FROM [HumanResources].[Employee] e
        WHERE e.[BusinessEntityID] = @PersonID)
        INSERT INTO @retContactInformation
             SELECT @PersonID, p.FirstName, p.LastName, e.[JobTitle], 'Employee'
             FROM [HumanResources].[Employee] AS e
             INNER JOIN [Person].[Person] p ON p.[BusinessEntityID] = e.[BusinessEntityID]
             WHERE e.[BusinessEntityID] = @PersonID;
   
        IF EXISTS(SELECT * FROM [Purchasing].[Vendor] AS v
        INNER JOIN [Person].[BusinessEntityContact] bec ON bec.[BusinessEntityID] = v.[BusinessEntityID]
        WHERE bec.[PersonID] = @PersonID)
        INSERT INTO @retContactInformation
             SELECT @PersonID, p.FirstName, p.LastName, ct.[Name], 'Vendor Contact'
             FROM [Purchasing].[Vendor] AS v
             INNER JOIN [Person].[BusinessEntityContact] bec ON bec.[BusinessEntityID] = v.[BusinessEntityID]
             INNER JOIN [Person].ContactType ct ON ct.[ContactTypeID] = bec.[ContactTypeID]
             INNER JOIN [Person].[Person] p ON p.[BusinessEntityID] = bec.[PersonID]
             WHERE bec.[PersonID] = @PersonID;
   
        IF EXISTS(SELECT * FROM [Sales].[Store] AS s
        INNER JOIN [Person].[BusinessEntityContact] bec ON bec.[BusinessEntityID] = s.[BusinessEntityID]
        WHERE bec.[PersonID] = @PersonID)
        INSERT INTO @retContactInformation
             SELECT @PersonID, p.FirstName, p.LastName, ct.[Name], 'Store Contact'
             FROM [Sales].[Store] AS s
             INNER JOIN [Person].[BusinessEntityContact] bec ON bec.[BusinessEntityID] = s.[BusinessEntityID]
             INNER JOIN [Person].ContactType ct ON ct.[ContactTypeID] = bec.[ContactTypeID]
             INNER JOIN [Person].[Person] p ON p.[BusinessEntityID] = bec.[PersonID]
             WHERE bec.[PersonID] = @PersonID;
   
        IF EXISTS(SELECT * FROM [Person].[Person] AS p
        INNER JOIN [Sales].[Customer] AS c ON c.[PersonID] = p.[BusinessEntityID]
        WHERE p.[BusinessEntityID] = @PersonID AND c.[StoreID] IS NULL)
        INSERT INTO @retContactInformation
             SELECT @PersonID, p.FirstName, p.LastName, NULL, 'Consumer'
             FROM [Person].[Person] AS p
             INNER JOIN [Sales].[Customer] AS c ON c.[PersonID] = p.[BusinessEntityID]
             WHERE p.[BusinessEntityID] = @PersonID AND c.[StoreID] IS NULL;
        END
   RETURN;
   END;
   

関連項目

• ALTER FUNCTION (Transact-SQL)