Compartir a través de

Administración de extensiones de lenguaje en el clúster de Azure Data Explorer

  • Artículo

La característica de extensiones de lenguaje permite usar complementos de extensión de lenguaje para integrar otros idiomas en las consultas KQL de Azure Explorador de datos. El entorno de ejecución del complemento se hospeda en un espacio aislado, un entorno aislado y seguro, que se ejecuta en los nodos del clúster. En este artículo, administrará el complemento de extensiones de lenguaje en el clúster de Azure Data Explorer con Azure Portal.

Requisitos previos

Habilitación de las extensiones de lenguaje en el clúster

Siga estos pasos a fin de habilitar una extensión de lenguaje en el clúster:

  1. En Azure Portal, vaya al clúster de Azure Data Explorer.

  2. Haga clic en Configuración.

  3. En Configuraciones, busque la extensión de lenguaje que quiere usar y, después, seleccione Activar.

    Recorte de pantalla de la página de configuración del clúster de Azure Data Explorer, en la que se muestran las opciones de habilitación de la extensión de lenguaje.

  4. En Python, seleccione la imagen deseada en la lista. La imagen puede ser administrada o una imagen personalizada.

  5. Seleccione Guardar.

Nota:

La habilitación de la extensión de lenguaje puede tardar hasta 60 minutos. El proceso no afecta a la disponibilidad del clúster.

Cambio de la imagen de extensiones de lenguaje Python en el clúster

Siga estos pasos para editar la imagen de la extensión de lenguaje Python en el clúster:

  1. En Azure Portal, vaya al clúster de Azure Data Explorer.
  2. Haga clic en Configuración.
  3. En Configuraciones, seleccione la imagen de Python deseada en la lista.
  4. Seleccione Guardar.

Nota:

El proceso de actualización de la imagen puede tardar hasta 60 minutos. El proceso no afecta a la disponibilidad del clúster.

Crear una imagen personalizada

  1. En Azure Portal, vaya al clúster de Azure Data Explorer.

  2. Haga clic en Configuración.

  3. En Configuraciones, seleccione + Agregar imagen personalizada (versión preliminar)

  4. En el panel que se abre, proporcione la siguiente información:

    • Nombre de imagen personalizada: nombre de la imagen personalizada.
    • Iniciar desde: elija el motor de Python o la imagen existente.
      • Motor de Python:
        1. Escriba un número de versión de Python válido.
        2. Agregue un archivo de requisitos.
      • Imagen existente:
        1. Seleccione una imagen existente en la lista desplegable.
        2. Agregue un archivo de requisitos.

  5. Seleccione Aceptar.

    Captura de pantalla de la página de configuración del clúster de Azure Data Explorer, en la que se muestra el panel de creación de imágenes personalizada.

Nota:

Mientras el clúster actualiza la nueva imagen, no se pueden realizar cambios adicionales en el clúster.

Una vez creada la imagen, puede editarla o eliminarla.

Archivo de requisitos

Los archivos de requisitos admitidos están en el formato de pip requirements.txt y pueden incluir cualquier paquete de Python. Cada línea contiene el nombre de un paquete, seguido opcionalmente del número de paquete. Por ejemplo:

annotated-types==0.6.0
anytree
arrow==1.3.0
attrs==23.2.0

Deshabilitación de las extensiones de lenguaje en el clúster

Nota:

El proceso de deshabilitación de la imagen puede tardar hasta 30 minutos. El proceso no afecta a la disponibilidad del clúster.

Para deshabilitar las extensiones de lenguaje en el clúster, haga lo siguiente:

  1. En Azure Portal, vaya al clúster de Azure Data Explorer.
  2. En Configuración, seleccione Configuraciones.
  3. En el panel Configuraciones, seleccione Desactivado para deshabilitar una extensión de lenguaje.
  4. Seleccione Guardar.

Limitaciones

  • El espacio aislado en tiempo de ejecución de las extensiones de lenguaje asigna espacio en disco, aunque no se ejecute ninguna consulta en el ámbito del lenguaje pertinente. Consulte los espacios aislados para más información sobre las limitaciones.

Contenido relacionado