Desarrolla una REST API con Microsoft SQL Server y Nodejs

Aprende a Desarrollar una REST API Usando JavaScript con Node.js y SQL Server

En este artículo aprenderás paso a paso cómo desarrollar una REST API utilizando JavaScript con Node.js como entorno de ejecución y SQL Server como sistema gestor de bases de datos (DBMS). Esta combinación es ideal para construir aplicaciones modernas que requieren un backend sólido y eficiente para manejar datos.

Requerimientos Previos

Antes de empezar, asegúrate de cumplir con los siguientes requisitos:

1. Instalación de Microsoft SQL Server
   Descarga e instala Microsoft SQL Server desde su sitio oficial. SQL Server será nuestra base de datos para almacenar y manejar los datos de la API.

2. Instalación de Node.js
   Descarga e instala Node.js desde su página oficial. Node.js es el entorno que nos permitirá ejecutar JavaScript en el backend.

3. Instalación de Visual Studio Code
   Visual Studio Code (VSCode) será nuestro editor de código. Puedes descargarlo desde aquí.

4. Instalación del paquete mssql de npm
   El paquete mssql nos permite interactuar con SQL Server desde Node.js. Lo instalaremos más adelante en este tutorial.

Programas Clientes para SQL Server

Aunque interactuaremos con SQL Server principalmente desde Node.js, es importante contar con herramientas para gestionar la base de datos de manera visual y simplificar tareas como ejecutar consultas o administrar tablas. Aquí tienes algunas opciones:

1. Extensión de Microsoft SQL Server para VSCode
   Esta extensión te permite ejecutar consultas SQL directamente desde Visual Studio Code. Es muy útil para desarrolladores que ya trabajan con este editor.

   • Instalación y documentación oficial.

2. Azure Data Studio
   Una herramienta gratuita y moderna de Microsoft diseñada para administrar bases de datos. Es ligera, multiplataforma y fácil de usar.

   • Descarga Azure Data Studio.

3. Versiones Anteriores
   Si prefieres usar herramientas clásicas, puedes optar por SQL Server Management Studio (SSMS), que es más robusto pero también más pesado. Es ideal para entornos corporativos.

Configuración Inicial del Proyecto

Paso 1: Crear un Proyecto de Node.js

1. Abre una terminal en la carpeta donde deseas crear tu proyecto.
2. Ejecuta los siguientes comandos para inicializar el proyecto:

   mkdir rest-api-nodejs-sqlserver
   cd rest-api-nodejs-sqlserver
   npm init -y
   

   Esto generará un archivo package.json básico para tu proyecto.

Paso 2: Instalar Dependencias Necesarias

Instalemos el paquete mssql y otras herramientas útiles:

npm install mssql express body-parser

• mssql: Biblioteca para interactuar con SQL Server.
• express: Framework minimalista para crear aplicaciones web y APIs.
• body-parser: Middleware para manejar datos JSON enviados en las solicitudes HTTP.

Crear la Base de Datos en SQL Server

1. Abre tu cliente preferido, como Azure Data Studio o SQL Server Management Studio.
2. Ejecuta un script para crear una base de datos y una tabla. Por ejemplo:

   CREATE DATABASE TestDB;
   
   USE TestDB;
   
   CREATE TABLE Users (
       ID INT PRIMARY KEY IDENTITY(1,1),
       Name NVARCHAR(50),
       Email NVARCHAR(50),
       Age INT
   );
   

Esta base de datos y tabla serán la base de nuestra REST API.

Desarrollo de la REST API

Paso 1: Crear el Servidor Básico con Express

En el archivo index.js de tu proyecto, configura un servidor básico:

const express = require('express');
const bodyParser = require('body-parser');
const sql = require('mssql');

const app = express();
app.use(bodyParser.json());

const PORT = 3000;
app.listen(PORT, () => {
    console.log(`Server running on port ${PORT}`);
});

Paso 2: Configurar la Conexión con SQL Server

Añade la configuración para conectar con SQL Server:

const config = {
    user: 'tu_usuario',
    password: 'tu_contraseña',
    server: 'localhost', // o tu dirección IP
    database: 'TestDB',
    options: {
        encrypt: true, // Para Azure
        trustServerCertificate: true, // Solo en desarrollo
    }
};

sql.connect(config).then(pool => {
    console.log('Conexión exitosa a SQL Server');
}).catch(err => console.error('Error al conectar con SQL Server:', err));

Paso 3: Crear Rutas para la API

Crea endpoints para interactuar con la base de datos:

1. Obtener todos los usuarios:

   app.get('/users', async (req, res) => {
       try {
           const pool = await sql.connect(config);
           const result = await pool.request().query('SELECT * FROM Users');
           res.json(result.recordset);
       } catch (err) {
           res.status(500).send(err.message);
       }
   });
   

2. Añadir un nuevo usuario:

   app.post('/users', async (req, res) => {
       const { Name, Email, Age } = req.body;
       try {
           const pool = await sql.connect(config);
           await pool.request()
               .input('Name', sql.NVarChar, Name)
               .input('Email', sql.NVarChar, Email)
               .input('Age', sql.Int, Age)
               .query('INSERT INTO Users (Name, Email, Age) VALUES (@Name, @Email, @Age)');
           res.send('Usuario agregado exitosamente');
       } catch (err) {
           res.status(500).send(err.message);
       }
   });
   

Versiones Anteriores

• Primer version del tutorial
• Primer Miniatura de Nodejs y SQL Server

Conclusión

Con esta guía, has aprendido a configurar y desarrollar una REST API usando Node.js y SQL Server. Este conocimiento te abre las puertas para construir aplicaciones backend robustas que pueden integrarse con sistemas empresariales y manejar grandes volúmenes de datos. ¡Anímate a seguir explorando y personalizando tu API para adaptarla a tus necesidades!