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: 162.5.57
• buildszám: 162.5.57.1
• Megjelenés dátuma: 2024. november 21.

Az SqlPackage a .NET 8 és a .NET-keretrendszerhez is ki van fejlesztve és kibocsátva. A .NET 8 SqlPackage verzió telepítése ajánlott a dotnet tool módszer, amely platformfüggetlen és könnyen frissíthető, vagy a hordozható, önálló .zip letöltési. 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.

Telepítés, platformfüggetlen

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

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. NuGet-forráskonfigurációellenőrzése: Győződjön meg arról, hogy a nuget.org 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
   

   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:

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
   

   Jegyzet

   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
   

   Jegyzet

   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\160\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:

• Linux (https://aka.ms/sqlpackage-linux)
• macOS (https://aka.ms/sqlpackage-macos)
• Windows (https://aka.ms/sqlpackage-windows)
• Windows, .NET-keretrendszer (https://aka.ms/dacfx-msi)

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

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

• SqlPackage
• SqlPackage a CI/CD csatornákban
• SqlPackage hibaelhárítása
• SQL-projektek
• DacFx GitHub-adattár
• Microsoft adatvédelmi nyilatkozata