Instalar CLI de Dados do Azure (azdata) com apt

Aplica-se a: CLI de Dados do Azure (azdata)

Observação

Alguns cenários tratados anteriormente pela CLI de Dados do Azure (azdata) agora são gerenciados por meio de extensões da CLI do Azure (az) e fluxos de trabalho baseados no Azure Arc. Não há uma única substituição 1:1 para todos os azdata comandos. A tabela a seguir destaca alternativas comumente relacionadas do Azure CLI, onde existam.

área de comandos azdata	Extensão/grupo de comandos da CLI do Azure	Referência do Azure CLI
azdata arc dc *	az arcdata	Referência da CLI de dados do Azure Arc
azdata arc sql mi *	az arcdata sql mi	Gerenciar a Instância Gerenciada de SQL do Azure com a CLI
azdata arc postgres *	az arcdata postgres	Gerenciar o servidor PostgreSQL com a CLI
azdata migrate *	az datamigration	Migrar usando a CLI
azdata extension *	az extension *	Visão geral das extensões da CLI do Azure
azdata login	az login	az login
azdata sql shell / azdata sql query	Nenhum equivalente do Azure CLI (use sqlcmd, SSMS ou outras ferramentas SQL)	Utilitário sqlcmd SQL Server Management Studio

Para novos cenários de automação e gerenciamento, prefira a CLI do Azure (az), as extensões da CLI do Azure e as experiências do portal do Azure Arc.

Para distribuições do Linux com o apt, há um pacote para o azdata-cli. O pacote do CLI foi testado em versões do Linux que usam apt:

• Ubuntu 16.04, Ubuntu 18.04 e Ubuntu 20.04

Instalação do Python/Pip

Você pode instalar a CLI de Dados do Azure (azdata) no Linux com yum, apt ou zypper ou no MacOS com gerenciadores de pacotes de instalação homebrew. Antes desses gerenciadores de pacotes estarem disponíveis, a instalação exigia o Python e o pip.

Importante

Antes de prosseguir, você precisa remover todas as instalações do azdata que foram instaladas no sistema global Python. Os novos instaladores ou pacotes nativos adicionam azdata ao seu caminho e é impossível saber qual é o primeiro. Caso já tenha um azdata previamente instalado no Python do sistema global, remova-o antes de continuar.

Para exibir a instalação atual, execute o seguinte comando:

$ pip list --format columns

Se azdata for instalado pelo pip, ele retornará o pacote e a versão. Por exemplo:

 Package             Version
------------------- ----------
azdata-cli          15.0.X
azdata-cli-app      15.0.X
azdata-cli-cluster  15.0.X
azdata-cli-core     15.0.X
azdata-cli-hdfs     15.0.X
azdata-cli-notebook 15.0.X
azdata-cli-profile  15.0.X
azdata-cli-spark    15.0.X
azdata-cli-sql      15.0.X

O exemplo a seguir remove uma instalação do pacote pip do azdata.

$ pip freeze | grep azdata-* | xargs pip uninstall -y

Depois de verificar se você removeu qualquer instalação do azdata que foi instalado com o Pip, continue com sua instalação.

Instalar com apt

Importante

O pacote de Debian de azdata-cli depende do pacote python3. Em seu sistema, isso pode ser uma versão do Python que antecede o requisito do Python 3.6.x. Se isso representar um problema para você, encontre um pacote de substituição python3 .

1. Instale as dependências necessárias para instalar azdata-cli.

   sudo apt-get update
   sudo apt-get install gnupg ca-certificates curl wget software-properties-common apt-transport-https lsb-release -y
   

2. Importe a chave do repositório da Microsoft.

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
   

3. Crie informações sobre o repositório local.

   Para a execução do cliente Ubuntu 16.04:

   sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/16.04/prod.list)"
   

   Para a execução do cliente Ubuntu 18.04:

   sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/18.04/prod.list)"
   

   Para a execução do cliente Ubuntu 20.04:

   sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/20.04/prod.list)"
   

4. Instale azdata-cli.

   sudo apt-get update
   sudo apt-get install -y azdata-cli
   

Verificar instalação

azdata
azdata --version

Atualização

Atualize o azdata-cli com os comandos apt-get update e apt-get install.

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

Uninstall

1. Remova o pacote do seu sistema.

   sudo apt-get remove -y azdata-cli
   

2. Remova as informações do repositório se você não pretende reinstalar o azdata-cli.

   sudo rm /etc/apt/sources.list.d/azdata-cli.list
   

3. Remova a chave do repositório.

   sudo rm /etc/apt/trusted.gpg.d/dpgswdist.v1.asc.gpg
   

4. Remova dependências que não são mais necessárias.

   sudo apt autoremove
   

Próximas Etapas 

Para obter mais informações sobre clusters de Big Data, confira O que são Clusters de Big Data do SQL Server 2019?.