Megosztás:

Az SqlPackage letöltése és telepítése

Az SqlPackage Windows, macOS és Linux rendszeren fut, és telepíthető dotnet tool vagy önálló zip-letöltésként. A legújabb kiadás részleteiért lásd a kibocsátási megjegyzéseit.

  • Verziószám: 170.2.70
  • Buildszám: 170.2.70.1
  • Kiadás dátuma: 2025. október 14.

Az SqlPackage a .NET 8 és a .NET-keretrendszerhez is ki van fejlesztve és kibocsátva. Ajánlott a .NET 8 SqlPackage verzió telepítése a platformfüggetlen és könnyen frissíthető kényelmes dotnet tool módszer, vagy a hordozható, önálló .zip letöltés útján. A .NET 8 SqlPackage-kiadások a .NET teljesítményének és méretezhetőségének folyamatos fejlődését élvezik, részeként az fókusznak, amely a modern alkalmazásokraösszpontosít, ami ellentétben áll a Windows .NET-keretrendszer karbantartási támogatásával. A .NET-keretrendszer verziója csak .msi Windows-telepítőként érhető el.

Note

Korábban az SqlPackage külön verziószámmal (19) és buildszámmal (160.x) rendelkezett. A 161-es verziótól kezdve az SqlPackage verziószáma megegyezik a DacFx-verziószámmal, amelyhez hozzá van rendelve (például 162.0.52).

Telepítés, platformok közötti

Az SqlPackage dotnet eszközként való telepítéséhez a .NET SDK kell telepíteni a számítógépre. Az SqlPackage globális eszközként való telepítése hozzáadja az elérési úthoz, így sqlpackage néven érhető el, és ez az ajánlott módszer a Windows, macOS és Linux rendszerhez készült SqlPackage telepítéséhez. Az SqlPackage dotnet eszközként érhető el a .NET 8-as és újabb verzióihoz.

Az SqlPackage globális .NET-eszközként való telepítéséhez futtassa a következő parancsot:

dotnet tool install -g microsoft.sqlpackage

A dotnet tool install paranccsal elérhető lehetőségekről további információt a dotnet eszköz telepítési dokumentációjábantalál.

Az SqlPackage legújabb verzióra való frissítéséhez futtassa a következő parancsot:

dotnet tool update -g microsoft.sqlpackage

Az SqlPackage eltávolításához futtassa a következő parancsot:

dotnet tool uninstall -g microsoft.sqlpackage

Az SqlPackage telepítése .NET 9 vagy újabb verzióval

Ha az SqlPackage-t a .NET SDK újabb verziójával szeretné telepíteni, adja hozzá --allow-roll-forward a telepítési parancshoz:

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

Ezzel a beállítással az SqlPackage a .NET-futtatókörnyezet újabb verzióját használhatja, ha a .NET 8 nincs telepítve.

Telepítés hibaelhárítása

Ha a telepítés során problémákat tapasztal, kövesse az alábbi lépéseket:

  1. Győződjön meg arról, hogy a .NET SDK telepítve van: Ellenőrizze, hogy a .NET SDK telepítve van-e a számítógépen a következő parancs futtatásával:

    dotnet --list-sdks

    Ha a .NET SDK nem szerepel a listán, töltse le és telepítse a .NET SDK letöltési oldaláról.

  2. Ellenőrizze a NuGet-forráskonfigurációt: Az SqlPackage nyilvános NuGet-csatornán nuget.orgvan közzétéve. Előfordulhat, hogy hibaüzenet jelenik meg, amely azt jelzi, hogy microsoft.sqlpackage nem található:

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

    Győződjön meg arról, hogy nuget.org ez egy konfigurált NuGet-forrás a dotnethez. A konfigurált NuGet-források listázása a következő futtatásával:

    dotnet nuget list source

    Ennek a parancsnak meg kell jelenítenie a NuGet-források listáját. Keresse meg a nuget.org a kimenetben, amelyet általában a https://api.nuget.org/v3/index.json néven sorolnak fel. Ha nuget.org nem szerepel a listában, vegye fel NuGet-forrásként a következő paranccsal:

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

  3. Újrapróbálkozási: A .NET SDK telepítésének és NuGet-forráskonfigurációjának ellenőrzése után próbálkozzon újra az SqlPackage telepítésével a megfelelő paranccsal:

    dotnet tool install -g microsoft.sqlpackage

Előzetes kiadások

Az SqlPackage előzetes kiadásai a dotnet eszközcsatornával érhetők el. Az előzetes kiadások eléréséhez használja a --prerelease lehetőséget a dotnet tool paranccsal. A legújabb előzetes kiadás telepítéséhez például futtassa a következő parancsot:

dotnet tool install -g --prerelease microsoft.sqlpackage

Az SqlPackage legújabb előzetes verzióra való frissítéséhez futtassa a következő parancsot:

dotnet tool update -g --prerelease microsoft.sqlpackage

Az előzetes kiadások listája elérhető a dotnet eszköz csatornáján az SqlPackageszámára.

Telepítés, fájlletöltés (alternatív)

Az SqlPackage a Windows, macOS és Linux rendszereken is önálló letöltésként készült. Nincs szükség .NET telepítésre, azonban az operációsrendszer-követelmények megegyeznek a dotnet eszköz telepítési. A .zip letöltésben szereplő függőségek gyakrabban frissülnek a SqlPackage dotnet eszköz opcióban. Az Alábbi hivatkozások az SqlPackage legújabb verziójára mutatnak:

Platform Download
Windows .NET 8 .zip fájl
Windows .msi fájl
macOS .NET 8 .zip fájl
Linux .NET 8 .zip fájl

Linux

  1. SqlPackage Linux letöltése

  2. Bontsa ki a fájlt, és indítsa el az SqlPackage-t. Nyisson meg egy új terminálablakot, és írja be a következő parancsokat:

    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

    Előfordulhat, hogy hiányoznak a függőségek. A következő parancsokkal telepítheti ezeket a függőségeket a Linux verziójától függően:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. macOS-ra SqlPackage letöltése

  2. Bontsa ki a fájlt, és indítsa el az SqlPackage-t. Nyisson meg egy új terminálablakot, és írja be a következő parancsokat:

    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

    A biztonsági beállítások módosítására lehet szükség az SqlPackage macOS rendszeren való futtatásához. A következő parancsokkal kezelheti a Gatekeepert a parancssorból.

    SqlPackage végrehajtása előtt:

    sudo spctl --master-disable

    SqlPackage végrehajtása után:

    sudo spctl --master-enable

Windows (.NET 8)

  1. SqlPackage letöltése Windows

  2. Bontsa ki a fájlt úgy, hogy a jobb gombbal a Fájlra kattint a Windows Intézőben, majd válassza az "Összes kibontása..." lehetőséget, majd válassza ki a célkönyvtárat

  3. Nyisson meg egy új terminálablakot és cd-t arra a helyre, ahol az SqlPackage ki lett nyerve:

    > sqlpackage

Windows (.NET-keretrendszer)

Az SqlPackage jelen kiadása egy szabványos Windows-telepítői felületet és egy .ziptartalmaz:

  1. A Windows DacFramework.msi telepítőjének letöltése és futtatása
  2. Nyisson meg egy új parancssori ablakot, és futtassa az SqlPackage-t
    • Az SqlPackage telepítve van a C:\Program Files\Microsoft SQL Server\170\DAC\bin mappába

Az SqlPackage eltávolítása

Ha az SqlPackage-t a Windows-telepítővel telepítette, távolítsa el ugyanúgy, ahogyan a Windows-alkalmazásokat.

Ha az SqlPackage-t egy .zip vagy más archívummal telepítette, törölje a fájlokat.

Automatizált környezetek

Az örökzöld hivatkozások a legújabb SqlPackage-verziók letöltéséhez érhetők el:

DacFx

Az SqlPackage a DacFx-keretrendszer parancssori felülete, amely felfed néhány nyilvános DacFx API-t. A DacServices (Microsoft.SqlServer.Dac) egy kapcsolódó mechanizmus az adatbázis üzembe helyezésének az alkalmazásfolyamatba való integrálásához. A DacServices API egy csomagban érhető el a NuGeten keresztül, Microsoft.SqlServer.DacFx.

A NuGet-csomag .NET-projekthez való hozzáadása a .NET CLI-n keresztül történik az alábbi paranccsal:

dotnet add package Microsoft.SqlServer.DacFx

Note

A többi NuGet-csomagot DacFx néven, Microsoft.SqlServer.DacFx.x64 és Microsoft.SqlServer.DacFx.x86 jelentették meg. A csomag mindkét platform támogatását lefedi Microsoft.SqlServer.DacFx . Új referenciákat kell készíteni erre a csomagra, nem pedig az x64-et vagy az x86-os változatokat.

Támogatott operációs rendszerek

Az SqlPackage Windows, macOS és Linux rendszeren fut, és .NET 8 használatával készült. A .NET 8 operációsrendszer-követelmények az SqlPackage minimális követelményei, amelyek függőségei miatt további követelményeket támasztanak.

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+

Elérhető nyelvek

Az SqlPackage ezen kiadása a következő nyelveken telepíthető:

SqlPackage .NET 8 Windows:
kínai (egyszerűsített) | kínai (hagyományos) | angol (Egyesült Államok) | francia | német | olasz | japán | koreai | portugál (Brazília) | orosz | spanyol

SqlPackage .NET-keretrendszer Windows:
kínai (egyszerűsített) | kínai (hagyományos) | angol (Egyesült Államok) | francia | német | olasz | japán | koreai | portugál (Brazília) | orosz | spanyol

SqlPackage .NET 8 macOS:
kínai (egyszerűsített) | kínai (hagyományos) | angol (Egyesült Államok) | francia | német | olasz | japán | koreai | portugál (Brazília) | orosz | spanyol

SqlPackage .NET 8 Linux:
kínai (egyszerűsített) | kínai (hagyományos) | angol (Egyesült Államok) | francia | német | olasz | japán | koreai | portugál (Brazília) | orosz | spanyol

Kapcsolódó tartalom

  • Last updated on