agregarClaveForanea
Adds a foreign key constraint between two existing database tables to enforce referential integrity, ensuring data relationships remain valid by linking local columns to referenced columns.
Instructions
Sigue estas reglas para agregar una clave foránea: PROPÓSITO: Crear una relación (clave foránea) entre dos tablas para mantener la integridad referencial. REGLA: Las tablas y columnas involucradas ya deben existir. PRECAUCIÓN: La operación puede fallar si los datos existentes violan la nueva restricción. USO: Especifica la tabla local, sus columnas, la tabla de referencia y sus columnas. EJEMPLO: "Agrega una clave foránea de cliente_id en ventas referenciando clientes(id)."
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| columnas | Yes | Columnas locales | |
| columnasReferencia | Yes | Columnas referenciadas | |
| nombre | No | Nombre de la clave foránea (opcional) | |
| onDelete | No | Acción ON DELETE (ej. CASCADE, SET NULL) | |
| onUpdate | No | Acción ON UPDATE (ej. CASCADE, SET NULL) | |
| tabla | Yes | Tabla que tendrá la clave foránea | |
| tablaReferencia | Yes | Tabla referenciada |
Implementation Reference
- mcp_server.js:701-718 (handler)Handler function that constructs and executes the SQL ALTER TABLE statement to add a foreign key constraint, handling optional constraint name, ON DELETE, and ON UPDATE actions.
async ({ tabla, columnas, tablaReferencia, columnasReferencia, nombre, onDelete, onUpdate }) => { try { if (!tabla || !columnas || !tablaReferencia || !columnasReferencia) { return { isError: true, content: [{ type: 'text', text: 'Debes proporcionar tabla, columnas, tablaReferencia y columnasReferencia.' }] }; } const nombreFK = nombre ? `CONSTRAINT ${quoteIdent(nombre)} ` : ''; const cols = columnas.map(quoteIdent).join(', '); const refCols = columnasReferencia.map(quoteIdent).join(', '); let sql = `ALTER TABLE ${quoteIdent(tabla)} ADD ${nombreFK}FOREIGN KEY (${cols}) REFERENCES ${quoteIdent(tablaReferencia)} (${refCols})`; if (onDelete) sql += ` ON DELETE ${onDelete}`; if (onUpdate) sql += ` ON UPDATE ${onUpdate}`; await query_runner.runQuery(sql); return { content: [{ type: 'text', text: 'Clave foránea agregada exitosamente.' }] }; } catch (e) { return { isError: true, content: [{ type: 'text', text: 'Error al agregar clave foránea: ' + (e.message || e) }] }; } } ); - mcp_server.js:692-700 (schema)Zod input schema defining parameters for the foreign key addition: local table and columns, referenced table and columns, optional name, onDelete, onUpdate.
{ tabla: z.string().describe('Tabla que tendrá la clave foránea'), columnas: z.array(z.string()).describe('Columnas locales'), tablaReferencia: z.string().describe('Tabla referenciada'), columnasReferencia: z.array(z.string()).describe('Columnas referenciadas'), nombre: z.string().optional().describe('Nombre de la clave foránea (opcional)'), onDelete: z.string().optional().describe('Acción ON DELETE (ej. CASCADE, SET NULL)'), onUpdate: z.string().optional().describe('Acción ON UPDATE (ej. CASCADE, SET NULL)'), }, - mcp_server.js:684-718 (registration)MCP server.tool registration for 'agregarClaveForanea' tool, including description, input schema, and inline handler implementation.
server.tool( 'agregarClaveForanea', 'Sigue estas reglas para agregar una clave foránea:\n' + 'PROPÓSITO: Crear una relación (clave foránea) entre dos tablas para mantener la integridad referencial.\n' + 'REGLA: Las tablas y columnas involucradas ya deben existir.\n' + 'PRECAUCIÓN: La operación puede fallar si los datos existentes violan la nueva restricción.\n' + 'USO: Especifica la tabla local, sus columnas, la tabla de referencia y sus columnas.\n' + 'EJEMPLO: "Agrega una clave foránea de cliente_id en ventas referenciando clientes(id)."', { tabla: z.string().describe('Tabla que tendrá la clave foránea'), columnas: z.array(z.string()).describe('Columnas locales'), tablaReferencia: z.string().describe('Tabla referenciada'), columnasReferencia: z.array(z.string()).describe('Columnas referenciadas'), nombre: z.string().optional().describe('Nombre de la clave foránea (opcional)'), onDelete: z.string().optional().describe('Acción ON DELETE (ej. CASCADE, SET NULL)'), onUpdate: z.string().optional().describe('Acción ON UPDATE (ej. CASCADE, SET NULL)'), }, async ({ tabla, columnas, tablaReferencia, columnasReferencia, nombre, onDelete, onUpdate }) => { try { if (!tabla || !columnas || !tablaReferencia || !columnasReferencia) { return { isError: true, content: [{ type: 'text', text: 'Debes proporcionar tabla, columnas, tablaReferencia y columnasReferencia.' }] }; } const nombreFK = nombre ? `CONSTRAINT ${quoteIdent(nombre)} ` : ''; const cols = columnas.map(quoteIdent).join(', '); const refCols = columnasReferencia.map(quoteIdent).join(', '); let sql = `ALTER TABLE ${quoteIdent(tabla)} ADD ${nombreFK}FOREIGN KEY (${cols}) REFERENCES ${quoteIdent(tablaReferencia)} (${refCols})`; if (onDelete) sql += ` ON DELETE ${onDelete}`; if (onUpdate) sql += ` ON UPDATE ${onUpdate}`; await query_runner.runQuery(sql); return { content: [{ type: 'text', text: 'Clave foránea agregada exitosamente.' }] }; } catch (e) { return { isError: true, content: [{ type: 'text', text: 'Error al agregar clave foránea: ' + (e.message || e) }] }; } } );