다음을 통해 공유


pip를 사용하여 Azure Data CLI(azdata) 설치

적용 대상: Azure Data CLI(azdata)

이 문서에서는 pip를 사용하여 Windows, Linux 또는 macOS에 Azure Data CLI(azdata) 도구를 설치하는 방법을 설명합니다.

더 간단한 환경을 위해 Windows, Linux(Ubuntu, Debian, RHEL, openSUSE 및 SLE 배포판) 및 macOS용 패키지 관리자와 함께 azdata를 설치할 수 있습니다.

필수 조건

azdata는 Python으로 작성된 명령줄 유틸리티로, 클러스터 관리자가 REST API를 통해 데이터 리소스를 부트스트랩하고 관리할 수 있게 해줍니다. 필요한 최소 Python 버전은 v3.6입니다. pipazdata도구를 다운로드하고 설치하는 데 필요합니다. 다음 지침은 Windows, Linux(Ubuntu) 및 macOS에 대한 예제를 제공합니다. 다른 플랫폼에 Python을 설치하는 방법은 Python 설명서를 참조하십시오. 그리고 최신 버전의 requests Python 패키지를 설치하고 업데이트합니다.

pip3 install -U requests

Windows azdata 설치

  1. Windows 클라이언트에서 필요한 Python 패키지를 https://www.python.org/downloads/에서 다운로드합니다. python 3.6 이상에서 Python을 설치하면 pip3도 설치됩니다.

    Python3을 설치할 때 PATH에 Python을 추가합니다. 추가하지 않는 경우 나중에 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-cu6azdata 설치의 버전 및 CU로 바꿉니다.

  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-cu6azdata 설치의 버전 및 CU로 바꿉니다.

  4. azdata를 설치합니다.

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

    참고 항목

    --user 스위치를 사용하면 Python 사용자 설치 디렉터리에 azdata가 설치됩니다. 이는 일반적으로 Linux의 ~/.local/bin에서 수행됩니다. 이 디렉터리를 경로에 추가하거나 사용자 설치 디렉터리로 이동하고 해당 디렉터리에서 ./azdata를 실행합니다.

macOS에 azdata 설치

macOS에 azdata를 설치하려면 다음 단계를 완료합니다. 각 단계에 대해 터미널에서 예제를 실행합니다.

  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가 설치되어 있는 경우 최신 버전을 설치하기 전에 먼저 제거하는 것이 중요합니다. 예를 들어 다음 명령은 azdata의 RC1 버전을 제거합니다.

    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