Compartir vía

Descarga e instalación de SqlPackage

  • Artículo

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: 162.5.57
  • Número de compilación: 162.5.57.1
  • Fecha de publicación: 21 de noviembre de 2024

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

Nota:

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 de DacFx 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 dotnet 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

Solucionar problemas de la 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. Comprobar la configuración de origen de NuGet: 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

    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. Pero no se requiere ninguna instalación de .NET; las dependencias incluidas en esta descarga .zip se actualizan con más frecuencia en la opción de herramienta dotnet para SqlPackage. Los vínculos siguientes son para la última versión de SqlPackage:

Plataforma Descargar
Windows .NET 8 archivo zip
Windows Archivo .msi
macOS .NET 8 archivo zip
Linux .NET 8 archivo zip

Linux

  1. Descarga de SqlPackage para Linux

  2. Extrae el archivo e inicia SqlPackage, abre una nueva ventana de terminal y escribe 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

    Nota:

    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. Extrae el archivo e inicia SqlPackage, abre una nueva ventana de terminal y escribe 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

    Nota:

    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 8)

  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 deLsímbolo del sistema y ejecute SqlPackage
    • SqlPackage se instala en la carpeta C:\Program Files\Microsoft SQL Server\160\DAC\bin.

Desinstalación de 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

Los vínculos de 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

Nota:

Se han publicado paquetes NuGet adicionales con el nombre DacFx "Microsoft.SqlServer.DacFx.x64" y "Microsoft.SqlServer.DacFx.x86". La compatibilidad con ambas plataformas está incluida en el paquete "Microsoft.SqlServer.DacFx". Las nuevas referencias deben realizarse a este paquete, no a las variantes x64 o x86.

Sistemas operativos compatibles

SqlPackage se ejecuta en Windows, macOS y Linux y se compila con .NET 8. Los requisitos del sistema operativo .NET 8 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 12 «Monterey»+

Linux (x64)

  • Debian 11+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 20.04+

Idiomas disponibles

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

SqlPackage .NET 8 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 8 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 8 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