Condividi tramite

Gestire le estensioni del linguaggio nel cluster di Azure Esplora dati

  • Articolo

La funzionalità delle estensioni del linguaggio consente di usare plug-in di estensione del linguaggio per integrare altri linguaggi nelle query di Azure Esplora dati KQL. Il runtime del plug-in è ospitato in una sandbox, un ambiente isolato e sicuro, in esecuzione nei nodi del cluster. In questo articolo viene gestito il plug-in delle estensioni del linguaggio nel cluster di Azure Esplora dati all'interno del portale di Azure.

Prerequisiti

Abilitare le estensioni del linguaggio nel cluster

Per abilitare un'estensione del linguaggio nel cluster, seguire questa procedura:

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure.

  2. Seleziona Impostazioni.

  3. In Configurazioni individuare l'estensione del linguaggio che si vuole usare e quindi selezionare Sì.

    Screenshot della pagina di configurazione del cluster Esplora dati di Azure che mostra le opzioni di abilitazione dell'estensione del linguaggio.

  4. Per Python selezionare l'immagine desiderata dall'elenco. L'immagine può essere gestita o un'immagine personalizzata.

  5. Seleziona Salva.

Nota

L'abilitazione dell'estensione del linguaggio può richiedere fino a 60 minuti. Il processo non influisce sulla disponibilità del cluster.

Modificare l'immagine delle estensioni del linguaggio Python nel cluster

Per modificare l'immagine dell'estensione del linguaggio Python nel cluster, seguire questa procedura:

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure.
  2. Seleziona Impostazioni.
  3. In Configurazioni selezionare l'immagine Python desiderata nell'elenco.
  4. Seleziona Salva.

Nota

L'aggiornamento del processo di immagine può richiedere fino a 60 minuti. Il processo non influisce sulla disponibilità del cluster.

Creare un'immagine personalizzata

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure.

  2. Seleziona Impostazioni.

  3. In Configurazioni selezionare + Aggiungi immagine personalizzata (anteprima)

  4. Nel riquadro visualizzato specificare le informazioni seguenti:

    • Nome immagine personalizzata: nome dell'immagine personalizzata.
    • Iniziare da: scegliere il motore Python o l'immagine esistente.
      • Motore Python:
        1. Immettere un numero di versione Python valido.
        2. Aggiungere un file dei requisiti.
      • Immagine esistente:
        1. Selezionare un'immagine esistente dall'elenco a discesa.
        2. Aggiungere un file dei requisiti.

  5. Selezionare OK.

    Screenshot della pagina di configurazione del cluster Esplora dati di Azure, che mostra il riquadro di creazione dell'immagine personalizzata.

Nota

Mentre il cluster aggiorna la nuova immagine, non è possibile apportare ulteriori modifiche al cluster.

Dopo aver creato l'immagine, è possibile modificarla o eliminarla.

File dei requisiti

I file di requisiti supportati sono nel formato pip requirements.txt e possono includere qualsiasi pacchetto Python. Ogni riga contiene il nome di un pacchetto, seguito facoltativamente dal numero del pacchetto. Ad esempio:

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

Disabilitare le estensioni del linguaggio nel cluster

Nota

La disabilitazione del processo di immagine può richiedere fino a 30 minuti. Il processo non influisce sulla disponibilità del cluster.

Per disabilitare le estensioni del linguaggio nel cluster, seguire questa procedura:

  1. Nel portale di Azure passare a cluster di Esplora dati di Azure.
  2. In Impostazioniselezionare Configurazioni.
  3. Nel riquadro Configurazioni selezionare No per disabilitare un'estensione del linguaggio.
  4. Seleziona Salva.

Limiti

  • La sandbox di runtime delle estensioni del linguaggio alloca spazio su disco anche se non viene eseguita alcuna query nell'ambito del linguaggio pertinente. Per limitazioni più dettagliate, vedere Sandbox.

Contenuto correlato