Compartilhar via


Instalar CLI de Dados do Azure (azdata) com pip

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

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

Dica

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

Pré-requisitos

O azdata é um utilitário de linha de comando escrito em Python que permite aos administradores de cluster inicializar e gerenciar os recursos de dados por meio de APIs REST. A versão mínima do Python necessária é v3.6. O 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, confira a Documentação do Python. Além disso, instale e atualize a versão mais recente do pacote de Python requests:

pip3 install -U requests

Instalação de azdata no Windows

  1. Em um cliente Windows, baixe o pacote de Python necessário em https://www.python.org/downloads/. Para o Python 3.6 e posterior, o pip3 também será instalado ao instalar o Python.

    Dica

    Ao instalar o Python3, selecione para adicionar o Python ao seu PATH. Se não fizer isso, você poderá descobrir mais tarde onde o pip3 está localizado e adicioná-lo manualmente ao seu PATH.

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

  3. Na versão SQL Server 2019 CU5 e posteriores, azdata tem uma versão semântica independente do servidor. Caso você tenha versões anteriores de azdata instaladas antes disso, será importante desinstalá-las antes de instalar a última versão.

    Por exemplo, para o 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 a CU da sua instalação do azdata.

  4. Instale o azdata.

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

Instalação de azdata em Linux

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

  1. Instale os pacotes de 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. Atualize o pip3.

    sudo -H pip3 install --upgrade pip
    
  3. Na versão SQL Server 2019 CU5 e posteriores, azdata tem uma versão semântica independente do servidor. Caso você tenha versões anteriores de azdata instaladas antes disso, será importante desinstalá-las antes de instalar a última versão.

    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 a CU da sua instalação do azdata.

  4. Instale o azdata.

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

    Observação

    O comutador --user instala azdata no diretório de instalação do usuário do Python. Normalmente, ele é ~/.local/bin no Linux. Adicione esse diretório ao seu caminho ou navegue até o diretório de instalação do usuário e execute ./azdata nele.

Instalar o azdata no macOS

Para instalar o azdata no macOS, conclua estas etapas. Para cada etapa, execute o exemplo no Terminal.

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

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Instale o Python e o pip, com a versão mínima 3.0:

    brew install python3
    
  3. Instale as dependências:

    pip3 install -U requests
    brew install freetds
    
  4. Na versão SQL Server 2019 CU5 e posteriores, azdata tem uma versão semântica independente do servidor. Caso você tenha versões anteriores de azdata instaladas antes disso, será importante desinstalá-las antes de instalar a última versão. 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