Gedeelde Serverless voor Git-mappen

Important

Deze functie bevindt zich in de bètaversie.

Shared Serverless for Git Folders biedt één serverless compute-resource die gedeeld wordt tussen assets in een Git-map, inclusief notitieboeken en bestanden. Gebruik Shared Serverless voor Git-mappen voor multi-file authoring zonder een nieuwe serverless compute resource 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

Om Shared Serverless te gebruiken voor Git-mappen:

  • 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

  • Notitieboeken en bestanden in dezelfde Git-map koppelen zich aan één gedeelde rekenbron 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 Shared Serverless voor Git-mappen 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 Shared Serverless for Git Folders.

    dropdownoptie voor Compute voor gedeelde serverless compute, met een Beta-badge en een omgeving van pyproject.toml

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

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

Beheer de omgeving met pyproject.toml

Shared Serverless for Git Folders 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 is gekoppeld aan Shared Serverless voor Git-mappen.

  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. Bovenaan de pyproject.toml bestandseditor klik je op Apply om de omgevingswijzigingen toe te passen op Shared Serverless for Git Folders.

De bijgewerkte omgeving is beschikbaar voor notitieboeken en bestanden die aan dezelfde gedeelde rekenbron 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 de gedeelde rekenbron 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