ALTER PROCEDURE (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de SQL Analytics en Microsoft FabricAlmacén en Microsoft FabricBase de datos SQL en Microsoft Fabric

Modifica un procedimiento previamente creado ejecutando la CREATE PROCEDURE instrucción en SQL Server.

Convenciones de sintaxis de Transact-SQL (Transact-SQL)

Sintaxis

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

Argumentos

schema_name
El nombre del esquema al que pertenece el procedimiento.

procedure_name
El nombre del procedimiento que se va a cambiar. Los nombres de los procedimientos se deben ajustar a las reglas para los identificadores.

;number
Un entero opcional existente que se utiliza para agrupar procedimientos con el mismo nombre de modo que puedan ser eliminados juntos usando una sola DROP PROCEDURE sentencia.

@ parameter_name
Parámetro del procedimiento. Se pueden especificar hasta 2.100 parámetros.

[ type_schema_name. ] data_type
Es el tipo de datos del parámetro y el esquema al que pertenece.

Para información sobre las restricciones de tipos de datos, véase CREATE PROCEDURE (Transact-SQL).

VARYING
Especifica el conjunto de resultados admitido como parámetro de salida. Este parámetro se genera dinámicamente por medio del procedimiento almacenado y su contenido puede variar. Solo se aplica a los parámetros de cursor. Esta opción no es válida para los procedimientos CLR.

default
Es un valor predeterminado para el parámetro.

OUT | SALIDA
Indica que se trata de un parámetro devuelto.

READONLY
Indica que el parámetro no se puede actualizar ni modificar dentro del cuerpo del procedimiento. Si el tipo de parámetro es un tipo con valores de tabla, se debe especificar READONLY.

RECOMPILE
Indica que Motor de base de datos no almacena en la memoria caché ningún plan para este procedimiento y el procedimiento se vuelve a compilar en tiempo de ejecución.

ENCRYPTION
Se aplica a: SQL Server (SQL Server 2008 [10.0.x] y versiones posteriores) y Azure SQL Database.

Indica que el Motor de base de datos convertirá el texto original de la ALTER PROCEDURE declaración a un formato ofuscado. La salida de la protección no es directamente visible en ninguna de las vistas de catálogo de SQL Server. Los usuarios que no disponen de acceso a las tablas del sistema o a los archivos de base de datos no pueden recuperar el texto protegido. En cambio, estará disponible para los usuarios con privilegios que puedan obtener acceso a las tablas del sistema a través del puerto DAC o directamente a los archivos de base de datos. Además, los usuarios que pueden adjuntar un depurador al proceso del servidor pueden recuperar el procedimiento original de la memoria en tiempo de ejecución. Para más información sobre cómo tener acceso al sistema, vea Configuración de visibilidad de los metadatos.

Los procedimientos creados mediante esta opción no se pueden publicar como parte de la replicación de SQL Server.

Esta opción no se puede especificar para procedimientos almacenados de Common Language Runtime (CLR).

EXECUTE AS
Especifica el contexto de seguridad en el que se debe ejecutar el procedimiento almacenado una vez que se obtiene acceso al mismo.

Para obtener más información, vea EXECUTE AS Cláusula (Transact-SQL).

PARA REPLICACIÓN

Especifica que los procedimientos almacenados creados para la replicación no se pueden ejecutar en el suscriptor. Se utiliza un procedimiento almacenado creado con la opción FOR REPLICATION como un filtro de procedimiento almacenado y solo se ejecuta durante la replicación. No se pueden declarar los parámetros si se especifica FOR REPLICATION. Esta opción no es válida para los procedimientos CLR. La opción RECOMPILE no se tiene en cuenta en el caso de procedimientos creados con FOR REPLICATION.

{ [ BEGIN ] sql_statement [;] [ ... n ] [ END ] }
Una o más instrucciones Transact-SQL que comprenden el cuerpo del procedimiento. Puede usar las palabras clave BEGIN y END opcionales para incluir las instrucciones. Para más información, consulte las secciones de Mejores Prácticas, Comentarios Generales y Limitaciones y Restricciones en CREATE PROCEDURE (Transact-SQL).

NOMBRE EXTERNO assembly_name.class_name.method_name
Se aplica a: SQL Server 2008 (10.0.x) y versiones posteriores.

Especifica el método de un ensamblado de .NET Framework para un procedimiento CLR almacenado al que se va a hacer referencia. class_name debe ser un identificador SQL Server válido y debe existir como clase en el ensamblado. Si la clase tiene un nombre calificado como espacio de nombres que utiliza un punto (.) para separar las partes del espacio de nombres, el nombre de la clase debe estar delimitado por corchetes ([]) o comillas (""). El método especificado debe ser un método estático de la clase.

De manera predeterminada, SQL Server no puede ejecutar código CLR. Se pueden crear, modificar y quitar objetos de base de datos que hagan referencia a módulos de Common Language Runtime, pero estas referencias no se pueden ejecutar en SQL Server hasta que se habilite la opción clr enabled. Para habilitar esta opción, use sp_configure.

Notas generales

Transact-SQL no se pueden modificar para que sean procedimientos almacenados CLR y viceversa.

ALTER PROCEDURE no cambia permisos ni afecta a ningún procedimiento almacenado o disparador dependiente. Sin embargo, los ajustes actuales de sesión para QUOTED_IDENTIFIER y ANSI_NULLS se incluyen en el procedimiento almacenado cuando se modifica. Si la configuración es distinta de la que se estaba aplicando cuando se creó originalmente el procedimiento almacenado, el comportamiento de este último puede cambiar.

Si se creó una definición de procedimiento anterior usando CON CIFRADO o CON RECOMPILACIÓN, estas opciones solo se habilitan si están incluidas en ALTER PROCEDURE.

Para más información sobre procedimientos almacenados, véaseCREATE PROCEDURE (Transact-SQL).

Seguridad

Permisos

Necesita el permiso ALTER en el procedimiento o la pertenencia al rol fijo de base de datos db_ddladmin.

Ejemplos

En el siguiente ejemplo se crea el procedimiento almacenado uspVendorAllInfo. Este procedimiento devuelve los nombres de todos los proveedores que proporciona Adventure Works Cycles, los productos que suministran, su solvencia y su disponibilidad. Después de crear este procedimiento, se modifica para devolver un conjunto de resultados diferente.

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    

En el ejemplo siguiente se modifica el procedimiento almacenado uspVendorAllInfo. Elimina la EXECUTE AS cláusula CALLER y modifica el cuerpo del procedimiento para devolver solo a los proveedores que suministran el producto especificado. Las funciones LEFT y CASE permiten personalizar la apariencia del conjunto de resultados.

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  

Este es el conjunto de resultados.

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

Consulte también

CREATE PROCEDURE (Transact-SQL)
DROP PROCEDURE (Transact-SQL)
EJECUTAR (Transact-SQL)
EXECUTE AS (Transact-SQL)
EVENTDATA (Transact-SQL)
Procedimientos almacenados (motor de base de datos)
sys.procedures (Transact-SQL)