Xetux Docs
SQL Server

Resolución de Error sqlcmd

Guía para resolver el error "Cannot run program sqlcmd" mediante la configuración de variables de entorno en Windows.

Resolución de Error: sqlcmd (CreateProcess error=2)

Este error ocurre cuando el sistema Xetux intenta ejecutar comandos de base de datos a través de la utilidad sqlcmd, pero no logra localizar el ejecutable en las rutas predefinidas del sistema.

Error: Error no controlado. Cannot run program "sqlcmd": CreateProcess error=2, El sistema no puede encontrar el archivo especificado.

Causa Técnica

La utilidad sqlcmd.exe se instala generalmente con Microsoft SQL Server o SQL Server Management Studio (SSMS). El error persiste si la ruta del directorio Binn (donde reside el ejecutable) no ha sido agregada a la variable de entorno PATH del sistema operativo.

Proceso de Solución

Localización del Ejecutable

Se debe buscar el archivo sqlcmd.exe en el equipo. Las rutas habituales dependen de la versión de SQL Server instalada:

  • C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\<versión>\Tools\Binn
  • C:\Program Files\Microsoft SQL Server\<versión>\Tools\Binn\

Obtención de la Ruta

Una vez localizado el directorio que contiene sqlcmd.exe, se debe copiar la ruta completa desde la barra de direcciones del Explorador de Archivos.

Acceso a Propiedades del Sistema

Presionar la combinación de teclas Windows + R, escribir sysdm.cpl y presionar Enter.

Configuración de Variables de Entorno

  1. Navegar a la pestaña Opciones avanzadas (Advanced).
  2. Hacer clic en el botón Variables de entorno... (Environment Variables).
  3. En la sección Variables del sistema, localizar la variable denominada Path y seleccionar Editar....

Adición de la Nueva Ruta

  1. En la ventana de edición, hacer clic en Nuevo.
  2. Pegar la ruta copiada en el paso 2.
  3. Hacer clic en Aceptar en todas las ventanas abiertas para guardar los cambios.

Validación

Abrir una nueva terminal (CMD o PowerShell) y ejecutar el comando:

sqlcmd -?

Si el sistema devuelve la lista de parámetros de la utilidad, el problema ha sido resuelto.

Es imperativo cerrar y volver a abrir cualquier aplicación o terminal que estuviera en ejecución antes de realizar el cambio, para que estas reconozcan la actualización de la variable PATH.
Copyright © 2026