Edit

Download and install Azure Data Studio

  • Article

Azure Data Studio is a lightweight, cross-platform data management and development tool with connectivity to popular cloud and on-premises databases. Azure Data Studio supports Windows, macOS, and Linux, with immediate capability to connect to Azure SQL and SQL Server. Browse the extension library for more database support options including MySQL, PostgreSQL, and CosmosDB.

Azure Data Studio's familiar interface offers a modern editor experience with IntelliSense, code snippets, source control integration, and an integrated terminal. Engineered with the data platform user in mind, its extensibility allows users to customize their experience by installing the extensions relevant to their workflow, including database migrations, charting, GitHub Copilot, and more!

Use Azure Data Studio to query, design, and manage your databases and data warehouses wherever they are, on your local computer or in the cloud.

For more information about Azure Data Studio, visit What is Azure Data Studio?.

Download Azure Data Studio

Azure Data Studio 1.46.0 is the latest general availability (GA) version.

  • Release number: 1.46.0
  • Release date: September 20, 2023
Platform Type Download
Windows User Installer 64-bit ARM64
System Installer 64-bit ARM64
.zip 64 bit ARM64
Linux .tar.gz 64-bit
.deb 64-bit
.rpm1 64-bit
macOS .zip Universal Intel Chip Apple Silicon

1 There is a known issue with install on RHEL. For more information see the release notes.

If you have comments or suggestions or want to report a problem with downloading Azure Data Studio, submit an issue to our team on the Azure Data Studio feedback page.

Install Azure Data Studio

Windows installation

Important

Beginning with SQL Server Management Studio (SSMS) 18.7, Azure Data Studio is automatically installed alongside SSMS. Users of SQL Server Management Studio are now able to benefit from the innovations and features in Azure Data Studio. Azure Data Studio is a cross-platform and open-source desktop tool for your environments, whether in the cloud, on-premises, or hybrid.

To learn more about Azure Data Studio, check out What is Azure Data Studio or the FAQ.

This release of Azure Data Studio includes a standard Windows installer experience and a .zip file.

We recommend the user installer, which simplifies installations and updates and doesn't require Administrator privileges. (It doesn't require Administrator privileges because the location is under your user Local AppData (LOCALAPPDATA) folder.) The user installer also provides a smoother background update experience. For more information, see User setup for Windows.

User installer (recommended)

  1. Download and run the Azure Data Studio user installer for Windows.

  2. Start the Azure Data Studio app.

System installer

  1. Download and run the Azure Data Studio system installer for Windows.

  2. Start the Azure Data Studio app.

.zip file

  1. Download the Azure Data Studio .zip file for Windows.

  2. Go to the downloaded file and extract it.

  3. Run \azuredatastudio-windows\azuredatastudio.exe.

Unattended installation for Windows

You can also install Azure Data Studio by using a command prompt script.

For Windows, install Azure Data Studio in the background without prompts using the following steps:

  1. Open the command prompt window with elevated permissions.

  2. Run the following command:

    <path where the azuredatastudio-windows-user-setup-x.xx.x.exe file is located> /VERYSILENT /MERGETASKS=!runcode>

    Example:

    %systemdrive%\azuredatastudio-windows-user-setup-1.24.0.exe /VERYSILENT /MERGETASKS=!runcode

    Note

    The following example also works with the system installer file.

    <path where the azuredatastudio-windows-setup-x.xx.x.exe file is located> /VERYSILENT /MERGETASKS=!runcode>

    In the preceding code, you can also pass /SILENT instead of /VERYSILENT to see the setup user interface.

  3. If you've run the commands successfully, you can see Azure Data Studio installed.

macOS installation

  1. Download Azure Data Studio for macOS.

  2. To expand the contents of the .zip file, double-click it.

  3. To make Azure Data Studio available in Launchpad, drag the Azure Data Studio.app file to the Applications folder.

Note

For Apple Silicon users, please make sure you have Rosetta 2 installed. Some backend services are yet to be converted to native ARM64 binaries. You can run the following command in a Terminal window to install Rosetta 2.

/usr/sbin/softwareupdate --install-rosetta --agree-to-license

Linux installation

You can install Azure Data Studio on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), Ubuntu, Debian, and Windows Subsystem for Linux (WSL).

Install using .rpm file

  1. Download Azure Data Studio for Red Hat Enterprise Linux by using the .rpm file.

  2. To extract the file, open a new terminal window, and then run the following commands:

    cd ~
sudo yum install ./Downloads/azuredatastudio-linux-<version string>.rpm

  3. To start Azure Data Studio, run this command:

    azuredatastudio

If you have missing dependencies, install them with following command:

yum install libXScrnSaver

Install using .tar.gz file

  1. Download Azure Data Studio for Red Hat Enterprise Linux by using the .tar.gz file.

  2. To extract the file, open a new terminal window, and then run the following commands:

    cd ~
cp ~/Downloads/azuredatastudio-linux-<version string>.tar.gz ~
tar -xvf ~/azuredatastudio-linux-<version string>.tar.gz
echo 'export PATH="$PATH:~/azuredatastudio-linux-x64"' >> ~/.bashrc
source ~/.bashrc

  3. To start Azure Data Studio, run this command:

    azuredatastudio

If you have missing dependencies, install them with the following command:

yum install libxss1 libgconf-2-4 libunwind8

What's new with Azure Data Studio

For details about the latest release of Azure Data Studio, see Release notes for Azure Data Studio.

Download the GA release of Azure Data Studio

We recommend that you download the general availability (GA) release of Azure Data Studio.

Download the insiders build of Azure Data Studio

As an alternative, if you want to try out the beta features and send feedback, you can download the insiders build of Azure Data Studio.

Supported operating systems

Azure Data Studio runs on Windows, macOS, and Linux. The following versions are supported:

  • Windows: 10 and later versions
  • Windows Server: 2016, 2019, 2022
  • macOS: 10.12+ (Sierra) and later versions
  • Linux: Debian 9+, RHEL 7+, SLES 15, Ubuntu 18.04+

Note

Incremental versions within a major operating system release may no longer be in support by the operating system. Consult the documentation for your operating system to ensure you have received applicable updates.

Supported SQL Server versions

Azure Data Studio supports connecting to the following versions of SQL Server:

  • Azure SQL Database
  • Azure SQL Managed Instance
  • SQL Server 2022 (16.x)
  • SQL Server 2019 (15.x)
  • SQL Server 2017 (14.x)
  • SQL Server 2016 (13.x)

System requirements

Requirement level CPU cores RAM memory
Recommended 4 8 GB
Minimum 2 4 GB

Check for updates

To check for the latest updates, on the left pane, select Manage (gear icon), and then select Check for Updates.

To apply environment updates offline, install the latest version directly over your previously installed version. You don't need to uninstall earlier versions of Azure Data Studio. If an earlier version is present, the installer automatically updates to the latest version.

Move user settings

If you're updating SQL Operations Studio to Azure Data Studio and want to keep your settings, keyboard shortcuts, or code snippets, complete the following steps:

Note

If you've already installed Azure Data Studio or you've never installed or customized SQL Operations Studio, you can ignore this section.

  1. On the left pane, select Manage (gear icon) and then select Settings.

    Screenshot of the Azure Data Studio Manage icon and Settings command.

  2. At the top, right-click the User Settings tab, and then select Reveal in Explorer.

    Screenshot of the Reveal in Explorer command in the User Settings tab.

  3. Copy all files in this folder and save them in an easy-to-find location on your local drive, such as your Documents folder.

    Screenshot of the settings.json file in the Windows Explorer folder structure.

  4. In your updated version of Azure Data Studio, follow steps 1 and 2 and then, for step 3, paste the contents you saved into the folder. You can also manually copy over the settings, key bindings, or snippets in their respective locations.

  5. If you're overriding your current installation, before you do so, delete the old installation directory to avoid errors connecting to your Azure account for the resource explorer.

Uninstall Azure Data Studio from Windows

If you installed Azure Data Studio by using the Windows installer, uninstall it just as you would any Windows application.

If you installed Azure Data Studio with a .zip file or other archive, delete that file.

Uninstall Azure Data Studio from macOS

You can uninstall apps from the Internet or drive on Mac by completing the following steps:

  1. Select the Finder icon in the Dock, and then select Applications in the Finder sidebar.

  2. Do one of the following steps:

    • If an app is in a folder, open the app's folder to check for an uninstaller. Double-click Uninstall [App] or [App] Uninstaller, and then follow the onscreen instructions.

    • If an app isn't in a folder or doesn't have an uninstaller, drag the app from the Applications folder to the Trash (at the end of the Dock).

To uninstall apps you've downloaded from the App Store, use Launchpad.

Uninstall Azure Data Studio from Linux

Use the rpm, yum, or dnf command to delete Azure Data Studio under Red Hat Enterprise Linux.

To list installed software, run one of the following commands:

sudo rpm -qa | less
sudo yum list | less
sudo dnf list | less

To get information about the azuredatastudio package, run one of the following commands:

sudo rpm -qa azuredatastudio
sudo yum list azuredatastudio
sudo dnf list azuredatastudio

To delete a package called azuredatastudio, run one of the following commands:

sudo rpm -e azuredatastudio
sudo yum remove azuredatastudio
sudo dnf remove azuredatastudio

Next steps

To learn more about Azure Data Studio, see the following resources:

Get help for SQL tools

Contribute to SQL documentation

Did you know that you can edit SQL content yourself? If you do so, not only do you help improve our documentation, but you also get credited as a contributor to the page.

For more information, see How to contribute to SQL Server documentation

Microsoft Privacy Statement and Enable or disable usage data collection for Azure Data Studio.