Tutorial: Crear un procedimiento almacenado en código administrado

Artículo
10/07/2008

Actualización: noviembre 2007

Ya se pueden escribir los procedimientos almacenados para las bases de datos de SQL Server 2005 en código administrado mediante lenguajes de .NET Framework, como Visual Basic, C# y C++. Los procedimientos almacenados escritos en código administrado se denominan procedimientos almacenados de CLR.

Puede crear procedimientos almacenados de SQL agregando elementos de tipo Procedimiento almacenado a los proyectos de SQL Server. Después de implementar correctamente un SQL Server, se llaman y se ejecutan los procedimientos almacenados creados en código administrado como cualquier otro procedimiento almacenado.

Entre las tareas que se describen en este tutorial se incluyen las siguientes:

Crear un proyecto nuevo de Aplicación para Windows.
Crear un procedimiento almacenado en código administrado.
Implementar el procedimiento almacenado en una base de datos de SQL Server 2005.
Crear un script para probar el procedimiento almacenado en la base de datos.
Consultar datos en la base de datos para confirmar que el procedimiento almacenado se ejecuta correctamente.

Requisitos previos

Para poder completar este tutorial, necesitará:

Una conexión a la base de datos de ejemplo AdventureWorks que se ejecuta en SQL Server 2005. Para obtener más información, vea Cómo: Instalar bases de datos de ejemplo.

Crear el proyecto

Para crear el nuevo proyecto SQL Server

Desde el menú Archivo, cree un nuevo proyecto.
Seleccione Proyecto de SQL Server, asigne al proyecto el nombre SQLCLRStoredProcedure y haga clic en Aceptar. Para obtener más información, vea Cómo: Crear un proyecto de SQL Server.

Conectar a una base de datos de SQL Server 2005

Este tutorial requiere disponer de una conexión a la base de datos de ejemplo AdventureWorks que se ejecuta en SQL Server 2005. Si no hay ninguna conexión disponible a la base de datos de ejemplo AdventureWorks en el Explorador de servidores, se incluirá en la lista del Agregar referencia de base de datos (Cuadro de diálogo).

Nota:
De forma predeterminada, la característica de integración de Common Language Runtime (CLR) está desactivada en Microsoft SQL Server. Debe estar habilitada para poder usar elementos de proyecto de SQL Server. Para habilitar la integración de CLR, utilice la opción clr enabled del procedimiento almacenado sp_configure. Para obtener más información, vea Habilitación de la integración CLR.

Para conectarse a la base de datos de ejemplo AdventureWorks

Conéctese a la base de datos de ejemplo AdventureWorks incluida con SQL Server 2005 completando el cuadro de diálogo Agregar conexión. Para obtener más información, vea Agregar o modificar conexión (Microsoft SQL Server).

O bien
Seleccione una conexión existente a la base de datos de ejemplo AdventureWorks en el cuadro de diálogo Agregar referencia de base de datos. Para obtener más información, vea Agregar referencia de base de datos (Cuadro de diálogo).

Crear el procedimiento almacenado SQL Server

Después de crear el proyecto SQL Server, agréguele un procedimiento almacenado.

Para crear el procedimiento almacenado de SQL Server

En el menú Proyecto, haga clic en Agregar nuevo elemento.
Seleccione Procedimiento almacenado en Agregar nuevo elemento (Cuadro de diálogo).
Escriba InsertCurrency como Nombre para el nuevo procedimiento almacenado.
Haga clic en Agregar.

Reemplace el código en el Editor de código con lo siguiente:

Nota:
Los ejemplos en C++ se deben compilar con la opción /clr:safe del compilador.

Imports System
Imports System.Data
Imports System.Data.SqlClient
Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server

Partial Public Class StoredProcedures

    <SqlProcedure()> _
    Public Shared Sub InsertCurrency( _
        ByVal currencyCode As SqlString, ByVal name As SqlString)

        Using conn As New SqlConnection("context connection=true")

            Dim InsertCurrencyCommand As New SqlCommand()
            Dim currencyCodeParam As New SqlParameter("@CurrencyCode", SqlDbType.NVarChar)
            Dim nameParam As New SqlParameter("@Name", SqlDbType.NVarChar)

            currencyCodeParam.Value = currencyCode
            nameParam.Value = name


            InsertCurrencyCommand.Parameters.Add(currencyCodeParam)
            InsertCurrencyCommand.Parameters.Add(nameParam)

            InsertCurrencyCommand.CommandText = _
                "INSERT Sales.Currency (CurrencyCode, Name, ModifiedDate)" & _
                " VALUES(@CurrencyCode, @Name, GetDate())"

            InsertCurrencyCommand.Connection = conn

            conn.Open()
            InsertCurrencyCommand.ExecuteNonQuery()
            conn.Close()
        End Using
    End Sub
End Class

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;


public partial class StoredProcedures
{
    [SqlProcedure()]
    public static void InsertCurrency_CS(
        SqlString currencyCode, SqlString name)
    {
        using (SqlConnection conn = new SqlConnection("context connection=true"))
        {
            SqlCommand InsertCurrencyCommand = new SqlCommand();
            SqlParameter currencyCodeParam = new SqlParameter("@CurrencyCode", SqlDbType.NVarChar);
            SqlParameter nameParam = new SqlParameter("@Name", SqlDbType.NVarChar);

            currencyCodeParam.Value = currencyCode;
            nameParam.Value = name;

            InsertCurrencyCommand.Parameters.Add(currencyCodeParam);
            InsertCurrencyCommand.Parameters.Add(nameParam);

            InsertCurrencyCommand.CommandText =
                "INSERT Sales.Currency (CurrencyCode, Name, ModifiedDate)" +
                " VALUES(@CurrencyCode, @Name, GetDate())";

            InsertCurrencyCommand.Connection = conn;

            conn.Open();
            InsertCurrencyCommand.ExecuteNonQuery();
            conn.Close();
        }
    }
}

#include "stdafx.h"

#using <System.dll>
#using <System.Data.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Data;
using namespace System::Data::Sql;
using namespace System::Data::SqlClient;
using namespace System::Data::SqlTypes;
using namespace Microsoft::SqlServer::Server;

// In order to debug your Stored Procedure, add the following to your debug.sql file:
//
// EXEC InsertCurrency_CPP 'AAA', 'Currency Test'
// SELECT * FROM Sales.Currency WHERE CurrencyCode = 'AAA'

public ref class StoredProcedures
{
public:
    [SqlProcedure]
    static void InsertCurrency_CPP(SqlString currencyCode, SqlString name)
    {
        SqlConnection ^conn = gcnew SqlConnection("context connection=true");

        SqlCommand ^insertCurrencyCommand = gcnew SqlCommand();
        SqlParameter ^currencyCodeParam =
            gcnew SqlParameter("@CurrencyCode", SqlDbType::NVarChar);
        SqlParameter ^nameParam =
            gcnew SqlParameter("@Name", SqlDbType::NVarChar);

        insertCurrencyCommand->CommandText =
            "insert Sales.Currency(CurrencyCode, Name, ModifiedDate)" +
            " values(@CurrencyCode, @Name)";
        insertCurrencyCommand->Connection = conn;

        conn->Open();
        insertCurrencyCommand->ExecuteNonQuery();

        conn->Close();
    }
};

Implementar, ejecutar y depurar el procedimiento almacenado

Después de crear un nuevo procedimiento almacenado, se puede generar, implementar en el servidor SQL y depurar presionando F5. Primero, en el archivo Test.sql situado en la carpeta TestScripts de su proyecto, agregue código para ejecutar y probar su procedimiento almacenado. En Visual C++, este archivo se denomina debug.sql. Para obtener más información acerca de la creación de los scripts de prueba, vea Cómo: Editar la secuencia de comandos Test.sql para ejecutar objetos SQL.

Para obtener más información sobre la depuración de SQL, vea Depurar objetos de bases de datos SQL.

Para implementar y ejecutar el procedimiento almacenado InsertCurrency

Para Visual Basic y Visual C#, en el Explorador de soluciones, expanda la carpeta SecuenciasDePrueba y haga doble clic en el archivo Test.sql.

Para Visual C++, en el Explorador de soluciones, haga doble clic en el archivo debug.sql.

Sustituya el código del archivo Test.sql (debug.sql en Visual C++) por el código siguiente:

EXEC InsertCurrency 'AAA', 'Currency Test'
SELECT * from Sales.Currency where CurrencyCode = 'AAA'

Presione F5 para generar, implementar y depurar el procedimiento almacenado. Para obtener información sobre cómo implementar sin depurar, vea Cómo: Implementar elementos de proyecto de SQL Server en un servidor SQL Server.

Vea los resultados que se muestran en la ventana Resultados y seleccione Mostrar resultados desde: Resultado de base de datos.

Vea también

Tutorial: Crear un procedimiento almacenado en código administrado

Requisitos previos

Crear el proyecto

Para crear el nuevo proyecto SQL Server

Conectar a una base de datos de SQL Server 2005

Para conectarse a la base de datos de ejemplo AdventureWorks

Crear el procedimiento almacenado SQL Server

Para crear el procedimiento almacenado de SQL Server

Implementar, ejecutar y depurar el procedimiento almacenado

Para implementar y ejecutar el procedimiento almacenado InsertCurrency

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales