Comparteix via

Descarga e instalación de SqlPackage

SqlPackage se ejecuta en Windows, macOS y Linux, y está disponible para instalarse mediante dotnet tool o como una descarga ZIP independiente. Para más información sobre la última versión, consulte las notas de la versión.

  • Número de versión: 170.3.93
  • Número de compilación: 170.3.93.6
  • Fecha de lanzamiento: 10 de febrero de 2026

SqlPackage se desarrolla y publica para .NET y .NET Framework. Se recomienda instalar la versión sqlPackage de .NET 10 mediante el método prácticodotnet tool, que es multiplataforma y fácil de actualizar, o a través de la descarga de .zip independiente portátil. Las versiones de SqlPackage de .NET 10 se benefician de los avances continuos en el rendimiento y la escalabilidad de .NET como parte del enfoque en las aplicaciones modernas, lo que contrasta con el soporte de mantenimiento de .NET Framework para Windows. La versión de .NET Framework solo está disponible como .msi Windows Installer.

Note

Anteriormente, SqlPackage tenía un número de versión (19) y un número de compilación (160.x) distintos. A partir de la versión 161, el número de versión de SqlPackage coincide con el número de versión de DacFx al que está asociado (por ejemplo, 162.0.52).

Instalación, multiplataforma

Para la instalación de SqlPackage como herramienta dotnet es necesario instalar en l amáquina el SDK de .NET. La instalación de SqlPackage como herramienta global hace que esté disponible en la ruta de acceso como sqlpackage y es el método recomendado de instalar SqlPackage para Windows, macOS y Linux. SqlPackage está disponible como una herramienta de .NET para .NET 8 y versiones posteriores.

Para instalar SqlPackage como una herramienta global de .NET, ejecute comando el siguiente:

dotnet tool install -g microsoft.sqlpackage

Puede encontrar más información sobre las opciones disponibles con el comando dotnet tool install en la documentación de instalación de la herramienta dotnet.

Para actualizar SqlPackage a la versión más reciente, ejecute el comando siguiente:

dotnet tool update -g microsoft.sqlpackage

Para desinstalar SqlPackage, ejecute el comando siguiente:

dotnet tool uninstall -g microsoft.sqlpackage

Instalación de SqlPackage con versiones futuras de .NET

Para instalar SqlPackage con una versión más reciente del SDK de .NET, agregue --allow-roll-forward al comando install:

dotnet tool install -g microsoft.sqlpackage --allow-roll-forward

Esta opción permite a SqlPackage usar una versión más reciente del entorno de ejecución de .NET si no está instalado .NET 8 o .NET 10.

Solución de problemas de instalación

Si tiene problemas durante la instalación, siga estos pasos:

  1. Asegúrese de que el SDK de .NET está instalado: compruebe que el SDK de .NET está instalado en la máquina mediante la ejecución del comando siguiente:

    dotnet --list-sdks

    Si el SDK de .NET no aparece en la lista, descargue e instálelo desde la página de descarga del SDK de .NET.

  2. Compruebe la configuración del origen de NuGet: SqlPackage se publica en nuget.org, una fuente de NuGet pública. Es posible que encuentre un error que indica que microsoft.sqlpackage no se encuentra:

    microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\

    Asegúrese de que nuget.org es un origen de NuGet configurado para dotnet. Para enumerar los orígenes de NuGet configurados, ejecute:

    dotnet nuget list source

    Este comando debe mostrar una lista de fuentes de NuGet. Busque nuget.org en la salida, donde normalmente aparece como https://api.nuget.org/v3/index.json. Si nuget.org no aparece en la lista, agréguelo como origen de NuGet mediante el siguiente comando:

    dotnet nuget add source https://api.nuget.org/v3/index.json

  3. Reintentar la instalación: después de comprobar la instalación del SDK de .NET y la configuración de origen de NuGet, vuelva a intentar instalar SqlPackage mediante el comando adecuado:

    dotnet tool install -g microsoft.sqlpackage

Versiones preliminares

Las versiones preliminares de SqlPackage están disponibles con la fuente de herramientas dotnet. Para acceder a las versiones preliminares, use la opción --prerelease con el comando dotnet tool. Por ejemplo, para instalar la versión preliminar más reciente, ejecute el siguiente comando:

dotnet tool install -g --prerelease microsoft.sqlpackage

Para actualizar SqlPackage a la versión preliminar más reciente, ejecute el comando siguiente:

dotnet tool update -g --prerelease microsoft.sqlpackage

Hay disponible una lista de versiones preliminares en la fuente de herramientas dotnet para SqlPackage.

Instalación, descarga de archivos (alternativa)

SqlPackage también se prepara como descarga independiente para Windows, macOS y Linux. No se requiere ninguna instalación de .NET; sin embargo, los requisitos del sistema operativo son los mismos que la instalación de la herramienta dotnet. Las dependencias incluidas en esta descarga de .zip se actualizan con mayor frecuencia en la opción de herramienta .NET para SqlPackage. Los vínculos siguientes son para la última versión de SqlPackage:

Platform Download
Windows .NET 10 archivo .zip
Windows el archivo.msi
macOS .NET 10 archivo .zip
Linux .NET 10 archivo .zip

Linux

  1. Descarga de SqlPackage para Linux

  2. Extraiga el archivo e inicie SqlPackage. Abra una nueva ventana terminal y escriba los siguientes comandos:

    cd ~
mkdir sqlpackage
unzip ~/Downloads/sqlpackage-linux-<version string>.zip -d ~/sqlpackage
echo "export PATH=\"\$PATH:$HOME/sqlpackage\"" >> ~/.bashrc
chmod a+x ~/sqlpackage/sqlpackage
source ~/.bashrc
sqlpackage

    Note

    Puede que falten dependencias. Use los siguientes comandos para instalar estas dependencias según la versión de Linux:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Descarga de SqlPackage para macOS

  2. Extraiga el archivo e inicie SqlPackage. Abra una nueva ventana terminal y escriba los siguientes comandos:

    mkdir sqlpackage
unzip ~/Downloads/sqlpackage-osx-<version string>.zip -d ~/sqlpackage
chmod +x ~/sqlpackage/sqlpackage
echo 'export PATH="$PATH:~/sqlpackage"' >> ~/.bash_profile
source ~/.bash_profile
sqlpackage

    Note

    La configuración de seguridad puede requerir modificaciones para ejecutar SqlPackage en macOS. Use los comandos siguientes para interactuar con Gatekeeper desde la línea de comandos.

    Antes de ejecutar SqlPackage:

    sudo spctl --master-disable

    Después de ejecutar SqlPackage:

    sudo spctl --master-enable

Windows (.NET 10)

  1. Descarga de SqlPackage para Windows

  2. Extrae el archivo, haz clic con el botón derecho en el archivo en el Explorador de Windows, selecciona "Extraer todo..." y selecciona el directorio de destino.

  3. Abra una nueva ventana de terminal y cambie el directorio a la ubicación donde se extrajo SqlPackage:

    > sqlpackage

Windows (.NET Framework)

En esta versión de SqlPackage se incluye una experiencia de instalación estándar de Windows y un archivo .zip:

  1. Descarga y ejecución del instalador de DacFramework.msi para Windows
  2. Abra una nueva ventana de símbolo del sistema y ejecute SqlPackage
    • SqlPackage se instala en la carpeta C:\Program Files\Microsoft SQL Server\170\DAC\bin.

Desinstalar SqlPackage

Si ha instalado SqlPackage con el instalador de Windows, desinstálelo de la misma manera que quita cualquier aplicación de Windows.

Si ha instalado SqlPackage con un archivo .zip u otro archivo, elimine los archivos.

Entornos automatizados

Se recomienda instalar la versión de la herramienta dotnet de SqlPackage para entornos automatizados, como canalizaciones de CI/CD, debido a su facilidad de instalación y actualización. Sin embargo, la opción de descarga de archivos también se puede usar en entornos automatizados.

dotnet tool install -g microsoft.sqlpackage

Los vínculos evergreen están disponibles para descargar las versiones más recientes de SqlPackage:

DacFx

SqlPackage es una interfaz de línea de comandos para el marco DacFx, que expone algunas de las API públicas de DacFx. DacServices (Microsoft.SqlServer.Dac) es un mecanismo relacionado para integrar la implementación de bases de datos en la canalización de la aplicación. La API DacServices está disponible en un paquete NuGet, Microsoft.SqlServer.DacFx.

La adición del paquete NuGet a un proyecto de .NET se realiza desde la CLI de .NET con este comando:

dotnet add package Microsoft.SqlServer.DacFx

Sistemas operativos compatibles

SqlPackage se ejecuta en Windows, macOS y Linux y se compila con .NET 10. Los requisitos del sistema operativo de .NET 10 son requisitos mínimos para SqlPackage, que tiene requisitos adicionales debido a sus dependencias.

Windows (x64)

  • Windows 11
  • Windows 10 (1607+)
  • Windows Server Core 2012 R2+
  • Windows Server 2012 R2+

macOS

  • macOS 14 "Sonoma"+

Linux (x64)

  • Debian 12+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server 15 SP6+
  • Ubuntu 22.04+

Idiomas disponibles

Esta versión de SqlPackage puede instalarse en los idiomas siguientes:

SqlPackage .NET 10 Windows:
Chino (simplificado) | Chino (tradicional) | Inglés (Estados Unidos) | Francés | Alemán | Italiano | Japonés | Coreano | Portugués (Brasil) | Ruso | Español

SqlPackage .NET Framework Windows:
Chino (simplificado) | Chino (tradicional) | Inglés (Estados Unidos) | Francés | Alemán | Italiano | Japonés | Coreano | Portugués (Brasil) | Ruso | Español

SqlPackage .NET 10 macOS:
Chino (simplificado) | Chino (tradicional) | Inglés (Estados Unidos) | Francés | Alemán | Italiano | Japonés | Coreano | Portugués (Brasil) | Ruso | Español

SqlPackage .NET 10 Linux:
Chino (simplificado) | Chino (tradicional) | Inglés (Estados Unidos) | Francés | Alemán | Italiano | Japonés | Coreano | Portugués (Brasil) | Ruso | Español

Contenido relacionado

  • Last updated on