Instalación de paquetes de Python con sqlmlutils

Se aplica a: síSQL Server 2019 (15.x) SíInstancia administrada de Azure SQL

En este artículo se describe cómo usar las funciones del paquete sqlmlutils para instalar nuevos paquetes de Python en una instancia de Machine Learning Services en SQL Server y en Clústeres de macrodatos. Los paquetes que se instalen podrán usarse en los scripts de Python que se ejecutan en la base de datos mediante la instrucción T-SQL sp_execute_external_script.

En este artículo se describe cómo usar las funciones del paquete sqlmlutils para instalar nuevos paquetes de Python en una instancia de Machine Learning Services en Azure SQL Managed Instance. Los paquetes que se instalen podrán usarse en los scripts de Python que se ejecutan en la base de datos mediante la instrucción T-SQL sp_execute_external_script.

Nota

No se pueden actualizar ni desinstalar paquetes que se hayan preinstalado en una instancia de Machine Learning Services de SQL Managed Instance. Para ver una lista de los paquetes instalados actualmente, vea Enumeración de todos los paquetes de Python instalados.

Para obtener más información sobre la ubicación de los paquetes y las rutas de acceso de instalación, consulte Obtención de información de paquetes de Python.

Nota

El paquete sqlmlutils que se describe en este artículo se usa para agregar paquetes de Python a SQL Server 2019 o versiones posteriores. Para SQL Server 2017 y versiones anteriores, consulte Instalación de paquetes con las herramientas de Python.

Prerrequisitos

  • Instale Azure Data Studio en el equipo cliente que usa para conectarse a SQL Server. Puede usar otras herramientas de consulta o administración de bases de datos, pero en este artículo se da por supuesto que emplea Azure Data Studio.

  • Instale el kernel de Python en Azure Data Studio. También puede instalar y usar Python en la línea de comandos, y utilizar un entorno de desarrollo de Python alternativo como Visual Studio Code con la extensión de Python.

    La versión de Python del equipo cliente debe coincidir con la versión de Python del servidor, y los paquetes que instale deben ser compatibles con la versión de Python que tenga. Para obtener información sobre la versión de Python que se incluye con cada versión de SQL Server, vea Versiones de Python y R.

    Para comprobar la versión de Python en una instancia concreta de SQL Server, use el siguiente comando de T-SQL.

    EXECUTE sp_execute_external_script
      @language = N'Python',
      @script = N'
    import sys
    print(sys.version)
    '
    

Otras consideraciones

  • La biblioteca de paquetes de Python se encuentra en la carpeta Archivos de programa de la instancia de SQL Server y, de forma predeterminada, se requieren permisos de administrador para instalar contenido en esta carpeta. Para obtener más información, consulte Ubicación de la biblioteca de paquetes.

  • La instalación del paquete es específica de la instancia, la base de datos y el usuario de SQL especificados en la información de conexión proporcionada a sqlmlutils. Para usar el paquete en varias instancias o bases de datos de SQL, o bien para usuarios diferentes, deberá instalar el paquete para cada uno. La excepción es que si un miembro de dbo instala el paquete, este será público y se compartirá con todos los usuarios. Si un usuario instala una versión más reciente de un paquete público, este no se verá afectado, pero ese usuario tendrá acceso a la versión más reciente.

  • Antes de agregar un paquete, piense si es adecuado para el entorno de SQL Server.

    • Se recomienda usar Python en la base de datos para las tareas que se benefician de la estrecha integración con el motor de base de datos, como el aprendizaje automático, en lugar de para las tareas que simplemente consultan la base de datos.

    • Si agrega paquetes que ejercen demasiada presión de cálculo en el servidor, el rendimiento se verá afectado.

    • En un entorno de SQL Server protegido, probablemente le interese evitar lo siguiente:

      • Paquetes que requieren acceso a la red
      • Paquetes que requieren acceso con privilegios elevados al sistema de archivos
      • Paquetes que se usan para el desarrollo web u otras tareas que no obtienen ningún beneficio al ejecutarse en SQL Server
    • No se puede instalar el paquete de Python tensorflow con sqlmlutils. Para obtener más información y una solución, vea Incidencias conocidas de SQL Server Machine Learning Services.

Instalación de sqlmlutils en el equipo cliente

Para usar sqlmlutils, primero debe instalarlo en el equipo cliente que usa para conectarse a SQL Server.

En Azure Data Studio

Si va a usar sqlmlutils en Azure Data Studio, puede instalarlo mediante la característica Administrar paquetes en un cuaderno de notas del kernel de Python.

  1. En un cuaderno del kernel de Python en Azure Data Studio, haga clic en Administrar paquetes.
  2. Haga clic en Agregar nuevo.
  3. Escriba "sqlmlutils" en el campo Buscar paquetes PIP y haga clic en Buscar.
  4. Seleccione la versión del paquete que quiere instalar (se recomienda la versión más reciente).
  5. Haga clic en Instalar y luego en Cerrar.

Desde la línea de comandos de Python

Si va a usar sqlmlutils desde un símbolo del sistema de Python o un IDE, puede instalar sqlmlutils con un comando pip sencillo:

pip install sqlmlutils

También puede instalar sqlmlutils desde un archivo ZIP:

  1. Asegúrese de que tiene pip instalado. Para obtener más información, vea Instalación de pip.
  2. Descargue el archivo .zip sqlmlutils más reciente desde https://github.com/microsoft/sqlmlutils/tree/master/R/dist en el equipo cliente. No descomprima el archivo.
  3. Abra un símbolo del sistema y ejecute el siguiente comando para instalar el paquete sqlmlutils. Sustituya la ruta de acceso completa del archivo .zip sqlmlutils que ha descargado. En este ejemplo, se da por supuesto que el archivo descargado es c:\temp\sqlmlutils-1.0.0.zip.
    pip install --upgrade --upgrade-strategy only-if-needed c:\temp\sqlmlutils-1.0.0.zip
    

Adición de un paquete de Python en SQL Server

Mediante sqlmlutils, puede instalar paquetes de Python en una instancia de SQL. Después, puede usar esos paquetes en el código de Python que se ejecuta en la instancia de SQL. sqlmlutils usa CREATE EXTERNAL LIBRARY para instalar el paquete y cada una de sus dependencias.

En el ejemplo siguiente, agregará el paquete text-tools en SQL Server.

Adición del paquete en línea

Si el equipo cliente que usa para conectarse a SQL Server tiene acceso a Internet, puede usar sqlmlutils para buscar el paquete text-tools y las dependencias a través de Internet y, después, instalar el paquete en una instancia de SQL Server de forma remota.

  1. En el equipo cliente, abra Python o un entorno de Python.

  2. Use los comandos siguientes para instalar el paquete text-tools. Sustituya la información propia de conexión de base de datos de SQL Server (si usa la autenticación de Windows, no necesita los parámetros uid y pwd).

  1. En el equipo cliente, abra Python o un entorno de Python.

  2. Use los comandos siguientes para instalar el paquete text-tools. Sustituya la información de conexión de base de datos de SQL Server propia.

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="server", database="database", uid="username", pwd="password")
sqlmlutils.SQLPackageManager(connection).install("text-tools")

Adición del paquete sin conexión

Si el equipo cliente que usa para conectarse a SQL Server no tiene conexión a Internet, puede usar PIP en un equipo con acceso a Internet para descargar el paquete y los paquetes dependientes en una carpeta local. Después, copie la carpeta en el equipo cliente en el que puede instalar el paquete sin conexión.

En un equipo con acceso a Internet

  1. Abra un símbolo del sistema y ejecute el comando siguiente para crear una carpeta local que contenga el paquete text-tools. En este ejemplo, se crea la carpeta c:\temp\text-tools.

    pip download text-tools -d c:\temp\text-tools
    
  2. Copie la carpeta text-tools en el equipo cliente. En el ejemplo siguiente se da por supuesto que lo ha copiado en c:\temp\packages\text-tools.

En el equipo cliente

Use sqlmlutils para instalar cada paquete (archivo .whl) que encuentre en la carpeta local que ha creado PIP. No importa en qué orden instale los paquetes.

En este ejemplo, text-tools no tiene dependencias, por lo que solo se va a instalar un archivo de la carpeta text-tools. Por el contrario, un paquete como scikit-plot tiene 11 dependencias, por lo que encontrará 12 archivos en la carpeta (el paquete scikit-plot y los 11 paquetes dependientes) y debe instalar cada uno de ellos.

Ejecute el siguiente script de Python. Sustituya la ruta de acceso de archivo y el nombre reales del paquete, así como la información propia de conexión de base de datos de SQL Server (si usa la autenticación de Windows, no necesita los parámetros uid y pwd). Repita la instrucción sqlmlutils.SQLPackageManager para cada archivo de paquete de la carpeta.

Ejecute el siguiente script de Python. Sustituya la ruta de acceso de archivo y el nombre reales del paquete, así como la información propia de conexión de base de datos de SQL Server. Repita la instrucción sqlmlutils.SQLPackageManager para cada archivo de paquete de la carpeta.

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="yourserver", database="yourdatabase", uid="username", pwd="password"))
sqlmlutils.SQLPackageManager(connection).install("text_tools-1.0.0-py3-none-any.whl")

Uso del paquete

Ahora puede usar el paquete en un script de Python en SQL Server. Por ejemplo:

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
from text_tools.finders import find_best_string
corpus = "Lorem Ipsum text"
query = "Ipsum"
first_match = find_best_string(query, corpus)
print(first_match)
  '

Eliminación de un paquete de SQL Server

Si quiere quitar el paquete text-tools, use el siguiente comando de Python en el equipo cliente, con la misma variable de conexión que definió anteriormente.

sqlmlutils.SQLPackageManager(connection).uninstall("text-tools")

Más funciones de sqlmlutils

El paquete sqlmlutils contiene una serie de funciones para administrar paquetes de Python, así como para crear, administrar y ejecutar consultas y procedimientos almacenados en SQL Server. Para obtener más información, vea el archivo Léame de sqlmlutils para Python.

Para obtener información sobre cualquier función de sqlmlutils, use la función help de Python. Por ejemplo:

import sqlmlutils
help(SQLPackageManager.install)

Pasos siguientes