Git-map Serverless

Important

Deze functie bevindt zich in de bètaversie.

Git Folder Serverless biedt één serverless compute-resource die gedeeld wordt over assets in een Git-map, inclusief notitieboeken en bestanden. Gebruik Git Folder Serverless voor multifile authoring zonder een nieuwe serverless computeresource te starten of een omgeving op te zetten voor elk notitieboek of bestand. De omgeving wordt beheerd door een pyproject.toml bestand in de Git-map root.

Requirements

Gebruik van Git Folder Serverless:

  • Je project moet in een Git-map staan.
  • Je moet de Git-map openen in de Git-mappeneditor.
  • Als de Git-map een pyproject.toml-bestand in de hoofdmap bevat, moet de environment_version zijn ingesteld op 5 of hoger.

Gedeelde rekenkracht en omgeving

  • Notebooks en bestanden in dezelfde Git-map zijn gekoppeld aan één serverloze rekenresource voor Git-mappen en gebruiken de omgeving die wordt beheerd door pyproject.toml.
  • Alleen assets in de bijbehorende Git-map kunnen aan de rekenresource worden gekoppeld.
  • Python-variabelen die in het ene notebook zijn gedefinieerd, zijn niet beschikbaar in een ander notebook.
  • Een webterminal die wordt geopend vanuit elk bijgevoegd notitieboek of bestand in de Git-map, draait op dezelfde rekenbron.

Gebruik Git Folder Serverless in de Git-mappeneditor

  1. Klik in de zijbalk van de werkruimte op Werkruimte en ga naar de Git-map.

  2. Klik op Openen in de editor.

  3. Open een notitieboekje of bestand in de Git-map.

  4. Klik op het vervolgkeuzemenu Compute.

  5. Selecteer Git Folder Serverless.

    Compute-vervolgkeuzemenu waarbij Git Folder Serverless is geselecteerd met omgevingsversie 5

  6. Start het notitieboek of bestand om de rekenbron te starten.

Om dezelfde compute vanuit een ander asset te gebruiken, open je een andere notebook of bestand in dezelfde Git-folder en selecteer Git Folder Serverless. De resources delen de rekenkracht en de omgeving die door pyproject.toml wordt beheerd.

Beheer de omgeving met pyproject.toml

Git Folder Serverless beheert Python-afhankelijkheden voor de hele Git-map met een pyproject.toml bestand in de wortel van de map. Dit verschilt van standaard serverless notebooks, waarbij afhankelijkheden die in het Environment-zijpaneel zijn geconfigureerd op één notebook worden toegepast.

Je kunt afhankelijkheden toevoegen en omgevingswijzigingen toepassen met notebook-commando's of door te bewerken pyproject.toml.

Gebruik notebookopdrachten

  1. Open een notitieboek dat aan Git Folder is gekoppeld Serverless.

  2. Controleer of er een pyproject.toml bestand in de wortel van de Git-map staat. Als het niet bestaat, open dan het zijpaneel Omgeving en klik op Create pyproject.toml.

  3. Voer %uv add <package> uit om een afhankelijkheid toe te voegen aan het rootbestand pyproject.toml . Voorbeeld:

    %uv add cowsay
    
  4. Voer %uv sync uit om de afhankelijkheden toe te passen op de gedeelde omgeving en genereer of update uv.lock.

    %uv sync
    

Bewerken pyproject.toml

  1. Controleer in de Git-mapeditor of er een pyproject.toml bestand bestaat aan de wortel van de Git-map. Als het niet bestaat, open dan het zijpaneel Omgeving en klik op Create pyproject.toml.

  2. Open het pyproject.toml bestand.

  3. Bewerk de dependencies lijst handmatig. Voorbeeld:

    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]
    
    [tool.databricks.environment]
    environment_version = "5"
    
  4. Klik bovenaan de pyproject.toml bestandseditor op Apply om de omgevingswijzigingen toe te passen op Git Folder Serverless.

De bijgewerkte omgeving is beschikbaar voor notebooks en bestanden die aan dezelfde Git Folder Serverless compute zijn gekoppeld. Om de omgeving te inspecteren, open je het Environment-zijpaneel . Zie Configureer de serverloze omgeving voor informatie over serverloze omgevingsversies en geïnstalleerde afhankelijkheden.

Samenwerken via Git

Alleen de gebruiker die een serverloze rekenresource voor een Git Folder start, kan er workloads op uitvoeren. Als een andere gebruiker dezelfde Git-map opent, wordt hij geblokkeerd om notitieboeken of bestanden op de bestaande rekenbron te draaien.

Databricks raadt aan dat elke samenwerkingspartner de repository kloont naar een Git-map in hun persoonlijke workspace-map. Elke bijdrager krijgt vervolgens een aparte computerresource en omgeving voor zijn of haar kloon, beheerd door pyproject.toml.

Gebruik branches, commits, pushes en pulls om wijzigingen uit te wisselen via de externe Git-repository. Zie Samenwerken in Git-mappen.

Limitations

  • Het delen van rekenresources valt binnen het bereik van een serverless-gebruiksbeleid. Notitieboeken en bestanden in dezelfde Git-map die verschillende gebruiksbeleid gebruiken, krijgen aparte computeresources toegewezen in plaats van één te delen.

Aanvullende bronnen