Saltearse al contenido
Nappai Documentation

SQL Server

SQL Server trabaja con las tablas de tu base de datos Microsoft SQL Server desde un flujo: lee filas, añade nuevas, cambia o borra las existentes, ejecuta consultas SQL y describe la estructura de la base.

Cuándo usarlo

  • Tu ERP o tu CRM guardan los datos en SQL Server y quieres consultarlos desde un flujo.
  • Dar a un agente acceso a consultar clientes, pedidos o stock.
  • Actualizar un registro concreto a partir de su clave.

Configuración

El campo Operation decide qué hace el componente y qué campos aparecen: Insert (por defecto), Get, Update, Delete, Custom Query, Get Schema (lista las tablas o las columnas de una tabla) y DatabaseInfo (describe la base). Al elegir la credencial, Schema y Table Name se llenan con los de tu base.

Necesitas una credencial SQL Server con el servidor, el puerto, el usuario, la contraseña y la base de datos. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial SQL Server con los datos de conexión.
Operation (obligatorio)Qué hace el componente.
Schema (obligatorio)El esquema en el que está la tabla.
Table Name (obligatorio)La tabla sobre la que se trabaja.
Use FiltersActívalo para elegir qué filas se leen, cambian o borran. Al activarlo aparece Selection Mode: By Primary Key (por clave, con Primary Key Value) o By Filters (por condiciones).
Primary Key ValueEl valor de la clave de la fila que se cambia o se borra.
Select Filter TypeCómo escribes las condiciones: String (por defecto), en Filter String, o Build Manually, con Number Of Filters To Use y un campo por condición.
Filter StringLas condiciones, por ejemplo edad > 25 AND ciudad = 'Madrid'. Vacío con Get, se devuelven todas las filas.
Custom Query (obligatorio)Con Custom Query. La consulta SQL que se ejecuta.
Detail LevelCon Get Schema. Tables (por defecto) devuelve los nombres de las tablas; Columns, el detalle de las columnas de la tabla elegida en Table.

Opciones avanzadas

CampoQué hace
LimitCuántas filas se devuelven como máximo. Por defecto, 10.
Return AllDevuelve todas las filas sin tener en cuenta Limit. Desactivado por defecto.

Resultado

La salida Data trae el resultado de la operación: las filas leídas o la confirmación de lo cambiado. La salida Database Info trae la descripción de la base.

En modo herramienta, un agente puede usar el componente para consultar o cambiar datos por sí mismo. Consulta Tool Mode.

Ejemplo

Una distribuidora quiere que su asistente consulte el stock de su ERP.

  1. Añade SQL Server con la credencial SQL Server.
  2. Elige Get, el esquema dbo y la tabla articulos.
  3. Ponlo en modo herramienta para que el agente escriba la condición en Filter String.

Buenas prácticas

  • Usa una credencial con permisos de solo lectura si el componente solo va a consultar.

Componentes relacionados