ALTER PROCEDURE (Transact-SQL)

Articolo
10/16/2024

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL in Microsoft Fabric Warehouse in Microsoft Fabric

Modifica una procedura creata in precedenza tramite l'istruzione CREATE PROCEDURE in SQL Server.

Convenzioni della sintassi Transact-SQL (Transact-SQL)

Sintassi

-- 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 ] }  
[;]

Argomenti

schema_name
Nome dello schema a cui appartiene la procedura.

procedure_name
Nome della procedura da modificare. I nomi delle procedure devono essere conformi alle regole per gli identificatori.

; number
Integer facoltativo esistente usato per raggruppare procedure con lo stesso nome in modo da poter rimuoverle tramite un'unica istruzione DROP PROCEDURE.

Nota

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

@parameter_name
Parametro della procedura. È possibile specificare un massimo di 2.100 parametri.

[ type_schema_name. ] data_type
Tipo di dati del parametro e schema a cui appartiene.

Per informazioni sulle restrizioni dei tipi di dati, vedere CREATE PROCEDURE (Transact-SQL).

VARYING
Specifica il set di risultati supportato come parametro di output. Questo parametro viene creato in modo dinamico dalla stored procedure e il relativo contenuto può variare. Viene usato solo con parametri di cursore. Questa opzione non è valida per le procedure CLR.

default
Valore predefinito del parametro.

OUT | OUTPUT
Indica che si tratta di un parametro restituito.

READONLY
Indica che il parametro non può essere aggiornato o modificato all'interno del corpo della procedura. Se si tratta di un tipo di parametro con valori di tabella, è necessario specificare la parola chiave READONLY.

RECOMPILE
Indica che il motore di database non memorizza nella cache un piano per la procedura e che la procedura viene ricompilata in fase di esecuzione.

ENCRYPTION
Si applica a: SQL Server ( SQL Server 2008 (10.0.x) e versioni successive) e database SQL di Azure.

Indica che il testo originale dell'istruzione ALTER PROCEDURE verrà convertito dal motore di database in un formato offuscato. L'output in formato offuscato non è visibile direttamente in alcuna vista del catalogo in SQL Server. Gli utenti che non hanno accesso a tabelle di sistema o file del database non possono recuperare il testo offuscato. Il testo è tuttavia disponibile per gli utenti con privilegi che consentono l'accesso alle tabelle di sistema attraverso la porta DAC o l'accesso diretto a file del database. Gli utenti in grado di collegare un debugger al processo del server possono inoltre recuperare la procedura originale dalla memoria in fase di esecuzione. Per altre informazioni sull'accesso ai metadati di sistema, vedere Configurazione della visibilità dei metadati.

Le procedure create con questa opzione non possono essere pubblicate durante la replica di SQL Server.

Questa opzione non può essere specificata per stored procedure CLR (Common Language Runtime).

Nota

Durante un aggiornamento, il motore di database usa i commenti offuscati archiviati in sys.sql_modules per ricreare procedure.

EXECUTE AS
Specifica il contesto di sicurezza in cui deve essere eseguita la stored procedure dopo l'accesso.

Per altre informazioni, vedere Clausola EXECUTE AS (Transact-SQL).

FOR REPLICATION

Specifica che le stored procedure create per la replica non possono essere eseguite nel Sottoscrittore. Una stored procedure creata con l'opzione FOR REPLICATION viene usata come filtro di stored procedure ed eseguita solo durante la replica. Se viene specificata l'opzione FOR REPLICATION, non è possibile dichiarare alcun parametro. Questa opzione non è valida per le procedure CLR. L'opzione RECOMPILE viene ignorata per le procedure create con l'opzione FOR REPLICATION.

Nota

Questa opzione non è disponibile in un database indipendente.

{ [ BEGIN ] sql_statement [;] [ ...n ] [ END ] }
Una o più istruzioni Transact-SQL che includono il corpo della procedura. Per racchiudere le istruzioni è possibile usare le parole chiave facoltative BEGIN ed END. Per altre informazioni, vedere le sezioni Procedure consigliate, Osservazioni generali e Limitazioni e restrizioni in CREATE PROCEDURE (Transact-SQL).

EXTERNAL NAME assembly_name.class_name.method_name
Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

Specifica il metodo di un assembly .NET Framework affinché una stored procedure CLR vi faccia riferimento. class_name deve essere un identificatore valido di SQL Server e deve esistere come classe nell'assembly. Se alla classe è stato assegnato un nome completo con lo spazio dei nomi le cui parti sono separate da un punto (.), il nome della classe deve essere delimitato tramite parentesi quadre ([]) o virgolette (""). Il metodo specificato deve essere un metodo statico della classe.

Per impostazione predefinita, SQL Server non può eseguire il codice CLR. È possibile creare, modificare ed eliminare gli oggetti di database che fanno riferimento a moduli CLR; tuttavia non è possibile eseguire questi riferimenti in SQL Server finché non viene abilitata l'opzione clr enabled. Per abilitare questa opzione, usare sp_configure.

Nota

Le procedure CLR non sono supportate in un database indipendente.

Osservazioni generali

Le stored procedure Transact-SQL non possono essere modificate dalle stored procedure CLR e viceversa.

ALTER PROCEDURE non modifica le autorizzazioni e non ha effetto sulle stored procedure o sui trigger dipendenti. Le impostazioni della sessione corrente per QUOTED_IDENTIFIER e ANSI_NULLS, tuttavia, vengono incluse nella stored procedure quando viene modificata. Se queste impostazioni sono diverse rispetto a quelle applicate quando la stored procedure è stata creata, il funzionamento della stored procedure potrebbe cambiare.

Se una definizione di procedura precedente è stata creata tramite l'opzione WITH ENCRYPTION o WITH RECOMPILE, tale opzione viene abilitata solo se è inclusa nell'istruzione ALTER PROCEDURE.

Per altre informazioni, sulle stored procedure, vedere CREATE PROCEDURE (Transact-SQL).

Sicurezza

Autorizzazioni

È richiesta l'autorizzazione ALTER per la procedura o l'appartenenza al ruolo predefinito del database db_ddladmin.

Esempi

Nell'esempio seguente si crea la stored procedure uspVendorAllInfo, che restituisce i nomi di tutti i fornitori di Adventure Works Cycles, i prodotti da essi forniti nonché le informazioni relative alla posizione creditizia e alla disponibilità. Questa procedura viene quindi modificata in modo da restituire un set di risultati diverso.

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

Nell'esempio seguente viene modificata la stored procedure uspVendorAllInfo. Viene rimossa la clausola EXECUTE AS CALLER e modificato il corpo della procedura in modo da restituire solo i fornitori del prodotto specificato. Le funzioni LEFT e CASE personalizzano l'aspetto del set di risultati.

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

Il set di risultati è il seguente.

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

Vedi anche

CREATE PROCEDURE (Transact-SQL)
DROP PROCEDURE (Transact-SQL)
EXECUTE (Transact-SQL)
EXECUTE AS (Transact-SQL)
EVENTDATA (Transact-SQL)
Stored procedure (Motore di database)
sys.procedures (Transact-SQL)

Condividi tramite

ALTER PROCEDURE (Transact-SQL)

Sintassi

Argomenti

Osservazioni generali

Sicurezza

Autorizzazioni

Esempi

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive