Установка Azure Data CLI (azdata) с помощью pip

Область применения: Azure Data CLI ()azdata

В этой статье описывается установка средства Azure Data CLI (azdata) в Windows, Linux или macOS pip.

Совет

Чтобы упростить работу, azdata можно установить с помощью диспетчера пакетов для Windows, Linux (Ubuntu, Debian, RHEL, openSUSE и SLE) и macOS.

Необходимые компоненты

azdata — это служебная программа командной строки на языке Python, которая позволяет администраторам кластера выполнять начальную загрузку ресурсов данных и управлять ими с помощью REST API. Минимальная требуемая версия Python — 3.6. Для загрузки и установки средства azdata требуется pip. Ниже приведены примеры для Windows, Linux (Ubuntu) и macOS. Сведения об установке Python на других платформах см. в документации по Python. Кроме того, нужно также установить и обновить последнюю версию пакета Python requests.

pip3 install -U requests

Установка Windows azdata

  1. В клиенте Windows скачайте необходимый пакет Python из https://www.python.org/downloads/. В Python 3.6 и более поздних версий pip3 устанавливается вместе с Python.

    Совет

    При установке Python3 добавьте Python в свою переменную PATH. Если вы этого не сделали, вы можете позже найти расположение pip3 и вручную добавить его в ваш PATH.

  2. Откройте новый сеанс Windows PowerShell, чтобы он использовал актуальный путь для Python.

  3. Начиная с выпуска SQL Server 2019 CU5, azdata имеет независимую семантическую версию от сервера. Если у вас есть предыдущие выпуски более ранних версий azdata , важно сначала удалить их перед установкой последней версии.

    Например, для 2019-cu4 выполните следующую команду:

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

    Примечание.

    В приведенных выше примерах замените 2019-cu6 на версию и CU вашей установки azdata.

  4. Установите azdata.

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

Установка Linux azdata

В Linux нужно установить Python 3.6, а затем обновить pip. В следующем примере показаны команды, которые будут работать для Ubuntu. Сведения о других платформах Linux см. в документации по Python.

  1. Установите необходимые пакеты Python.

    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. Обновите pip3.

    sudo -H pip3 install --upgrade pip
    
  3. Начиная с выпуска SQL Server 2019 CU5, azdata имеет независимую семантическую версию от сервера. Если у вас есть предыдущие выпуски более ранних версий azdata , важно сначала удалить их перед установкой последней версии.

    Например, для 2019-cu6 выполните следующую команду:

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

    Примечание.

    В приведенных выше примерах замените 2019-cu6 на версию и CU вашей установки azdata.

  4. Установите azdata.

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

    Примечание.

    Параметр --user задает установку azdata в пользовательский каталог установки Python. В Linux это обычно ~/.local/bin. Добавьте этот каталог в путь или перейдите в пользовательский каталог установки и запустите ./azdata оттуда.

Установка azdata в macOS

Чтобы установить azdata в macOS, выполните следующие действия. Для каждого шага запустите пример в окне терминала.

  1. На клиенте macOS установите программу Homebrew, если она еще не установлена.

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Установите Python и pip (минимальная версия 3.0):

    brew install python3
    
  3. Установите зависимости:

    pip3 install -U requests
    brew install freetds
    
  4. Начиная с выпуска SQL Server 2019 CU5, azdata имеет независимую семантическую версию от сервера. Если у вас есть предыдущие выпуски более ранних версий azdata , важно сначала удалить их перед установкой последней версии. Например, следующая команда удаляет версию RC1 azdata:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt
    
  5. Установите Azure Data CLI.

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