Gestire gli ambienti di base serverless

Importante

Questa funzionalità è in Anteprima Pubblica.

Questa pagina illustra come creare e gestire ambienti di base serverless in un'area di lavoro.

Permissions

• Solo gli amministratori dell'area di lavoro possono creare e gestire gli ambienti di base di un'area di lavoro.
• Tutti gli utenti dell'area di lavoro hanno accesso agli ambienti di base di un'area di lavoro.
• Tutti gli utenti dell'area di lavoro possono creare specifiche di ambiente serverless personalizzate.

Funzionamento degli ambienti di base in Azure Databricks

In Azure Databricks un ambiente di base è una specifica YAML condivisibile che definisce una versione dell'ambiente serverless e un set di dipendenze Python aggiuntive per notebook serverless. Gli amministratori dell'area di lavoro creano e gestiscono ambienti di base in modo che gli utenti possano iniziare rapidamente da un ambiente coerente e memorizzato nella cache e, facoltativamente, aggiungere le proprie librerie.

Creare ed esportare una specifica di ambiente

Il modo più semplice per creare una specifica YAML valida consiste nel compilare l'ambiente nel pannello laterale Ambiente e quindi usare il pulsante Esporta ambiente per scaricare il file YAML.

1. Aprire un notebook e connettersi al calcolo serverless.
2. Fare clic Nel pannello laterale del notebook.
3. Selezionare la versione dell'ambiente. Databricks consiglia di usare la versione più recente dell'ambiente serverless supportata dall'area di lavoro.
4. Nel campo Dipendenze aggiungere le dipendenze desiderate per l'ambiente di base. Fare clic su Aggiungi dipendenza dopo aver immesso ogni dipendenza. Per altre istruzioni sull'aggiunta di dipendenze, vedere Aggiungere dipendenze al notebook.
5. Fare clic su Applica nella parte inferiore del pannello dell'ambiente per verificare che la specifica sia valida.
6. Fare clic Nella parte inferiore del pannello dell'ambiente fare clic su Esporta ambiente.
7. Assegnare un nome al file YAML e aggiungerlo a una cartella workspace o a un volume del catalogo Unity.

Specifica dell'ambiente di esempio

L'esempio YAML seguente si basa sulla specifica dell'ambiente dei progetti MLflow. Definisce un ambiente di base con alcune dipendenze della libreria:

environment_version: '4'
dependencies:
  - --index-url https://pypi.org/simple
  - -r "/Workspace/Shared/requirements.txt"
  - my-library==6.1
  - /Workspace/Shared/Path/To/simplejson-3.19.3-py3-none-any.whl
  - git+https://github.com/databricks/databricks-cli

Aggiungere un ambiente di base all'area di lavoro

Per aggiungere la specifica dell'ambiente come ambiente di base all'area di lavoro:

1. Nell'area di lavoro passare a Impostazioni.
2. In Amministratore dell'area di lavoroselezionare Calcolo.
3. Accanto a Ambienti di base per il calcolo serverless fare clic su Gestisci.
4. Fare clic su Crea nuovo ambiente.
5. Assegnare un nome all'ambiente di base. Si tratta del nome visualizzato dagli utenti nel menu a discesa Ambiente di base .
6. Selezionare il file YAML di specifica dell'ambiente usando la selezione file. È possibile esplorare i file dell'area di lavoro o i volumi del catalogo Unity.
7. Clicca su Crea.

L'ambiente di base inizierà a creare. Controllare la colonna Stato nell'elenco degli ambienti di base. Verrà modificato in Pronto per l'uso quando è pronto.

Annotazioni

I record di utilizzo associati alla compilazione e all'aggiornamento degli ambienti di base hanno la colonna billing_origin_product impostata su BASE_ENVIRONMENTS. Inoltre, l'ID specifico dell'ambiente di base viene popolato nella colonna usage_metadata.base_environment_id.

Impostare l'ambiente di base predefinito dell'area di lavoro

Per impostazione predefinita, i notebook serverless in un'area di lavoro non usano un ambiente di base. Gli amministratori dell'area di lavoro possono selezionare un ambiente di base da applicare a tutti i nuovi notebook per impostazione predefinita.

1. Nell'area di lavoro passare a Impostazioni.
2. In Amministratore dell'area di lavoroselezionare Calcolo.
3. Accanto a Ambienti di base per il calcolo serverless fare clic su Gestisci.
4. Fare clic sull'icona a forma di stella accanto all'ambiente di base per impostarla come predefinita.

Tutti i nuovi notebook serverless verranno ora predefinito per l'ambiente di base selezionato.

Aggiornare un ambiente di base

È possibile modificare il file di ambiente di base per aggiornare i numeri di versione o aggiungere o rimuovere dipendenze.

Nell'elenco degli ambienti di base fare clic sul percorso del file YAML dell'ambiente di base da aggiornare. Verrà aperto il file in una nuova scheda. È possibile esaminare o aggiornare il contenuto del file. Le modifiche vengono salvate automaticamente.

Dopo aver eseguito un aggiornamento alla specifica YAML, è necessario aggiornare l'ambiente di base in modo che i notebook e i processi rilevino la configurazione più recente.

1. Accanto all'ambiente di base che si desidera aggiornare, fare clic quindi selezionare Aggiorna.
2. Cliccare Conferma.

Le nuove sessioni ora usano l'ambiente di base aggiornato. Per ottenere gli aggiornamenti, è necessario riavviare le sessioni del notebook esistenti.

Limitazioni

• Per i processi, solo le attività del notebook possono usare ambienti di base.
• L'ambiente serverless versione 1 non è supportato. Usare la versione 2 o successiva.
• Gli ambienti di base sono disponibili per tutti gli utenti dell'area di lavoro.
• Le aree di lavoro sono limitate a 10 ambienti di base.