Dela via


Installera Azure Data CLI (azdata) med pip

gäller för: Azure Data CLI (azdata)

Den här artikeln beskriver hur du installerar verktyget Azure Data CLI (azdata) i Windows, Linux eller macOS med hjälp av pip.

Tips

För en enklare upplevelse kan azdata installeras med en pakethanterare för Windows, Linux (Ubuntu, Debian, RHEL, openSUSE- och SLE-distributioner) och macOS.

Förutsättningar

azdata är ett kommandoradsverktyg skrivet i Python som gör det möjligt för klusteradministratörer att starta och hantera dataresurser via REST-API:er. Den lägsta Python-version som krävs är v3.6. pip krävs för att ladda ned och installera verktyget azdata. Följande instruktioner innehåller exempel för Windows, Linux (Ubuntu) och macOS. Information om hur du installerar Python på andra plattformar finns i Python-dokumentationen. Installera och uppdatera dessutom den senaste versionen av requests Python-paket:

pip3 install -U requests

Windows azdata installation

  1. På en Windows-klient laddar du ned det nödvändiga Python-paketet från https://www.python.org/downloads/. För Python 3.6 och senare installeras pip3 även när du installerar Python.

    Tips

    När du installerar Python3 väljer du att lägga till Python i din PATH. Om du inte gör det kan du senare hitta var pip3 finns och lägga till det manuellt i din PATH.

  2. Öppna en ny Windows PowerShell-session så att den får den senaste sökvägen med Python i den.

  3. Från och med utgåvan av SQL Server 2019 CU5 har azdata en oberoende semantisk version från serverns. Om du har tidigare versioner av azdata installerats äldre än så är det viktigt att först avinstallera dem innan du installerar den senaste versionen.

    Kör till exempel följande kommando för 2019-cu4:

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

    Not

    I föregående exempel ersätter du 2019-cu6 med versionen och CU för din installation av azdata.

  4. Installera azdata.

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

Installation av Linux azdata

I Linux måste du installera Python 3.6 och sedan uppgradera pip. I följande exempel visas de kommandon som skulle fungera för Ubuntu. För andra Linux-plattformar, se Python-dokumentationen.

  1. Installera nödvändiga Python-paket:

    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. Uppgradera pip3.

    sudo -H pip3 install --upgrade pip
    
  3. Från och med SQL Server 2019 CU5-versionen har azdata en oberoende semantisk version jämfört med servern. Om du har tidigare versioner av azdata installerats äldre än så är det viktigt att först avinstallera dem innan du installerar den senaste versionen.

    Kör till exempel följande kommando för 2019-cu6:

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

    Notera

    I föregående exempel ersätter du 2019-cu6 med versionen och CU för din installation av azdata.

  4. Installera azdata.

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

    Anteckning

    Brytaren --user installerar azdata till användarkatalogen för Python-installationer. Detta är vanligtvis ~/.local/bin i Linux. Lägg antingen till den här katalogen i sökvägen eller navigera till användarinstallationskatalogen och kör ./azdata därifrån.

Installera azdata på macOS

Slutför de här stegen om du vill installera azdata på macOS. Kör exemplet i Terminal för varje steg.

  1. Installera Homebrew om du inte redan har den på en macOS-klient:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. Installera Python och pip, lägsta version 3.0:

    brew install python3
    
  3. Installera beroenden:

    pip3 install -U requests
    brew install freetds
    
  4. Från och med SQL Server 2019 CU5-versionen har azdata en oberoende semantisk version jämfört med servern. Om du har tidigare versioner av azdata installerats äldre än så är det viktigt att först avinstallera dem innan du installerar den senaste versionen. Följande kommando tar till exempel bort RC1-versionen av azdata:

    pip3 uninstall -r https://azdatacli.blob.core.windows.net/python/azdata/2019-rc1/requirements.txt
    
  5. Installera Azure Data CLI.

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