Gebruik Shared Serverless voor Git-mappen en bundels

Important

Deze functie bevindt zich in de bètaversie. Om het te gebruiken, moet een workspace-beheerder Project-Scoped Gedeelde Compute inschakelen via de Previews-pagina. Zie Azure Databricks previews beheren.

Met Shared Serverless delen notebooks en bestanden in dezelfde Git-map of bundel serverless compute en een Python-omgeving in de editor. Om de omgeving aan te passen, voeg je een pyproject.toml bestand toe aan de mapwortel. Om een notebook of bestand toe te voegen, volg je de stappen voor Git-mappen of Declarative Automation Bundles.

Requirements

Gedeelde rekenkracht en omgeving

  • Notitieboeken en bestanden in dezelfde Git-map of bundel delen compute en een Python-omgeving in de editor. Een optioneel pyproject.toml bestand in de mapwortel definieert de gedeelde omgeving.
  • Alleen notebooks en bestanden in de bijbehorende Git-map of bundel kunnen worden gekoppeld aan de gedeelde rekenresource.
  • Gedeelde rekenbronnen worden per gebruiker geïsoleerd. Alleen de gebruiker die als eerste een notebook of bestand aan een gedeelde rekenresource koppelt, kan er workloads op uitvoeren.
  • De uitvoering van het notebook blijft geïsoleerd. Python-variabelen die in het ene notebook zijn gedefinieerd, zijn niet beschikbaar in een ander notebook.
  • Een webterminal die wordt geopend vanuit een bijgevoegd notitieboek of bestand, draait op dezelfde rekenbron.

Gebruik Shared Serverless in Git-mappen

Gebruik Shared Serverless om met notitieboekjes en bestanden in een Git-map te werken.

Voeg notebooks en bestanden toe in de Git-mapeditor

  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.

    Compute-dropdownoptie 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 compute in een ander notitieboek of bestand te gebruiken, open je dit in dezelfde Git-map en selecteer Shared Serverless.

Samenwerken via Git

Databricks raadt aan dat elke samenwerkingspartner de repository kloont naar een Git-map in hun persoonlijke workspace-map. Elke gebruiker krijgt vervolgens een aparte rekenresource en omgeving voor zijn of haar kloon.

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

Gebruik Shared Serverless in bundels

Gebruik Shared Serverless om met notitieboeken en bestanden in een bundel in de werkruimte te werken. De bundelwortel bevat databricks.yml en kan een pyproject.toml bestand bevatten dat de gedeelde omgeving definieert.

Voeg notebooks en bestanden toe in de bundeleditor

  1. Klik in de zijbalk van de werkruimte op Werkruimte en navigeer naar de bundel.
  2. Rechts van de bundelnaam klik je op Openen in de editor.
  3. Open een notebook of bestand in de bundel.
  4. Klik op het vervolgkeuzemenu Compute.
  5. Selecteer Shared Serverless.
  6. Start het notitieboek of bestand om de rekenbron te starten.

Om dezelfde compute uit een ander notitieboek of bestand te gebruiken, open je deze in dezelfde bundel en selecteer Shared Serverless.

Om via Git samen te werken, laat elke samenwerkingspartner de repository kloonen naar een Git-map in hun persoonlijke workspace-map. Zie Samenwerken via Git.

Beheer de omgeving met pyproject.toml

Shared Serverless gebruikt het file pyproject.toml op het niveau van de hoofdmap van de Git-map of bundle om Python-afhankelijkheden voor het project te beheren. Standaard serverless notebooks gebruiken afhankelijkheden die voor elk notebook zijn geconfigureerd in het Environment-zijpaneel .

Maak het rootbestand pyproject.toml aan en stel de serverloze omgevingsversie in voordat je de afhankelijkheden beheert. Zie Maken en bewerkenpyproject.toml. Je kunt dan afhankelijkheden toevoegen met notebook-commando's of het bestand direct bewerken.

Gebruik notebookopdrachten

  1. Open een notitieboek dat gekoppeld is aan Shared Serverless.

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

    %uv add cowsay
    

Het commando werkt uv.lock, pyproject.toml en de gedeelde omgeving bij. Je hoeft %uv add niet na %uv sync uit te voeren. Gebruik %uv sync om wijzigingen die direct in pyproject.toml zijn aangebracht toe te passen.

Maak en bewerk pyproject.toml

  1. Open een notitieboek dat gekoppeld is aan Shared Serverless.

  2. Open het Environment-zijpaneel.

  3. Klik op de kaart 'Managed by pyproject.toml' op File new icon.pyproject.toml maken om het wortelbestand aan te maken. Als het bestand al bestaat, klik dan op het pictogram Nieuw venster.Bekijk pyproject.toml. Het bestand opent in de editor.

    Omgevingszijpaneel met het pictogram Aanmaken van pyproject.toml en tooltip naast Beheerd door pyproject.toml.

  4. Bewerk de dependencies lijst. Behoud het gegenereerde [tool.databricks.environment] gedeelte, of voeg het toe als het ontbreekt. Stel environment_version in op een ondersteunde versie (5 en hoger). Voorbeeld:

    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]
    
    [tool.databricks.environment]
    environment_version = "5"
    
  5. Klik bovenaan de bestandseditor op pyproject.toml.

    De pyproject.toml bestandseditor toont de knop Toepassen en de tooltip daarvan.

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.

Een notebook plannen

Wanneer je een notebook inplant dat is gekoppeld aan Shared Serverless vanuit de Git-map of bundle editor, gebruikt Azure Databricks het pyproject.toml-bestand in de hoofdmap als projectomgeving van de taak als het bestand bestaat. Rol de bundel uit zoals beschreven in de volgende stappen.

  1. Open in de Git-map of bundle-editor een notebook dat is gekoppeld aan Shared Serverless.
  2. Als de Git-map of bundel een root pyproject.toml-bestand heeft, controleer dan of deze de afhankelijkheden declareert die door de taak nodig zijn.
  3. Klik op Schema.
  4. Selecteer in de dropdownlijst Compute serverless compute.
  5. Stel het schema in en klik op Aanmaken.

Nadat je op Aanmaken hebt geklikt, controleer je de taakconfiguratie:

Zie Geplande notebooktaken maken en beheren voor opties voor de planning van notebooks.

Limitations

  • Het delen van rekenresources valt binnen het bereik van een serverless-gebruiksbeleid. notebooks en bestanden in dezelfde Git-map of bundel waarvoor verschillend gebruiksbeleid geldt, krijgen aparte rekenresources toegewezen in plaats van één te delen.

Aanvullende bronnen