Serverless condiviso per le cartelle Git

Importante

Questa funzionalità è in versione beta.

Shared Serverless per le cartelle Git fornisce una singola risorsa di calcolo serverless condivisa tra asset in una cartella Git, inclusi notebook e file. Usa Shared Serverless per le cartelle Git per l'authoring multi-file senza avviare una nuova risorsa di calcolo serverless o configurare un ambiente per ogni notebook o file. L'ambiente è gestito da un pyproject.toml file nella radice della cartella Git.

Requisiti

Per usare Shared Serverless per le cartelle Git:

  • Il tuo progetto deve essere in una cartella Git.
  • Devi aprire la cartella Git nell'editor di cartelle Git.
  • Se la cartella Git contiene un file root pyproject.toml, il environment_version deve essere impostato su 5 o versione successiva.

Calcolo condiviso e ambiente

  • I notebook e i file nella stessa cartella Git si collegano a una risorsa di calcolo condivisa e utilizzano l'ambiente gestito da pyproject.toml.
  • Solo gli asset all'interno della cartella Git associata possono essere associati alla risorsa di calcolo.
  • Le variabili Python definite in un notebook non sono disponibili in un altro notebook.
  • Un terminale web aperto da qualsiasi notebook o file allegato nella cartella Git funziona sulla stessa risorsa di calcolo.

Usa Serverless condiviso per le cartelle Git nell'editor di cartelle Git

  1. Nella barra laterale dello spazio di lavoro, clicca Workspace e naviga nella cartella Git.

  2. Clicca Apri nell'editor.

  3. Apri un notebook o un file nella cartella Git.

  4. Clicca sul menu a discesa Calcolo.

  5. Seleziona Shared Serverless for Git Folders.

    Opzione a tendina per compute serverless condiviso, con badge Beta e un ambiente da pyproject.toml

  6. Esegui il notebook o il file per avviare la risorsa di calcolo.

Per usare lo stesso compute da un altro asset, apri un altro notebook o file nella stessa cartella Git e seleziona Serverless condiviso per le cartelle Git. Gli asset condividono il calcolo e l'ambiente gestito da pyproject.toml.

Gestisci l'ambiente con pyproject.toml

Shared Serverless per Git Folder gestisce le dipendenze Python per l'intera cartella Git con un pyproject.toml file alla radice della cartella. Questo differisce dai notebook serverless standard, dove le dipendenze configurate nel pannello laterale Ambiente si applicano a un solo notebook.

Puoi aggiungere dipendenze e applicare modifiche ambientali con comandi del notebook o modificando pyproject.toml.

Usa i comandi del notebook

  1. Apri un notebook associato a Shared Serverless for Git Folders.

  2. Controlla se un pyproject.toml file esiste alla radice della cartella Git. Se non esiste, apri il pannello laterale Ambiente e fai clic su Crea pyproject.toml.

  3. Esegui %uv add <package> per aggiungere una dipendenza al file root pyproject.toml . Per esempio:

    %uv add cowsay

  4. Esegui %uv sync per applicare le dipendenze all'ambiente condiviso e generare o aggiornare uv.lock.

    %uv sync

Modifica pyproject.toml

  1. Nell'editor di cartelle Git, verifica se un pyproject.toml file esiste alla radice della cartella Git. Se non esiste, apri il pannello laterale Ambiente e clicca su Crea pyproject.toml.

  2. Aprire il pyproject.toml file.

  3. Modifica manualmente la dependencies lista. Per esempio:

    [project]
name = "my-project"
version = "0.1.0"
dependencies = [
  "simplejson==3.18.1",
]

[tool.databricks.environment]
environment_version = "5"

  4. In cima nell'editor di file pyproject.toml, clicca su Applica per applicare le modifiche all'ambiente a Shared Serverless for Git Folders.

L'ambiente aggiornato è disponibile per notebook e file collegati alla stessa risorsa di calcolo condivisa. Per ispezionare l'ambiente, apri il pannello laterale Ambiente . Vedi Configura l'ambiente serverless per informazioni sulle versioni dell'ambiente serverless e sulle dipendenze installate.

Collabora tramite Git

Solo l'utente che avvia la risorsa di calcolo condivisa può eseguire carichi di lavoro su di essa. Se un altro utente apre la stessa cartella Git, non può eseguire notebook o file sulla risorsa di calcolo esistente.

Databricks raccomanda che ogni collaboratore cloni il repository in una cartella Git nella propria cartella personale dello spazio di lavoro. Ogni collaboratore riceve quindi una risorsa di calcolo e un ambiente separati gestiti da pyproject.toml per il proprio clone.

Usa branch, commit, push e pull per scambiare modifiche tramite il repository Git remoto. Vedi "Collaborare nelle cartelle Git".

Limitations

  • La condivisione di calcolo è regolata da una politica di utilizzo serverless. Notebook e file nella stessa cartella Git che utilizzano politiche d'uso diverse vengono assegnate risorse di calcolo separate invece di condividerne una.

Risorse aggiuntive

  • Ultimo aggiornamento: