Install azdata to manage SQL Server Big Data Clusters on Linux

THIS TOPIC APPLIES TO:yesSQL Server noAzure SQL DatabasenoAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

This article describes how to install azdata for SQL Server 2019 Big Data Clusters on Linux. Before these package managers were available, the installation of azdata required pip.

The package managers are designed for various operating systems and distributions.

At this time, there are no package managers to install azdata on other operating systems or distributions. For these platforms, see Install azdata without package manager.

Install azdata for Linux

azdata installation package is available for Ubuntu with apt.

Install azdata with apt (Ubuntu)

Note

The azdata package does not use the system Python, rather installs its own Python interpreter.

  1. Get packages needed for the install process:

    sudo apt-get update
    sudo apt-get install gnupg ca-certificates curl apt-transport-https lsb-release -y
    
  2. Download and install the signing key:

    wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
    
  3. Add the azdata repository information:

    sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/16.04/mssql-server-2019.list)"
    
  4. Update repository information and install azdata:

    sudo apt-get update
    sudo apt-get install -y azdata-cli
    
  5. Verify installation:

    azdata --version
    

Update

Upgrade azdata only:

sudo apt-get update && sudo apt-get install --only-upgrade -y azdata-cli

Uninstall

  1. Uninstall with apt-get remove:

    sudo apt-get remove -y azdata-cli
    
  2. Remove the azdata repository information:

    Note

    This step is not needed if you plan on installing azdata in the future

    sudo rm /etc/apt/sources.list.d/azdata-cli.list
    
  3. Remove the signing key:

    sudo rm /etc/apt/trusted.gpg.d/dpgswdist.v1.asc.gpg
    
  4. Remove any unneeded dependencies that were installed with Azdata CLI:

    sudo apt autoremove
    

Next steps

For more information about big data clusters, see What are SQL Server 2019 Big Data Clusters?.