Partilhar via

Instalar a CLI de Dados do Azure (azdata) com o pip

  • Artigo

Aplica-se a: Azure Data CLI (azdata)

Este artigo descreve como instalar a ferramenta Azure Data CLI (azdata) no Windows, Linux ou macOS usando pip.

Dica

Para uma experiência mais simples, azdata pode ser instalado com um gerenciador de pacotes para Windows, Linux (distribuições Ubuntu, Debian, RHEL, openSUSE e LES) e macOS.

Pré-requisitos

azdata é um utilitário de linha de comando escrito em Python que permite aos administradores de cluster inicializar e gerenciar recursos de dados por meio de APIs REST. A versão mínima necessária do Python é v3.6. pip é necessário para baixar e instalar a ferramenta azdata. As instruções a seguir fornecem exemplos para Windows, Linux (Ubuntu) e macOS. Para instalar o Python em outras plataformas, consulte a documentação do Python. Além disso, instale e atualize a versão mais recente do requests pacote Python:

pip3 install -U requests

Instalação do Windows azdata

  1. Em um cliente Windows, baixe o pacote Python necessário do https://www.python.org/downloads/. Para python 3.6 e posterior, pip3 também é instalado quando você instala o Python.

    Dica

    Ao instalar o Python3, selecione a opção para adicionar o Python ao seu PATH. Se não o fizeres, podes mais tarde encontrar onde está localizado o pip3 e adicioná-lo manualmente ao teu PATH.

  2. Abra uma nova sessão do Windows PowerShell para que ela obtenha o caminho mais recente com o Python.

  3. A partir da versão CU5 do SQL Server 2019, azdata tem uma versão semântica independente do servidor. Se você tiver versões anteriores de azdata instaladas mais antigas do que esta, é importante primeiro desinstalá-las antes de instalar a versão mais recente.

    Por exemplo, para 2019-cu4, execute o seguinte comando:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu4/requirements.txt

    Observação

    Nos exemplos anteriores, substitua 2019-cu6 pela versão e CU da sua instalação do azdata.

  4. Instale azdata.

    pip3 install -r https://aka.ms/azdata

Instalação do Linux azdata

No Linux, você deve instalar o Python 3.6 e, em seguida, atualizar pip. O exemplo a seguir mostra os comandos que funcionariam para o Ubuntu. Para outras plataformas Linux, consulte a documentação do Python .

  1. Instale os pacotes Python necessários:

    sudo apt-get update && \
sudo apt-get install -y python3 && \
sudo apt-get install -y python3-pip && \
sudo apt-get install -y libkrb5-dev && \
sudo apt-get install -y libsqlite3-dev && \
sudo apt-get install -y unixodbc-dev

  2. Atualizar pip3.

    sudo -H pip3 install --upgrade pip

  3. A partir da versão CU5 do SQL Server 2019, azdata tem uma versão semântica independente do servidor. Se você tiver versões anteriores de azdata instaladas mais antigas do que esta, é importante primeiro desinstalá-las antes de instalar a versão mais recente.

    Por exemplo, para 2019-cu6, execute o seguinte comando:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-cu6/requirements.txt

    Observação

    Nos exemplos anteriores, substitua 2019-cu6 pela versão e CU da sua instalação do azdata.

  4. Instale azdata.

    pip3 install -r https://aka.ms/azdata --user

    Observação

    A opção --user instala azdata no diretório de instalação do utilizador do Python. Isso normalmente é ~/.local/bin no Linux. Adicione este diretório ao seu caminho ou navegue até o diretório de instalação do usuário e execute ./azdata a partir daí.

Instalar o azdata no macOS

Para instalar o azdata no macOS, conclua estes passos. Para cada etapa, execute o exemplo no Terminal.

  1. Em um cliente macOS, instale Homebrew se ainda não o tiver:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  2. Instale Python e pip, versão mínima 3.0:

    brew install python3

  3. Instalar dependências:

    pip3 install -U requests
brew install freetds

  4. A partir da versão CU5 do SQL Server 2019, azdata tem uma versão semântica independente do servidor. Se você tiver versões anteriores de azdata instaladas mais antigas do que esta, é importante primeiro desinstalá-las antes de instalar a versão mais recente. Por exemplo, o seguinte comando remove a versão RC1 do azdata:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt

  5. Instale a CLI de Dados do Azure.

    pip3 install -r https://aka.ms/azdata

Conteúdo relacionado