Share via

Instalación de CLI de datos de Azure (azdata) con pip

  • Artículo

Se aplica a: CLI de datos de Azure (azdata)

Precaución

En este artículo se hace referencia a CentOS, una distribución de Linux que está cerca de su estado Final de ciclo vida (EOL). Tenga en cuenta su uso y planifique en consecuencia. Para obtener más información, consulte la Guía de fin de ciclo de vida de CentOS.

En este artículo se explica cómo instalar la herramienta CLI de datos de Azure (azdata) en Windows, Linux o macOS/OS X mediante pip.

Sugerencia

Para obtener una experiencia más sencilla, azdata se puede instalar con un administrador de paquetes para Windows, Linux (distribuciones de Ubuntu, Debian, RHEL, CentOS, openSUSE y SLE) y macOS.

Requisitos previos

azdata es una utilidad de línea de comandos escrita en Python que permite a los administradores de clústeres arrancar y administrar recursos de datos mediante API REST. La versión mínima de Python necesaria es v3.6. Para descargar e instalar la herramienta azdata, se requiere pip. En las instrucciones siguientes se proporcionan ejemplos para Windows, Linux (Ubuntu) y macOS/OS X. Para instalar Python en otras plataformas, consulte la documentación de Python. Además, instale y actualice la versión más reciente del paquete Python requests:

pip3 install -U requests

Instalación de azdata en Windows

  1. En un cliente de Windows, descargue el paquete de Python necesario desde https://www.python.org/downloads/. Para Python 3.6 y versiones posteriores, al instalar Python también se instala pip3.

    Sugerencia

    Al instalar Python3, seleccione agregar Python al elemento PATH. Si no lo hace, más adelante podrá buscar dónde se encuentra pip3 y agregarlo manualmente al elemento PATH.

  2. Abra una nueva sesión de Windows PowerShell para que obtenga la ruta de acceso más reciente con Python.

  3. A partir de la versión SQL Server 2019 CU5, azdata tiene una versión semántica independiente del servidor. Si tiene instaladas versiones anteriores de azdata, es importante que las desinstale antes de instalar la versión más reciente.

    Por ejemplo, para 2019-cu4, ejecute el siguiente comando:

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

Nota

En los ejemplos anteriores, reemplace 2019-cu6 por la versión y CU de la instalación de azdata.

  1. Instalar azdata.

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

Instalación de azdata en Linux

En Linux, debe instalar Python 3.6 y, después, actualizar pip. En el ejemplo siguiente se muestran los comandos que funcionarían para Ubuntu. Para otras plataformas Linux, consulte la documentación de Python.

  1. Instale los paquetes de Python necesarios:

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

    sudo -H pip3 install --upgrade pip

  3. A partir de la versión SQL Server 2019 CU5, azdata tiene una versión semántica independiente del servidor. Si tiene instaladas versiones anteriores de azdata, es importante que las desinstale antes de instalar la versión más reciente.

    Por ejemplo, para 2019-cu6, ejecute el siguiente comando:

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

Nota

En los ejemplos anteriores, reemplace 2019-cu6 por la versión y CU de la instalación de azdata.

  1. Instalar azdata.

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

    Nota

    El modificador --user instala azdata en el directorio de instalación del usuario de Python. En Linux, habitualmente es ~/.local/bin. Agregue este directorio a la ruta de acceso o bien navegue hasta el directorio de instalación del usuario y ejecute ./azdata desde allí.

Instalación de azdata en macOS u OS X

Para instalar azdata en macOS u OS X complete estos pasos. Para cada paso, ejecute el ejemplo en Terminal.

  1. En un cliente macOS, instale Homebrew, si aún no lo tiene instalado:

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

  2. Instale, como mínimo, la versión 3.0 de Python y pip:

    brew install python3

  3. Instale las dependencias:

    pip3 install -U requests
brew install freetds

  4. A partir de la versión SQL Server 2019 CU5, azdata tiene una versión semántica independiente del servidor. Si tiene instaladas versiones anteriores de azdata, es importante que las desinstale antes de instalar la versión más reciente. Por ejemplo, el comando siguiente quita la versión RC1 de azdata:

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

  5. Instale la CLI de Azure Data.

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

Pasos siguientes

Vea ¿Qué son los Clústeres de macrodatos de SQL Server 2019? para obtener más información sobre los clústeres de macrodatos.