Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

Commit 3db4acd

Browse files
dzsquareddzsquared
committed
introducing dotnet tool
1 parent 7bad33b commit 3db4acd

1 file changed

Lines changed: 56 additions & 28 deletions

File tree

‎docs/tools/sqlpackage/sqlpackage-download.md‎

Lines changed: 56 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -16,44 +16,50 @@ ms.date: 11/7/2022
1616

1717
# Download and install SqlPackage
1818

19-
SqlPackage runs on Windows, macOS, and Linux.
19+
SqlPackage runs on Windows, macOS, and Linux, and is available to install through `dotnet tool` or as a standalone zip download.
2020

21-
Download and install the latest releases:
21+
- **Version number:** 161.6370.0
22+
- **Build number:** 16.1.6370.0
23+
- **Release date:** November 9, 2022
2224

23-
|Platform|Download|Release date|Version|Build|
24-
|:---|:---|:---|:---|:---|
25-
|[Windows .NET 6](#windows-net-6) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214842)|November 7, 2022|161.6370.0|16.1.6370.0|
26-
|[Windows](#windows-net-framework)|[MSI Installer](https://go.microsoft.com/fwlink/?linkid=2214739)|November 7, 2022|161.6370.0|16.1.6370.0|
27-
|[macOS .NET 6](#macos) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214740)|November 7, 2022|161.6370.0|16.1.6370.0|
28-
|[Linux .NET 6](#linux) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214843)|November 7, 2022|161.6370.0|16.1.6370.0|
29-
30-
For details about the latest release, see the [release notes](release-notes-sqlpackage.md). To download additional languages, see the [Available Languages](#available-languages) section.
25+
For details about the latest release, see the [release notes](release-notes-sqlpackage.md).
3126

3227
> [!NOTE]
3328
> SqlPackage version numbering has been adjusted to better reflect the DacFx build number it is associated with. Previously, SqlPackage had a distinct version number (19) and build number (160.x). Beginning with version 161, the version number of SqlPackage will match the DacFx version number it is associated with (eg 161.6370.0).
3429
35-
## DacFx
30+
## Installation, cross-platform
3631

37-
SqlPackage is a command-line interface for the DacFx framework, exposing some of the public DacFx APIs. DacServices ([Microsoft.SqlServer.Dac](/dotnet/api/microsoft.sqlserver.dac.dacservices)) is a related mechanism for integrating database deployment into your application pipeline. The DacServices API is available in a package through NuGet, [Microsoft.SqlServer.DacFx](https://www.NuGet.org/packages/Microsoft.SqlServer.DacFx). The current DacFx version is 161.6370.0.
32+
Installing SqlPackage as a [dotnet tool](/dotnet/core/tools/global-tools) requires the [.NET Core SDK](https://dotnet.microsoft.com/download/dotnet/6.0) v6.0 or later to be installed on your machine. Installing SqlPackage as a global tool will make it available on your path as `SqlPackage` and is the recommended way to install SqlPackage for Windows, macOS, and Linux.
3833

39-
Installing the NuGet package via the .NET CLI is accomplished with this command:
34+
To install SqlPackage as a global .NET tool, run the following command:
4035

41-
```cmd
42-
dotnet add package Microsoft.SqlServer.DacFx
36+
```bash
37+
dotnet tool install -g Microsoft.SqlPackage
4338
```
4439

45-
> [!NOTE]
46-
> Additional NuGet packages were published under the DacFx name, "Microsoft.SqlServer.DacFx.x64" and "Microsoft.SqlServer.DacFx.x86". Support for both platforms is covered under the "Microsoft.SqlServer.DacFx" package. New references should be made to this package, not the x64 or x86 variants.
40+
To update SqlPackage to the latest version, run the following command:
4741

48-
## Automated environments
42+
```bash
43+
dotnet tool update -g Microsoft.SqlPackage
44+
```
4945

50-
Evergreen links are available for downloading the latest Sqlpackage versions:
51-
- Linux ([https://aka.ms/sqlpackage-linux](https://aka.ms/sqlpackage-linux))
52-
- macOS ([https://aka.ms/sqlpackage-macos](https://aka.ms/sqlpackage-macos))
53-
- Windows ([https://aka.ms/sqlpackage-windows](https://aka.ms/sqlpackage-windows))
54-
- Windows, .NET Framework ([https://aka.ms/dacfx-msi](https://aka.ms/dacfx-msi))
46+
To uninstall SqlPackage, run the following command:
47+
48+
```bash
49+
dotnet tool uninstall -g Microsoft.SqlPackage
50+
```
5551

56-
## Linux
52+
## Installation, zip download
53+
54+
|Platform|Download|
55+
|:---|:---|
56+
|[Windows .NET 6](#windows-net-6) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214842)|
57+
|[Windows](#windows-net-framework)|[MSI Installer](https://go.microsoft.com/fwlink/?linkid=2214739)|
58+
|[macOS .NET 6](#macos) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214740)|
59+
|[Linux .NET 6](#linux) |[.zip file](https://go.microsoft.com/fwlink/?linkid=2214843)|
60+
61+
62+
### Linux
5763

5864
1. Download [SqlPackage for Linux](https://aka.ms/sqlpackage-linux).
5965
2. To extract the file and launch SqlPackage, open a new Terminal window and type the following commands:
@@ -96,7 +102,7 @@ Evergreen links are available for downloading the latest Sqlpackage versions:
96102
sudo apt-get install libicu66 # for 20.x
97103
```
98104

99-
## macOS
105+
### macOS
100106

101107
1. Download [SqlPackage for macOS](https://aka.ms/sqlpackage-macos).
102108
2. To extract the file and launch SqlPackage, open a new Terminal window and type the following commands:
@@ -123,7 +129,7 @@ Evergreen links are available for downloading the latest Sqlpackage versions:
123129
sudo spctl --master-enable
124130
```
125131

126-
## Windows (.NET 6)
132+
### Windows (.NET 6)
127133

128134
1. Download [SqlPackage for Windows](https://aka.ms/sqlpackage-windows).
129135
2. To extract the file by right clicking on the file in Windows Explorer, and selecting 'Extract All...', and select the target directory.
@@ -133,20 +139,42 @@ Evergreen links are available for downloading the latest Sqlpackage versions:
133139
> sqlpackage
134140
```
135141

136-
## Windows (.NET Framework)
142+
### Windows (.NET Framework)
137143

138144
This release of SqlPackage includes a standard Windows installer experience, and a .zip:
139145

140146
1. Download and run the [DacFramework.msi installer for Windows](https://aka.ms/dacfx-msi).
141147
2. Open a new Command Prompt window, and run SqlPackage.exe
142148
- SqlPackage is installed to the ```C:\Program Files\Microsoft SQL Server\160\DAC\bin``` folder
143149

144-
## Uninstall SqlPackage
150+
### Uninstall SqlPackage
145151

146152
If you installed SqlPackage using the Windows installer, then uninstall the same way you remove any Windows application.
147153

148154
If you installed SqlPackage with a .zip or other archive, then delete the files.
149155

156+
### Automated environments
157+
158+
Evergreen links are available for downloading the latest Sqlpackage versions:
159+
- Linux ([https://aka.ms/sqlpackage-linux](https://aka.ms/sqlpackage-linux))
160+
- macOS ([https://aka.ms/sqlpackage-macos](https://aka.ms/sqlpackage-macos))
161+
- Windows ([https://aka.ms/sqlpackage-windows](https://aka.ms/sqlpackage-windows))
162+
- Windows, .NET Framework ([https://aka.ms/dacfx-msi](https://aka.ms/dacfx-msi))
163+
164+
## DacFx
165+
166+
SqlPackage is a command-line interface for the DacFx framework, exposing some of the public DacFx APIs. DacServices ([Microsoft.SqlServer.Dac](/dotnet/api/microsoft.sqlserver.dac.dacservices)) is a related mechanism for integrating database deployment into your application pipeline. The DacServices API is available in a package through NuGet, [Microsoft.SqlServer.DacFx](https://www.NuGet.org/packages/Microsoft.SqlServer.DacFx). The current DacFx version is 161.6370.0.
167+
168+
Adding the NuGet package to a .NET project is accomplished via the .NET CLI with this command:
169+
170+
```cmd
171+
dotnet add package Microsoft.SqlServer.DacFx
172+
```
173+
174+
> [!NOTE]
175+
> Additional NuGet packages were published under the DacFx name, "Microsoft.SqlServer.DacFx.x64" and "Microsoft.SqlServer.DacFx.x86". Support for both platforms is covered under the "Microsoft.SqlServer.DacFx" package. New references should be made to this package, not the x64 or x86 variants.
176+
177+
150178
## Supported Operating Systems
151179

152180
SqlPackage runs on Windows, macOS, and Linux and is built using .NET 6. The [.NET 6 OS requirements](https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md) are minimum requirements for SqlPackage, which has additional requirements due to its dependencies.

0 commit comments

Comments
 (0)