Tutorial: Diseño de una base de datos relacional en Azure SQL Database con C# y ADO.NET

SE APLICA A: Azure SQL Database

Azure SQL Database es una base de datos como servicio (DBaaS) relacional en Microsoft Cloud (Azure). En este tutorial se aprenderá a usar Azure Portal y ADO.NET con Visual Studio para:

*Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Requisitos previos

Una instalación de Visual Studio 2019 o posterior.

Creación de una base de datos en blanco en Azure SQL Database

Se crea una base de datos en Azure SQL Database con un conjunto definido de recursos de proceso y almacenamiento. La base de datos se crea dentro de un grupo de recursos de Azure y se administra mediante un servidor SQL lógico.

Siga estos pasos para crear una base de datos en blanco.

1. Haga clic en Crear un recurso en la esquina superior izquierda de Azure Portal.

2. En la página Nuevo, seleccione Bases de datos en la sección de Microsoft Azure Marketplace y, a continuación, haga clic en SQL Database en la sección Destacados.

   

3. Rellene el formulario de SQL Database con la siguiente información, como se muestra en la imagen anterior:

   Configuración	Valor sugerido	Descripción
   Nombre de la base de datos	yourDatabase	Para conocer los nombres de base de datos válidos, consulte Identificadores de base de datos.
   Suscripción	yourSubscription	Para más información acerca de sus suscripciones, consulte Suscripciones.
   Grupos de recursos	yourResourceGroup	Para conocer cuáles son los nombres de grupo de recursos válidos, consulte el artículo Convenciones de nomenclatura.
   Seleccionar origen	Base de datos en blanco	Especifica que se debe crear una base de datos en blanco.

4. Haga clic en Servidor para usar un servidor existente o cree y configure un servidor nuevo. Seleccione un servidor existente o haga clic en Crear un nuevo servidor y rellene el formulario Nuevo servidor con la información siguiente:

   Configuración	Valor sugerido	Descripción
   Nombre del servidor	Cualquier nombre globalmente único	Para conocer cuáles son los nombres de servidor válidos, consulte el artículo Naming conventions (Convenciones de nomenclatura).
   Inicio de sesión del administrador del servidor	Cualquier nombre válido	Para conocer los nombres de inicio de sesión válidos, consulte Identificadores de base de datos.
   Contraseña	Cualquier contraseña válida	La contraseña debe tener un mínimo de ocho caracteres y debe usar caracteres de tres de las siguientes categorías: en mayúsculas, en minúsculas, números y no alfanuméricos.
   Ubicación	Cualquier ubicación válida	Para obtener información acerca de las regiones, consulte Regiones de Azure.

   

5. Haga clic en Seleccionar.

6. Haga clic en Plan de tarifa para especificar el nivel de servicio, el número de DTU o de núcleos virtuales y la cantidad de almacenamiento. Puede explorar las opciones del número de DTU o núcleos virtuales, y la cantidad de almacenamiento que están a su disposición para cada nivel de servicio.

   Después de seleccionar el nivel de servicio, el número de DTU o núcleos virtuales y la cantidad de almacenamiento, haga clic en Aplicar.

7. Introduzca una intercalación para la base de datos en blanco (para este tutorial, use el valor predeterminado). Para más información sobre las intercalaciones, vea Collations (Intercalaciones)

8. Una vez completado el formulario de SQL Database, haga clic en Crear para aprovisionar la base de datos. Esta operación puede tardar unos minutos.

9. En la barra de herramientas, haga clic en Notificaciones para supervisar el proceso de implementación.

   

Creación de una regla de firewall de IP de nivel de servidor

SQL Database crea un firewall de IP en el nivel de servidor. Este firewall evita que las herramientas y aplicaciones externas se conecten al servidor o a las bases de datos de este, a menos que una regla de firewall permita sus direcciones IP. Para habilitar la conectividad externa a la base de datos, primero debe agregar una regla de firewall para la dirección IP (o un intervalo de direcciones IP). Siga estos pasos para crear una regla de firewall de IP de nivel de servidor.

1. Cuando la implementación finalice, haga clic en Bases de datos SQL en el menú de la izquierda y, después, haga clic en yourDatabase en la página Bases de datos SQL. Se abre la página de información general de la base de datos, que muestra el nombre del servidor completo (por ejemplo, sample-svr.database.windows.net) y proporciona opciones para otras configuraciones.

2. Copie el nombre completo del servidor para conectarse a su servidor y a sus bases de datos de SQL Server Management Studio.

   

3. Haga clic en Establecer el firewall del servidor en la barra de herramientas. Se abrirá la página Configuración del firewall del servidor.

   

4. Haga clic en Agregar IP de cliente en la barra de herramientas para agregar la dirección IP actual a la nueva regla de firewall por IP. La regla de firewall de IP puede abrir el puerto 1433 para una única dirección IP o un intervalo de direcciones IP.

5. Haga clic en Save(Guardar). Se crea una regla de firewall de IP en el nivel de servidor para el puerto 1433 de la dirección IP actual en el servidor.

6. Haga clic en Aceptar y después cierre la página Configuración de firewall.

Ahora la dirección IP puede pasar a través del firewall de IP; además, puede conectarse a la base de datos mediante SQL Server Management Studio u otra herramienta que elija. Asegúrese de usar la cuenta de administración de servidor que creó anteriormente.

Ejemplo de programa C#

En las secciones siguientes de este artículo se presenta un programa C# que usa ADO.NET para enviar instrucciones Transact-SQL (T-SQL) a SQL Database. El programa C# muestra las acciones siguientes:

• Conexión a SQL Database mediante ADO.NET
• Métodos que devuelven instrucciones T-SQL
  • Crear tablas.
  • Rellenado de las tablas con datos
  • Actualización, eliminación y selección de datos
• Envío de T-SQL a la base de datos

Diagrama de relaciones de entidades (ERD)

Las instrucciones CREATE TABLE emplean la palabra clave REFERENCES para crear una relación de clave externa (FK) entre dos tablas. Si usa tempdb, convierta en comentario la palabra clave --REFERENCES con un par de guiones iniciales.

El ERD muestra la relación entre ambas tablas. Los valores de la columna child de tabEmployee.DepartmentCode están limitados a los valores de la columna parent de tabDepartment.DepartmentCode.

Para compilarlo y ejecutarlo

El programa en C# es lógicamente un archivo .cs y se divide físicamente en varios bloques de código, para que cada bloque resulte más fácil de comprender. Para compilar y ejecutar este programa, realice los pasos siguientes:

1. Cree un proyecto C# en Visual Studio. El tipo de proyecto debe ser una Consola, que se encuentra en Plantillas > Visual C# > Escritorio de Windows > Aplicación de consola (.NET Framework) .

2. En el archivo Program.cs, reemplace las líneas de código iniciales con los pasos siguientes:

   1. Copie y pegue los siguientes bloques de código, en la misma secuencia que se presentan. Consulte Conexión a la base de datos, Generación de T-SQL y Envío a la base de datos.

   2. Cambie los valores siguientes en el método Main:

      • cb.DataSource
      • cb.UserID
      • cb.Password
      • cb.InitialCatalog

3. Compruebe que se haga referencia al ensamblado System.Data.dll. Para comprobarlo, expanda el nodo Referencias en el panel Explorador de soluciones.

4. Para compilar y ejecutar el programa desde Visual Studio, seleccione el botón Iniciar. La salida del informe se muestra en una ventana de programa, aunque los valores de GUID variarán entre series de pruebas.

   =================================
   T-SQL to 2 - Create-Tables...
   -1 = rows affected.
   
   =================================
   T-SQL to 3 - Inserts...
   8 = rows affected.
   
   =================================
   T-SQL to 4 - Update-Join...
   2 = rows affected.
   
   =================================
   T-SQL to 5 - Delete-Join...
   2 = rows affected.
   
   =================================
   Now, SelectEmployees (6)...
   8ddeb8f5-9584-4afe-b7ef-d6bdca02bd35 , Alison , 20 , acct , Accounting
   9ce11981-e674-42f7-928b-6cc004079b03 , Barbara , 17 , hres , Human Resources
   315f5230-ec94-4edd-9b1c-dd45fbb61ee7 , Carol , 22 , acct , Accounting
   fcf4840a-8be3-43f7-a319-52304bf0f48d , Elle , 15 , NULL , NULL
   View the report output here, then press any key to end the program...
   

Conexión a SQL Database mediante ADO.NET

using System;
using System.Data.SqlClient;   // System.Data.dll
//using System.Data;           // For:  SqlDbType , ParameterDirection

namespace csharp_db_test
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                var cb = new SqlConnectionStringBuilder();
                cb.DataSource = "your_server.database.windows.net";
                cb.UserID = "your_user";
                cb.Password = "your_password";
                cb.InitialCatalog = "your_database";

                using (var connection = new SqlConnection(cb.ConnectionString))
                {
                    connection.Open();

                    Submit_Tsql_NonQuery(connection, "2 - Create-Tables", Build_2_Tsql_CreateTables());

                    Submit_Tsql_NonQuery(connection, "3 - Inserts", Build_3_Tsql_Inserts());

                    Submit_Tsql_NonQuery(connection, "4 - Update-Join", Build_4_Tsql_UpdateJoin(),
                        "@csharpParmDepartmentName", "Accounting");

                    Submit_Tsql_NonQuery(connection, "5 - Delete-Join", Build_5_Tsql_DeleteJoin(),
                        "@csharpParmDepartmentName", "Legal");

                    Submit_6_Tsql_SelectEmployees(connection);
                }
            }
            catch (SqlException e)
            {
                Console.WriteLine(e.ToString());
            }

            Console.WriteLine("View the report output here, then press any key to end the program...");
            Console.ReadKey();
        }

Métodos que devuelven instrucciones T-SQL

static string Build_2_Tsql_CreateTables()
{
    return @"
        DROP TABLE IF EXISTS tabEmployee;
        DROP TABLE IF EXISTS tabDepartment;  -- Drop parent table last.

        CREATE TABLE tabDepartment
        (
            DepartmentCode  nchar(4)          not null    PRIMARY KEY,
            DepartmentName  nvarchar(128)     not null
        );

        CREATE TABLE tabEmployee
        (
            EmployeeGuid    uniqueIdentifier  not null  default NewId()    PRIMARY KEY,
            EmployeeName    nvarchar(128)     not null,
            EmployeeLevel   int               not null,
            DepartmentCode  nchar(4)              null
            REFERENCES tabDepartment (DepartmentCode)  -- (REFERENCES would be disallowed on temporary tables.)
        );
    ";
}

static string Build_3_Tsql_Inserts()
{
    return @"
        -- The company has these departments.
        INSERT INTO tabDepartment (DepartmentCode, DepartmentName)
        VALUES
            ('acct', 'Accounting'),
            ('hres', 'Human Resources'),
            ('legl', 'Legal');

        -- The company has these employees, each in one department.
        INSERT INTO tabEmployee (EmployeeName, EmployeeLevel, DepartmentCode)
        VALUES
            ('Alison'  , 19, 'acct'),
            ('Barbara' , 17, 'hres'),
            ('Carol'   , 21, 'acct'),
            ('Deborah' , 24, 'legl'),
            ('Elle'    , 15, null);
    ";
}

static string Build_4_Tsql_UpdateJoin()
{
    return @"
        DECLARE @DName1  nvarchar(128) = @csharpParmDepartmentName;  --'Accounting';

        -- Promote everyone in one department (see @parm...).
        UPDATE empl
        SET
            empl.EmployeeLevel += 1
        FROM
            tabEmployee   as empl
        INNER JOIN
            tabDepartment as dept ON dept.DepartmentCode = empl.DepartmentCode
        WHERE
            dept.DepartmentName = @DName1;
    ";
}

static string Build_5_Tsql_DeleteJoin()
{
    return @"
        DECLARE @DName2  nvarchar(128);
        SET @DName2 = @csharpParmDepartmentName;  --'Legal';

        -- Right size the Legal department.
        DELETE empl
        FROM
            tabEmployee   as empl
        INNER JOIN
            tabDepartment as dept ON dept.DepartmentCode = empl.DepartmentCode
        WHERE
            dept.DepartmentName = @DName2

        -- Disband the Legal department.
        DELETE tabDepartment
            WHERE DepartmentName = @DName2;
    ";
}

static string Build_6_Tsql_SelectEmployees()
{
    return @"
        -- Look at all the final Employees.
        SELECT
            empl.EmployeeGuid,
            empl.EmployeeName,
            empl.EmployeeLevel,
            empl.DepartmentCode,
            dept.DepartmentName
        FROM
            tabEmployee   as empl
        LEFT OUTER JOIN
            tabDepartment as dept ON dept.DepartmentCode = empl.DepartmentCode
        ORDER BY
            EmployeeName;
    ";
}

Envío de T-SQL a la base de datos

static void Submit_6_Tsql_SelectEmployees(SqlConnection connection)
{
    Console.WriteLine();
    Console.WriteLine("=================================");
    Console.WriteLine("Now, SelectEmployees (6)...");

    string tsql = Build_6_Tsql_SelectEmployees();

    using (var command = new SqlCommand(tsql, connection))
    {
        using (SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine("{0} , {1} , {2} , {3} , {4}",
                    reader.GetGuid(0),
                    reader.GetString(1),
                    reader.GetInt32(2),
                    (reader.IsDBNull(3)) ? "NULL" : reader.GetString(3),
                    (reader.IsDBNull(4)) ? "NULL" : reader.GetString(4));
            }
        }
    }
}

static void Submit_Tsql_NonQuery(
    SqlConnection connection,
    string tsqlPurpose,
    string tsqlSourceCode,
    string parameterName = null,
    string parameterValue = null
    )
{
    Console.WriteLine();
    Console.WriteLine("=================================");
    Console.WriteLine("T-SQL to {0}...", tsqlPurpose);

    using (var command = new SqlCommand(tsqlSourceCode, connection))
    {
        if (parameterName != null)
        {
            command.Parameters.AddWithValue(  // Or, use SqlParameter class.
                parameterName,
                parameterValue);
        }
        int rowsAffected = command.ExecuteNonQuery();
        Console.WriteLine(rowsAffected + " = rows affected.");
    }
}
} // EndOfClass
}

Pasos siguientes

En este tutorial, aprendió tareas básicas de las bases de datos como crear una base de datos y tablas, conectarse a la base de datos, cargar datos y ejecutar consultas. Ha aprendido a:

Prosiga con el tutorial siguiente para aprender sobre la migración de datos.