Diseño e implementación de una estrategia de prueba

Completados

Un proyecto de base de datos SQL que se compila correctamente no significa que los procedimientos almacenados dentro de él devuelvan los resultados correctos. Un procedimiento puede compilar sin errores y calcular los totales incorrectos o omitir una comprobación de validación. Las pruebas detectan estos problemas antes de llegar a producción.

Descripción de los niveles de pruebas de base de datos

Las pruebas de base de datos funcionan en capas, cada una de las cuales detecta una clase de problema diferente:

  • La validación de compilación es el paso dotnet build que ya tiene. Detecta errores de sintaxis y referencias a objetos rotos. Rápido, pero solo demuestra que el esquema es estructuralmente válido.
  • Las pruebas unitarias comprueban que los procedimientos almacenados individuales y las funciones generan los resultados adecuados para un conjunto determinado de entradas. Detectan errores lógicos.
  • Las pruebas de integración ejecutan escenarios de extremo a extremo contra una base de datos implementada. Demuestran que los objetos funcionan correctamente, pero requieren una instancia en ejecución y tardan más tiempo.

Cada capa es más lenta y costosa que la anterior, pero también detecta problemas que la capa anterior no puede.

Creación de pruebas unitarias de SQL Server

SQL Server Data Tools (SSDT) en Visual Studio incluye un marco integrado para pruebas unitarias de base de datos. Cada prueba ejecuta T-SQL en una base de datos activa y valida los resultados mediante condiciones de prueba.

Estructura de una prueba unitaria

Cada prueba tiene tres secciones que siguen un patrón de configuración-ejecución-limpieza.

  • Prueba previa: configure los datos que necesita la prueba. Inserte los registros de cliente y borre los datos que quedan de las ejecuciones anteriores.
  • Prueba: ejecute la operación que está probando. Llame al procedimiento almacenado y consulte la vista.
  • Posterior a la prueba: limpie después de la prueba para que no contamine la siguiente ejecución.

Condiciones de prueba

Después de que se ejecute la prueba T-SQL, las condiciones de prueba validan los resultados obtenidos. Las condiciones más usadas son:

  • Recuento de filas: comprueba que el conjunto de resultados contiene el número esperado de filas.
  • Valor escalar: comprueba que una celda específica del conjunto de resultados contiene el valor esperado.
  • Esquema esperado: comprueba que el conjunto de resultados tiene los nombres de columna y los tipos de datos esperados.

Otras condiciones integradas incluyen la suma de comprobación de datos, el Conjunto de Resultados Vacíos, el Conjunto de Resultados No Vacío y el Tiempo de Ejecución.

Creación de un proyecto de prueba unitaria

La configuración de pruebas unitarias de SQL Server en Visual Studio realiza algunos pasos:

  1. Abra el proyecto de base de datos SQL.
  2. En el Explorador de objetos de SQL Server, busque el procedimiento almacenado o la función que desea probar.
  3. Haga clic con el botón derecho en el objeto y seleccione Crear pruebas unitarias.
  4. Elija o cree un proyecto de prueba de C#.
  5. Establezca la conexión de prueba a la base de datos de desarrollo.
  6. Seleccione Implementar automáticamente el proyecto de base de datos antes de ejecutar pruebas unitarias. Esta opción mantiene sincronizada la base de datos de prueba con los cambios más recientes del proyecto.

El diseñador se abre con una plantilla de T-SQL donde se escribe la lógica de prueba y se adjuntan condiciones de prueba.

Escribir pruebas unitarias de base de datos eficaces

Una buena prueba unitaria responde a una pregunta específica: "¿Hace este procedimiento lo que se supone para una entrada conocida?" Este es un ejemplo que prueba uspPlaceNewOrder, comprobando que la realización de un pedido actualiza correctamente el total anual del cliente:

-- Pre-test: Set up customer and clear previous data
DECLARE @CustomerID INT;
INSERT INTO [Sales].[Customer] (CustomerName) VALUES (N'Test Customer');
SET @CustomerID = SCOPE_IDENTITY();
DELETE FROM [Sales].[Orders] WHERE [CustomerID] = @CustomerID;

-- Test: Place an order and verify YTDOrders updated correctly
DECLARE @RC INT;
EXECUTE @RC = [Sales].[uspPlaceNewOrder] @CustomerID, 100, GETDATE(), 'O';

SELECT [YTDOrders]
FROM [Sales].[Customer]
WHERE [CustomerID] = @CustomerID;

📝 Empareja esta prueba de T-SQL con una condición de prueba Valor escalar que espera que el YTDOrders valor sea 100.

Pruebas negativas

También debe comprobar que los procedimientos almacenados producen un error correctamente cuando reciben entradas no válidas. Por ejemplo, cancelar un pedido que ya se envió debe generar un error, no se realiza correctamente de forma silenciosa. Una prueba negativa confirma que se produce el error esperado.

Al seleccionar Crear pruebas unitarias en el paso 3 de la sección anterior, Visual Studio genera un proyecto de prueba de C# en el Explorador de soluciones con un .cs archivo que contiene una prueba para cada procedimiento almacenado seleccionado. Por ejemplo, si creó una prueba para uspCancelOrder, el archivo generado incluye una sección denominada Sales_uspCancelOrder_Test. Para marcar esa prueba como prueba negativa, abra el archivo en el .csExplorador de soluciones y agregue el ExpectedSqlException atributo directamente encima de ella y guarde el archivo:

[TestMethod()]
[ExpectedSqlException(Severity = 16, MatchFirstError = false, State = 1)]
public void Sales_uspCancelOrder_FilledOrder_Test()

La prueba solo se supera cuando el procedimiento almacenado genera un error que coincide con la gravedad y el estado especificados. Si el procedimiento se realiza silenciosamente de forma correcta, la prueba falla, que es exactamente lo que desea.

Diseño de un enfoque de prueba de integración

Las pruebas unitarias aíslan objetos individuales. Las pruebas de integración van más allá y prueban escenarios que abarcan varias operaciones. Responden a preguntas como:

  • ¿Una secuencia de llamadas a procedimiento almacenado deja la base de datos en el estado esperado?
  • ¿Los desencadenadores se activan correctamente cuando llegan los datos a través de la capa de aplicación?
  • ¿Las vistas devuelven resultados precisos después de una serie de cambios de tabla relacionados?

Las pruebas de integración necesitan una base de datos dedicada. Implemente el proyecto de base de datos SQL en una instancia de prueba antes de cada ejecución mediante la opción Implementar automáticamente el proyecto de base de datos antes de ejecutar pruebas unitarias . Esta configuración mantiene el esquema de prueba actual.

Consideraciones para las bases de datos de prueba

Las pruebas unitarias y las pruebas de integración ejecutan T-SQL en una base de datos activa, por lo que el entorno de prueba necesita una configuración cuidadosa para generar resultados confiables.

  • Aísle las pruebas de producción. Use una instancia independiente o una base de datos de prueba dedicada. Nunca se recomienda ejecutar pruebas en producción.
  • Restablezca a un estado conocido antes de cada ejecución. Los scripts posteriores a la implementación o los scripts de limpieza de pruebas controlan este problema.
  • Externalice las cadenas de conexión en los archivos de configuración para que las canalizaciones de CI y el desarrollo local apunten cada uno a la base de datos correcta sin cambios en el código.

Integración de pruebas en canalizaciones de CI/CD

Agregue un paso de prueba después de la compilación y la implementación para que las pruebas se ejecuten automáticamente en cada confirmación. En Azure DevOps, use la tarea VSTest:

- task: VSTest@2
  inputs:
    testAssembly: '**\*Tests.dll'
    searchFolder: '$(System.DefaultWorkingDirectory)'

En Acciones de GitHub, ejecute las pruebas mediante dotnet test:

- name: Run database unit tests
  run: dotnet test ./DatabaseTests/DatabaseTests.csproj

Sugerencia

Configure el proyecto de prueba para implementar automáticamente el proyecto de base de datos antes de que se ejecuten las pruebas. Esta configuración garantiza que el esquema de la base de datos de prueba coincida con el proyecto en el momento de las pruebas.

Cuando una prueba falla, la canalización se detiene y el cambio no llega a ensayo ni producción. Este retraso proporciona al equipo tiempo para corregir el problema antes de que afecte a cualquier entorno.

Conclusiones clave

Las pruebas de base de datos abarcan tres niveles: validación de compilación para la corrección estructural, pruebas unitarias para la comprobación lógica y pruebas de integración para flujos de trabajo de un extremo a otro. Las pruebas unitarias de SQL Server siguen una estructura de tres fases de preacciones de prueba, acciones de prueba y posteriores a la prueba. Para comprobar el comportamiento de los procedimientos almacenados y las funciones, use condiciones de prueba como Scalar Value, Row County Expected Schema. Para probar métodos que deben validar las rutas de control de errores, agregue el atributo ExpectedSqlException. Conecte proyectos de prueba a la canalización de CI/CD para que una prueba con errores bloquee la implementación antes de que los cambios lleguen a ensayo o producción. Juntos, estas tres capas forman una red de seguridad que permite al equipo implementar cambios en la base de datos con confianza en lugar de ansiedad.