Modificar funções definidas pelo usuário

Aplica-se a:SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Você pode modificar funções definidas pelo usuário no SQL Server usando o SQL Server Management Studio ou o Transact-SQL. Modificar funções definidas pelo usuário conforme descrito abaixo não alterará as permissões das funções, nem afetará quaisquer funções dependentes, procedimentos armazenados ou gatilhos.

Limitações e restrições

ALTER FUNCTION não pode ser usado para realizar nenhuma das seguintes ações:

• Altere uma função com valor escalar para uma função com valor de tabela ou vice-versa.

• Altere uma função embutida para uma função com múltiplas instruções ou vice-versa.

• Altere uma função Transact-SQL para uma função CLR ou vice-versa.

Permissões

Requer permissão ALTER na função ou no esquema. Se a função especificar um tipo definido pelo usuário, exigirá a permissão EXECUTE no tipo.

Utilize o SQL Server Management Studio

1. Selecione o sinal de adição ao lado do banco de dados que contém a função que você deseja modificar.

2. Selecione o sinal de adição ao lado da pasta Programabilidade.

3. Selecione o sinal de mais ao lado da pasta que contém a função que você deseja modificar:

   • Função com valor de tabela

   • Função com valor escalar

   • Função Agregar

4. Clique com o botão direito do rato na função que pretende modificar e selecione Modificar.

5. Na Janela de Consulta, faça as alterações necessárias à ALTER FUNCTION instrução.

6. No menu Arquivo, selecione Salvarfunction_name.

Utilize o Transact-SQL

1. No Pesquisador de Objetos , conecte-se a uma instância do Mecanismo de Banco de Dados.

2. Na barra Padrão, selecione Nova Consulta.

3. Copie e cole os exemplos a seguir na janela de consulta e selecione Executar.

   O exemplo de código a seguir altera uma função com valor escalar.

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

   O exemplo de código a seguir altera uma função com valor de tabela.

   -- 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;
   

Conteúdo relacionado

• ALTER FUNCTION (Transact-SQL)