Download and install Azure Data Studio

Azure Data Studio is a cross-platform database tool for data professionals who use on-premises and cloud data platforms on Windows, macOS, and Linux.

Azure Data Studio offers a modern editor experience with IntelliSense, code snippets, source control integration, and an integrated terminal. It's engineered with the data platform user in mind, with the built-in charting of query result sets and customizable dashboards.

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.38.0 is the latest general availability (GA) version.

• Release number: 1.38.0
• Release date: July 27, 2022

Platform	Download
Windows	User installer (recommended) System installer .zip file
macOS	.zip file
Linux	.deb file .rpm file .tar.gz file

Note

Azure Data Studio currently does not support the ARM architecture.

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 by doing the following:

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.

Linux installation

Install with a .deb file

1. Download Azure Data Studio for Linux by using the .deb file.

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

   cd ~
   sudo dpkg -i ./Downloads/azuredatastudio-linux-<version string>.deb
   

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

   azuredatastudio
   

Note

You might have missing dependencies. To install them, run the following command:

sudo apt-get install libunwind8

Install with an .rpm file

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

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

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

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

   azuredatastudio
   

Note

You might have missing dependencies. To install them, run the following command:

yum install libXScrnSaver

Install with a .tar.gz file

1. Download Azure Data Studio for 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
   

Note

You might have missing dependencies. To install them, run the following command:

sudo apt-get install libxss1 libgconf-2-4 libunwind8

Windows Subsystem for Linux

1. Install Azure Data Studio for Windows. Then, use the azuredatastudio command in a Windows Subsystem for Linux (WSL) terminal just as you would in a standard command prompt. By default, the application is stored in your AppData folder.

2. Start Azure Data Studio from the WSL command prompt. When you're using the default Windows installation, start the application by running the following command:

   '/mnt/c/Users/<your user name>/AppData/Local/Programs/Azure Data Studio/azuredatastudio.exe'
   

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: 7 (with SP1), 8, 8.1, 10, 11
• Windows Server: 2016, 2019, 2022
• macOS: 10.12+, 11, 12
• Linux: Debian 9+, RHEL 7+, 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 (Preview)
• SQL Server 2019
• SQL Server 2017
• SQL Server 2016

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, do the following:

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.

   

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

   

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.

   

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 disc on Mac by doing the following:

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

2. Do one of the following:

   • 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

In Debian

You can uninstall Azure Data Studio under Debian or Ubuntu Linux.

To list installed software type, run the following commands:

dpkg --list
dpkg --list | less
dpkg --list | grep apache

To delete the software, run the following commands:

sudo apt-get remove azuredatastudio
sudo apt-get remove apache

In RedHat

Use the rpm or yum command to delete Azure Data Studio.

To list the installed software type, run the following commands:

rpm -qa | less
rpm -qa azuredatastudio
yum list | less
yum list azuredatastudio

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

rpm -qa azuredatastudio
yum list azuredatastudio

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

rpm -e azuredatastudio
yum remove azuredatastudio

Next steps

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

• Azure Data Studio release notes
• What is Azure Data Studio?
• SQL tools
• Azure Data Architecture Guide
• SQL Server Blog

Get help for SQL tools

• All the ways to get help
• Submit an Azure Data Studio Git issue
• Contribute to Azure Data Studio
• SQL Client Tools Forum
• SQL Server Data Tools - MSDN forum
• Support options for business users

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.