Delen via

Levenscyclus van modellen beheren met behulp van het werkruimtemodelregister (verouderd)

  • Artikel

Belangrijk

In deze documentatie wordt het register van het werkruimtemodel behandeld. Als uw werkruimte is ingeschakeld voor Unity Catalog, gebruikt u de procedures op deze pagina niet. Zie in plaats daarvan Modellen in Unity Catalog.

Zie Catalogvoor hulp bij het upgraden van het werkruimtemodelregister naar Unity Catalog.

Als de standaard-catalog van uw werkruimte zich in Unity Catalog bevindt (in plaats van hive_metastore) en u een cluster uitvoert met Databricks Runtime 13.3 LTS of hoger, worden modellen automatisch gemaakt en geladen vanuit de standaard catalogvan de werkruimte, zonder dat er een configuratie is vereist. Als u in dit geval het register voor het werkruimtemodel wilt gebruiken, moet u dit expliciet toepassen door deze aan het begin van uw workload uit te voeren import mlflow; mlflow.set_registry_uri("databricks") . Een klein aantal werkruimten where waarbij zowel de standaard-catalog als een catalog in Unity Catalog vóór januari 2024 is geconfigureerd en waarbij het werkruimtemodelregister vóór januari 2024 werd gebruikt, zijn vrijgesteld van dit gedrag en blijven het werkruimtemodelregister standaard gebruiken.

In dit artikel wordt beschreven hoe u het werkruimtemodelregister gebruikt als onderdeel van uw machine learning-werkstroom om de volledige levenscyclus van ML-modellen te beheren. Het werkruimtemodelregister is een door Databricks geleverde, gehoste versie van het MLflow-modelregister.

Het werkruimtemodelregister biedt:

  • Chronologische modelherkomst (welk MLflow-experiment en uitvoering het model op een bepaald moment heeft geproduceerd).
  • Model serveren.
  • Modelversiebeheer.
  • Faseovergangen (bijvoorbeeld van fasering naar productie of gearchiveerd).
  • Webhooks zodat u automatisch acties kunt activeren op basis van register gebeurtenissen.
  • E-mailmeldingen van model gebeurtenissen.

U kunt ook modelbeschrijvingen maken en weergeven en opmerkingen achterlaten.

Dit artikel bevat instructies voor zowel de gebruikersinterface van het werkruimtemodelregister als de api voor het register van het werkruimtemodel.

Voor een overzicht van de concepten van het werkruimtemodelregister, zie MLflow voor gen AI-agent en ML-modellevenscyclus.

Een model maken of registreren

U kunt een model maken of registreren met behulp van de gebruikersinterface of een model registreren met behulp van de API.

Een model maken of registreren met behulp van de gebruikersinterface

Er zijn twee manieren om een model te registreren in het werkruimtemodelregister. U kunt een bestaand model registreren dat is vastgelegd in MLflow of u kunt een nieuw, leeg model maken en registreren, en vervolgens een eerder vastgelegd model aan de sjabloon toewijzen.

Een bestaand geregistreerd model registreren vanuit een notebook

  1. Zoek in de werkruimte de MLflow-uitvoering op die het model bevat dat u wilt registreren.

    1. Klik op het Experiment iconpictogram Experiment in de rechterzijbalk van het notitieblok.

      Notebook-werkbalk

    2. Klik in de zijbalk Experimentuitvoeringen op het Externe koppeling pictogram naast de datum van de uitvoering. De pagina MLflow Run wordt weergegeven. Op deze pagina ziet u details van de uitvoering, waaronder parameters, metrische gegevens, tags en list van artefacten.

  2. Klik in de sectie Artefacten op de map met de naam xxx-model.

    Model registreren

  3. Klik helemaal rechts op de knop Model registreren.

  4. Klik in het dialoogvenster in het vak Model en voer een van de volgende handelingen uit:

    • Select Maak nieuw model aan via de vervolgkeuzelijst. Het veld Modelnaam wordt weergegeven. Voer bijvoorbeeld scikit-learn-power-forecastingeen modelnaam in.
    • Select een bestaand model in de vervolgkeuzelijst.

    Nieuw model maken

  5. Klik op Registreren.

    • Als u Nieuw model maken hebt geselecteerd, registreert u een model met de naamscikit-learn-power-forecasting, kopieert u het model naar een veilige locatie die wordt beheerd door het werkruimtemodelregister en maakt u een nieuwe versie van het model.
    • Als u een bestaand model hebt geselecteerd, wordt hiermee een nieuwe versie van het geselecteerde model geregistreerd.

    Na enkele ogenblikpen verandert de knop Model registreren in een koppeling naar de nieuwe geregistreerde modelversie.

    Select zojuist gemaakte model

  6. Klik op de koppeling om de nieuwe modelversie te openen in de gebruikersinterface van het werkruimtemodelregister. U kunt het model ook vinden in het werkruimtemodelregister door op ModellenModels IconModels Icon in de zijbalk te klikken.

Een nieuw geregistreerd model maken en er een vastgelegd model aan toewijzen

U kunt de knop Model maken op de pagina met geregistreerde modellen gebruiken om een nieuw, leeg model te maken en er vervolgens een vastgelegd model aan toewijzen. Volg vervolgens deze stappen:

  1. Klik op de pagina met geregistreerde modellen op Model maken. Voer een naam in voor het model en klik op Maken.

  2. Volg de stappen 1 t/m 3 in Een bestaand vastgelegd model registreren via een notebook.

  3. Voer in het dialoogvenster Model registreren select de naam van het model in dat u in stap 1 hebt gemaakt en klik op Registreren. Hiermee wordt een model geregistreerd met de naam die u hebt gemaakt, kopieert u het model naar een veilige locatie die wordt beheerd door het werkruimtemodelregister en maakt u een modelversie: Version 1.

    Na enkele ogenblikken vervangt de gebruikersinterface van de MLflow-uitvoering de knop Model registreren door een koppeling naar de nieuwe geregistreerde modelversie. U kunt nu select het model selecteren in de vervolgkeuzelijst Modellist in het dialoogvenster Model registreren op de pagina Experimentuitvoeringen. U kunt ook nieuwe versies van het model registreren door de naam op te geven in API-opdrachten als Create ModelVersion.

Een model registreren met behulp van de API

Er zijn drie programmatische manieren om een model te registreren in het werkruimtemodelregister. Alle methoden kopiëren het model naar een veilige locatie die wordt beheerd door het werkruimtemodelregister.

  • Als u een model wilt vastleggen en het wilt registreren met de opgegeven naam tijdens een MLflow experiment, gebruikt u de methode mlflow.<model-flavor>.log_model(...). Als een geregistreerd model met die naam niet bestaat, registreert de methode een nieuw model, maakt versie 1 en retourneert een ModelVersion-MLflow-object. Als er al een geregistreerd model met de naam bestaat, maakt de methode een nieuwe modelversie en retourneert deze het versieobject.

    with mlflow.start_run(run_name=<run-name>) as run:
  ...
  mlflow.<model-flavor>.log_model(<model-flavor>=<model>,
    artifact_path="<model-path>",
    registered_model_name="<model-name>"
  )

  • Als u een model met de opgegeven naam wilt registreren nadat u klaar bent met het uitvoeren van een experiment en u hebt besloten welk model het meest geschikt is om toe te voegen aan het register, gebruikt u de methode mlflow.register_model(). Voor deze methode hebt u de uitvoerings-id voor het argument mlruns:URI nodig. Als een geregistreerd model met die naam niet bestaat, registreert de methode een nieuw model, maakt versie 1 en retourneert een ModelVersion-MLflow-object. Als er al een geregistreerd model met de naam bestaat, maakt de methode een nieuwe modelversie en retourneert deze het versieobject.

    result=mlflow.register_model("runs:<model-path>", "<model-name>")

  • Als u een nieuw geregistreerd model met de opgegeven naam wilt maken, gebruikt u de methode create_registered_model() van de MLflow-client-API. Als de modelnaam al bestaat, genereert deze methode een MLflowException.

    client = MlflowClient()
result = client.create_registered_model("<model-name>")

U kunt ook een model registreren bij de Databricks Terraform-provider en databricks_mlflow_model.

Quotumlimieten

Vanaf mei 2024 voor alle Databricks-werkruimten legt het werkruimtemodelregister quotumlimieten op voor het totale aantal geregistreerde modellen en modelversies per werkruimte. Zie Resourcelimieten. Als u de registerquota overschrijdt, raadt Databricks u aan geregistreerde modellen en modelversies te verwijderen die u niet meer nodig hebt. Databricks raadt u ook aan uw modelregistratie- en bewaarstrategie aan te passen om onder de limitte blijven. Als u een verhoging van uw werkruimtelimieten nodig hebt, neemt u contact op met uw Databricks-accountteam.

In het volgende notebook ziet u hoe u uw modelregisterentiteiten inventariseert en verwijdert.

Notebook voor registerentiteiten voor inventariswerkruimtenmodel

Get notebook

Modellen weergeven in de gebruikersinterface

Pagina Geregistreerde modellen

De pagina Geregistreerde modellen wordt weergegeven wanneer u op Modellen in de zijbalk kliktModels Icon. Op deze pagina worden alle modellen in het register weergegeven.

U kunt op deze pagina een nieuw model maken.

Ook op deze pagina kunnen werkruimtebeheerders machtigingen set voor alle modellen in het register van het werkruimtemodel.

Geregistreerde modellen

Geregistreerde modelpagina

Als u de geregistreerde modelpagina voor een model wilt weergeven, klikt u op een modelnaam op de pagina geregistreerde modellen. Op de geregistreerde modelpagina ziet u informatie over het geselecteerde model en een table met informatie over elke versie van het model. Op deze pagina kunt u ook het volgende doen:

Geregistreerd model

Pagina modelversie

Ga op een van de volgende manieren te werk om de versiepagina van het model weer te geven:

  • Klik op een versienaam in de meest recente versiecolumn op de pagina geregistreerde modellen.
  • Klik op een versienaam in de Versiecolumn op de pagina van het geregistreerde model.

Op deze pagina wordt informatie weergegeven over een specifieke versie van een geregistreerd model en wordt ook een koppeling naar de bronuitvoering weergegeven (de versie van het notebook dat is uitgevoerd om het model te maken). Op deze pagina kunt u ook het volgende doen:

Modelversie

Toegang tot modellen beheren

U moet ten minste de machtiging CAN MANAGE hebben om machtigingen voor een model te configureren. Zie MLflow-model-ACL's voor informatie over modelmachtigingsniveaus. Een modelversie neemt machtigingen over van het bovenliggende model. U kunt geen machtigingen instellen voor set binnen modelversies.

  1. Klik in de zijbalk op ModellenModellen.

  2. Select is een modelnaam.

  3. Klik op Machtigingen. Het dialoogvenster Machtigingsinstellingen wordt geopend

    Knop Modelmachtigingen

  4. select in het dialoogvenster de Select gebruiker, groep of service-principal... vervolgkeuzelijst en select een gebruiker, groep of service-principal.

    MLflow-modelmachtigingen wijzigen

  5. Select een machtiging uit de keuzelijst machtigingen.

  6. Klik op Toevoegen en klik op Opslaan.

Werkruimtebeheerders en gebruikers met de machtiging CAN MANAGE op het niveau voor het hele register kunnen set machtigingsniveaus voor alle modellen in de werkruimte door te klikken op Machtigingen op de pagina Modellen.

Een modelfase overzetten

Een modelversie heeft een van de volgende fasen: Geen, Fasering, Productie of Gearchiveerd. De fase Fasering is bedoeld voor het testen en valideren van modellen, terwijl de fase Productie voor modelversies is die de test- of controleprocessen hebben voltooid en die zijn geïmplementeerd voor toepassingen voor live scores. Er wordt aangenomen dat een gearchiveerde modelversie inactief is, op welk punt u kunt overwegen om deze te verwijderen. Verschillende versies van een model kunnen zich in verschillende fasen bevinden.

Een gebruiker met de juiste machtiging kan een modelversie naar een andere fase overzetten. Als u gemachtigd bent om een modelversie naar een bepaalde fase over te zetten, kunt u dit direct doen. Als u niet gemachtigd bent, kunt u het overzetten van de fase aanvragen en kan een gebruiker die gemachtigd is om modelversies over te zetten de aanvraag goedkeuren, afwijzen of annuleren.

U kunt een modelfase overzetten met behulp van de gebruikersinterface of met behulp van de API.

Een modelfase overzetten met behulp van de gebruikersinterface

Volg deze instructies om de fase van een model over te zetten.

  1. Als u de list van de beschikbare modelfasen en opties wilt weergeven, klikt u op de modelversiepagina op de vervolgkeuzelijst naast Fase:, en vraagt u een overgang aan of select naar een andere fase.

    Opties voor faseovergangen

  2. Voer desgewenst een opmerking in en klik op OK.

Een modelversie overzetten naar de productiefase

Na het testen en valideren kunt u de fase overzetten naar de productiefase of dit aanvragen.

Werkruimtemodelregister staat meer dan één versie van het geregistreerde model in elke fase toe. Als u maar één versie in Productie wilt hebben, kunt u alle versies van het model die momenteel in Productie zijn, overzetten naar Gearchiveerd door de optie om bestaande productiemodelversies naar Gearchiveerd over te zetten te selecteren.

Een overgangsaanvraag voor de modelversiefase goedkeuren, afwijzen of annuleren

Een gebruiker zonder machtiging om fasen over te zetten, kan hiertoe een aanvraag indienen. De aanvraag wordt weergegeven in de sectie Aanvragen in behandeling op de pagina met de modelversie:

Overgang naar productie

Voor het goedkeuren, afwijzen of annuleren van een aanvraag voor het overzetten van een fase, klikt u op de koppeling Goedkeuren, Afwijzen of Annuleren.

De indiener van een aanvraag om een fase over te zetten, kan de aanvraag ook annuleren.

Modelversieactiviteiten weergeven

Als u alle overgangen wilt weergeven die zijn aangevraagd, goedgekeurd, in behandeling zijn en zijn toegepast op een modelversie, gaat u naar de sectie Activiteiten. Dit record met activiteiten geeft een overzicht van de levenscyclus van het model voor controle of inspectie.

Een modelfase overzetten met behulp van de API

Gebruikers met de juiste machtigingen kunnen een modelversie naar een nieuwe fase overzetten.

Als u een modelversiefase wilt update naar een nieuwe fase, gebruikt u de transition_model_version_stage() methode van de MLflow client API.

  client = MlflowClient()
  client.transition_model_version_stage(
    name="<model-name>",
    version=<model-version>,
    stage="<stage>",
    description="<description>"
  )

De geaccepteerde values voor <stage> zijn: "Staging"|"staging", "Archived"|"archived", "Production"|"production", "None"|"none".

Model gebruiken voor deductie

Belangrijk

Deze functie is beschikbaar als openbare preview.

Nadat een model is geregistreerd in het Modelregister van de Werkruimte, kunt u automatisch een notebook generate om het model te gebruiken voor batch- of streaming inferentie. U kunt ook een eindpunt maken om het model te gebruiken voor realtime serveren met Model Serving.

Klik in de rechterbovenhoek van de geregistreerde modelpagina of de pagina met de modelversie op modelknop gebruiken. Het dialoogvenster Modeldeductie configureren wordt weergegeven, waarmee u batch-, streaming- of realtimedeductie kunt configureren.

Belangrijk

Anaconda Inc. heeft hun servicevoorwaarden voor anaconda.org kanalen bijgewerkt. Op basis van de nieuwe servicevoorwaarden hebt u mogelijk een commerciële licentie nodig als u afhankelijk bent van de verpakking en distributie van Anaconda. Zie Veelgestelde vragen over Anaconda Commercial Edition voor meer informatie. Uw gebruik van anaconda-kanalen is onderhevig aan hun servicevoorwaarden.

MLflow-modellen die zijn geregistreerd vóór v1.18 (Databricks Runtime 8.3 ML of eerder) zijn standaard vastgelegd met het conda-kanaal defaults (https://repo.anaconda.com/pkgs/) als afhankelijkheid. Vanwege deze licentiewijziging heeft Databricks het gebruik van het defaults kanaal gestopt voor modellen die zijn geregistreerd met MLflow v1.18 en hoger. Het standaardkanaal dat is geregistreerd, is nu conda-forge, die verwijst naar de door de community beheerde https://conda-forge.org/.

Als u een model hebt geregistreerd vóór MLflow v1.18 zonder het defaults kanaal uit te sluiten van de Conda-omgeving voor het model, heeft dat model mogelijk een afhankelijkheid van het defaults kanaal dat u mogelijk niet hebt bedoeld. Als u handmatig wilt controleren of een model deze afhankelijkheid heeft, kunt u de waarde onderzoeken channel in het conda.yaml bestand dat is verpakt met het geregistreerde model. Een model conda.yaml met een defaults kanaalafhankelijkheid kan er bijvoorbeeld als volgt uitzien:

channels:
- defaults
dependencies:
- python=3.8.8
- pip
- pip:
    - mlflow
    - scikit-learn==0.23.2
    - cloudpickle==1.6.0
      name: mlflow-env

Omdat Databricks niet kan bepalen of uw gebruik van de Anaconda-opslagplaats om te communiceren met uw modellen is toegestaan in uw relatie met Anaconda, dwingt Databricks klanten niet om wijzigingen aan te brengen. Als uw gebruik van de Anaconda.com opslagplaats via het gebruik van Databricks is toegestaan volgens de voorwaarden van Anaconda, hoeft u geen actie te ondernemen.

Als u het kanaal wilt wijzigen dat wordt gebruikt in de omgeving van een model, kunt u het model opnieuw registreren bij het register van het werkruimtemodel met een nieuw conda.yaml. U kunt dit doen door het kanaal op te geven in de conda_env parameter van log_model().

Zie de MLflow-documentatie voor de modelsmaak waarmee u werkt, bijvoorbeeld log_model() voor meer informatie over de API.

Zie de conda.yaml voor meer informatie over bestanden.

Dialoogvenster Modeldeductie configureren

Batchdeductie configureren

Wanneer u deze stappen uitvoert om een batchdeductienotitieblok te maken, wordt het notitieblok opgeslagen in de gebruikersmap onder de Batch-Inference map in een map met de naam van het model. U kunt het notitieblok zo nodig bewerken.

  1. Klik op het tabblad Batch-deductie .

  2. In de vervolgkeuzelijst Modelversieselect de modelversie die u wilt gebruiken. De eerste twee items in de vervolgkeuzelijst zijn de huidige productie- en faseringsversie van het model (indien aanwezig). Wanneer u een van deze opties select, gebruikt het notebook automatisch de productie- of faseringsversie vanaf het moment dat deze wordt uitgevoerd. U hoeft het notebook niet te update terwijl u het model blijft ontwikkelen.

  3. Klik op de knop Bladeren naast Invoer table. Het dialoogvenster Select invoergegevens wordt weergegeven. Indien nodig kunt u het cluster wijzigen in de vervolgkeuzelijst Compute .

    Notitie

    Voor werkruimten waar Unity Catalog is ingeschakeld, kunt u met het dialoogvenster voor Select invoergegevens kiezen uit drie niveaus select<catalog-name>.<database-name>.<table-name>.

  4. Select de table met de invoergegevens voor het model en klik op Select. De gegenereerde notebook importeert deze gegevens automatisch en verzendt deze naar het model. U kunt het gegenereerde notebook bewerken als de gegevens transformaties vereisen voordat deze worden ingevoerd in het model.

  5. Voorspellingen worden opgeslagen in een map in de map dbfs:/FileStore/batch-inference. Voorspellingen worden standaard opgeslagen in een map met dezelfde naam als het model. Elke uitvoering van het gegenereerde notebook schrijft een nieuw bestand naar deze map, waarbij de tijdstempel wordt toegevoegd aan de naam. U kunt er ook voor kiezen om de tijdstempel niet op te nemen en het bestand te overschrijven met volgende uitvoeringen van het notebook; instructies worden opgegeven in het gegenereerde notebook.

    U kunt de map wijzigen where de voorspellingen worden opgeslagen door een nieuwe mapnaam te typen in het locatie table locatie veld of door op het mappictogram te klikken om door de map te bladeren en een andere map te select.

    Als u voorspellingen wilt opslaan op een locatie in Unity Catalog, moet u het notebook bewerken. Zie de Catalogvoor een voorbeeldnotitieboek dat laat zien hoe gegevens in Unity Catalog worden gebruikt om een machine learning-model te trainen en hoe de resultaten worden teruggeschreven naar Unity .

Streamingdeductie configureren met behulp van Delta Live Tables

Wanneer u deze stappen uitvoert om een streamingdeductienotitieblok te maken, wordt het notitieblok opgeslagen in de gebruikersmap onder de DLT-Inference map in een map met de naam van het model. U kunt het notitieblok zo nodig bewerken.

  1. Klik op de Streaming (Delta Live Tables) tabblad.

  2. In de vervolgkeuzelijst Modelversieselect de modelversie die u wilt gebruiken. De eerste twee items in de vervolgkeuzelijst zijn de huidige productie- en faseringsversie van het model (indien aanwezig). Wanneer u een van deze opties select, gebruikt het notebook automatisch de productie- of faseringsversie vanaf het moment dat deze wordt uitgevoerd. U hoeft het notebook niet te update terwijl u het model blijft ontwikkelen.

  3. Klik op de knop Bladeren naast Invoer table. Het dialoogvenster Select invoergegevens wordt weergegeven. Indien nodig kunt u het cluster wijzigen in de vervolgkeuzelijst Compute .

    Notitie

    Voor werkruimten waar Unity Catalog is ingeschakeld, kunt u met het dialoogvenster voor Select invoergegevens kiezen uit drie niveaus select<catalog-name>.<database-name>.<table-name>.

  4. Select de table met de invoergegevens voor het model en klik op Select. Het gegenereerde notebook maakt een gegevenstransformatie die gebruikmaakt van de invoer table als bron en de MLflow-PySpark-deductie-UDF- integreert om modelvoorspellingen uit te voeren. U kunt het gegenereerde notebook bewerken als de gegevens aanvullende transformaties vereisen voor of nadat het model is toegepast.

  5. Geef de naam van Delta Live Table op. Het notebook maakt een live table met de opgegeven naam en gebruikt deze om de modelvoorspellingen op te slaan. U kunt het gegenereerde notebook zo aanpassen dat de doelgegevensset indien nodig wordt aangepast. U kunt bijvoorbeeld een livestreaming-table definiëren als uitvoer, schema informatie- of gegevenskwaliteitsbeperkingen toevoegen.

  6. Vervolgens kunt u een nieuwe Delta Live-Tables-pijplijn maken met dit notebook of deze als extra notebookbibliotheek toevoegen aan een bestaande pijplijn.

Realtime deductie configureren

Model serving toont uw MLflow Machine Learning-modellen als schaalbare REST API-eindpunten. Zie Aangepaste eindpunten voor het leveren van modellen maken voor eindpunten voor het maken van een model.

Feedback geven

Deze functie is in preview en we willen graag uw feedback get. Als u feedback wilt geven, klikt u Provide Feedback in het dialoogvenster Modeldeductie configureren.

Modelversies vergelijken

U kunt modelversies vergelijken in het werkruimtemodelregister.

  1. Klik op de selectievakjes links van de modelversies op de geregistreerde modelpagina select om twee of meer modelversies te selecteren.
  2. Klik op Vergelijken.
  3. Het scherm <N> versies vergelijken wordt weergegeven met een table waarmee de parameters, schemaen metrische gegevens van de geselecteerde modelversies worden vergeleken. Onderaan het scherm kunt u select het type plot (spreidingsgrafiek, contour of parallelle coördinaten) en de parameters of metingen die u wilt weergeven.

Voorkeuren voor meldingen beheren

U kunt werkruimtemodelregister configureren om u per e-mail op de hoogte te stellen van activiteiten op geregistreerde modellen en modelversies die u opgeeft.

Op de geregistreerde modelpagina ziet u in het menu Waarschuwen over drie opties:

Menu E-mailmeldingen

  • Alle nieuwe activiteiten: e-mailmeldingen verzenden over alle activiteiten in alle modelversies van dit model. Als u het geregistreerde model hebt gemaakt, is deze instelling de standaardinstelling.
  • Activiteit op versies die ik volg: e-mailmeldingen verzenden over modelversies die u volgt. Met deze selectie ontvangt u meldingen voor alle modelversies die u volgt; u kunt meldingen voor een specifieke modelversie niet uitschakelen.
  • Meldingen dempen: verzend geen e-mailmeldingen over activiteiten op dit geregistreerde model.

Met de volgende gebeurtenissen wordt een e-mailmelding geactiveerd:

  • Een nieuwe modelversie maken
  • Aanvraag voor een faseovergang
  • Faseovergang
  • Nieuwe opmerkingen

U bent automatisch geabonneerd op modelmeldingen wanneer u een van de volgende handelingen uitvoert:

  • Opmerking over die modelversie
  • De fase van een modelversie overzetten
  • Een overgangsaanvraag indienen voor de fase van het model

Als u wilt zien of u een modelversie volgt, kijk dan naar het veld volgstatus op de pagina modelversie, of naar de table van modelversies op de pagina van het geregistreerde model .

Alle e-mailmeldingen uitschakelen

U kunt e-mailmeldingen uitschakelen op het tabblad Registerinstellingen voor werkruimtemodel van het menu Gebruikersinstellingen:

  1. Klik op uw gebruikersnaam in de rechterbovenhoek van de Azure Databricks-werkruimte en selectInstellingen in de vervolgkeuzelijst.
  2. In de zijbalk Instellingen, selectMeldingen.
  3. Schakel e-mailmeldingen voor het modelregister uit.

Een accountbeheerder kan e-mailmeldingen uitschakelen voor de hele organisatie op de pagina met beheerdersinstellingen.

Maximum aantal verzonden e-mailberichten

Werkruimtemodelregister beperkt het aantal e-mailberichten dat per dag per activiteit naar elke gebruiker wordt verzonden. Als u bijvoorbeeld op één dag 20 e-mailberichten ontvangt over nieuwe modelversies die zijn gemaakt voor een geregistreerd model, stuurt Workspace Model Registry een e-mailbericht met de melding dat de dagelijkse limit is bereikt en worden er geen extra e-mailberichten over die gebeurtenis verzonden tot de volgende dag.

Neem contact op met uw Azure Databricks-accountteam om de limit van het toegestane aantal e-mailberichten te verhogen.

Webhooks

Belangrijk

Deze functie is beschikbaar als openbare preview.

Met Webhooks kunt u luisteren naar register-gebeurtenissen voor werkruimtemodellen, zodat uw integraties automatisch acties kunnen activeren. U kunt webhooks gebruiken om uw machine learning-pijplijn te automatiseren en te integreren met bestaande CI/CD-hulpprogramma's en werkstromen. U kunt bijvoorbeeld CI-builds activeren wanneer er een nieuwe modelversie wordt gemaakt of uw teamleden op de hoogte stellen via Slack telkens wanneer een modelovergang naar productie wordt aangevraagd.

Aantekeningen toevoegen aan een model of modelversie

U kunt informatie verstrekken over een model of modelversie door er aantekeningen aan toe te voegen. U kunt bijvoorbeeld een overzicht van het probleem of informatie over de gebruikte methodologie en algoritme toevoegen.

Aantekeningen toevoegen aan een model of modelversie met behulp van de gebruikersinterface

De Gebruikersinterface van Azure Databricks biedt verschillende manieren om aantekeningen te maken bij modellen en modelversies. U kunt tekstinformatie toevoegen met behulp van een beschrijving of opmerkingen en u kunt doorzoekbare sleutel-waardetags toevoegen. Beschrijvingen en tags zijn beschikbaar voor modellen en modelversies; opmerkingen zijn alleen beschikbaar voor modelversies.

  • Beschrijvingen zijn bedoeld om informatie over het model te verstrekken.
  • Opmerkingen bieden een manier om een doorlopende discussie over activiteiten op een modelversie te onderhouden.
  • Met tags kunt u modelmetagegevens aanpassen, zodat u gemakkelijker specifieke modellen kunt vinden.

De beschrijving voor een model of modelversie toevoegen of update-en.

  1. Klik op de pagina geregistreerde model - of modelversie op Bewerken naast Beschrijving. Er verschijnt een bewerking window.

  2. Voer de beschrijving in of bewerk deze in de sectie bewerken window.

  3. Klik op opslaan om de wijzigingen op te slaan of annuleren om het windowte sluiten.

    Als u een beschrijving van een modelversie hebt ingevoerd, wordt de beschrijving weergegeven in de Beschrijvingcolumn in de table op de pagina van het geregistreerde model . In de column worden maximaal 32 tekens of één regel tekst weergegeven, afhankelijk van wat korter is.

Opmerkingen toevoegen voor een modelversie

  1. Schuif omlaag op de pagina met modelversies en klik op de pijl-omlaag naast Activiteiten.
  2. Typ uw opmerking in het bewerkveld window en klik op Commentaar toevoegen.

Tags toevoegen voor een model of modelversie

  1. Klik op de pagina met geregistreerde modellen of modelversiesLabelpictogram als deze nog niet is geopend. De tags table worden weergegeven.

    tag table

  2. Klik in de velden Naam en Waarde en typ de sleutel en waarde voor uw tag.

  3. Klik op Toevoegen.

    tag toevoegen

Tags voor een model of modelversie bewerken of verwijderen

Als u een bestaande tag wilt bewerken of verwijderen, gebruikt u de pictogrammen in de Actiescolumn.

tagacties

Aantekeningen toevoegen aan een modelversie met behulp van de API

Als u een beschrijving van een modelversie wilt update, gebruikt u de update_model_version() methode voor de MLflow-client-API:

client = MlflowClient()
client.update_model_version(
  name="<model-name>",
  version=<model-version>,
  description="<description>"
)

Als u een tag voor een geregistreerd model of modelversie wilt set of update, gebruikt u de MLflow Client-API set_registered_model_tag()) of de set_model_version_tag() methode:

client = MlflowClient()
client.set_registered_model_tag()(
  name="<model-name>",
  key="<key-value>",
  tag="<tag-value>"
)

client = MlflowClient()
client.set_model_version_tag()(
  name="<model-name>",
  version=<model-version>,
  key="<key-value>",
  tag="<tag-value>"
)

De naam van een model wijzigen (alleen API)

Als u de naam van een geregistreerd model wilt wijzigen, gebruikt u de methode rename_registered_model() van de MLflow-client-API:

client=MlflowClient()
client.rename_registered_model("<model-name>", "<new-model-name>")

Notitie

U kunt de naam van een geregistreerd model alleen wijzigen als er geen versies zijn of als alle versies zich in de fase Geen of Gearchiveerd bevinden.

Een model zoeken

U kunt zoeken naar modellen in het werkruimtemodelregister met behulp van de gebruikersinterface of de API.

Notitie

Wanneer u een model zoekt, worden alleen modellen geretourneerd waarvoor u ten minste LEESmachtigingen voor CAN hebt.

Een model zoeken met behulp van de gebruikersinterface

Als u geregistreerde modellen wilt weergeven, klikt u op ModellenModellen in de zijbalk.

Als u naar een specifiek model wilt zoeken, voert u tekst in het zoekvak in. U kunt de naam van een model of een deel van de naam invoeren:

Zoeken naar geregistreerde modellen

U kunt ook zoeken op tags. Voer tags in deze indeling in: tags.<key>=<value>. Gebruik de AND operator om meerdere tags te zoeken.

Zoeken op basis van tags

U kunt zoeken op zowel de modelnaam als tags met behulp van de MLflow-zoeksyntaxis. Voorbeeld:

Zoeken op basis van namen en tags

Een model zoeken met behulp van de API

U kunt zoeken naar geregistreerde modellen in het werkruimtemodelregister met de MLflow Client-API-methode search_registered_models()

Als u set tags op uw modellen hebt, kunt u ook zoeken op deze tags met search_registered_models().

print(f"Find registered models with a specific tag value")
for m in client.search_registered_models(f"tags.`<key-value>`='<tag-value>'"):
  pprint(dict(m), indent=4)

U kunt ook zoeken naar een specifieke modelnaam en de versiegegevens list met behulp van de MLflow-client-API search_model_versions() methode:

from pprint import pprint

client=MlflowClient()
[pprint(mv) for mv in client.search_model_versions("name='<model-name>'")]

Dit levert de volgende uitvoer op:

{   'creation_timestamp': 1582671933246,
    'current_stage': 'Production',
    'description': 'A random forest model containing 100 decision trees '
                   'trained in scikit-learn',
    'last_updated_timestamp': 1582671960712,
    'name': 'sk-learn-random-forest-reg-model',
    'run_id': 'ae2cc01346de45f79a44a320aab1797b',
    'source': './mlruns/0/ae2cc01346de45f79a44a320aab1797b/artifacts/sklearn-model',
    'status': 'READY',
    'status_message': None,
    'user_id': None,
    'version': 1 }

{   'creation_timestamp': 1582671960628,
    'current_stage': 'None',
    'description': None,
    'last_updated_timestamp': 1582671960628,
    'name': 'sk-learn-random-forest-reg-model',
    'run_id': 'd994f18d09c64c148e62a785052e6723',
    'source': './mlruns/0/d994f18d09c64c148e62a785052e6723/artifacts/sklearn-model',
    'status': 'READY',
    'status_message': None,
    'user_id': None,
    'version': 2 }

Een model of modelversie verwijderen

U kunt een model verwijderen met behulp van de gebruikersinterface of de API.

Een modelversie of model verwijderen met behulp van de gebruikersinterface

Waarschuwing

U kunt deze actie niet ongedaan maken. U kunt een modelversie overzetten naar de fase Gearchiveerd in plaats van deze te verwijderen uit het register. Wanneer u een model verwijdert, worden alle modelartefacten die zijn opgeslagen door het werkruimtemodelregister en alle metagegevens die aan het geregistreerde model zijn gekoppeld, verwijderd.

Notitie

U kunt modellen en modelversies alleen verwijderen in de fase Geen of Gearchiveerd. Als een geregistreerd model versies bevat in de fase Fasering of Productie, moet u deze overzetten naar de fase Geen of Gearchiveerd voordat u het model verwijdert.

Ga als volgt te werk om een model of modelversie te verwijderen:

  1. Klik op ModellenModellen in de zijbalk.
  2. Klik op een modelnaam.
  3. Klik op een modelversie.
  4. Klik op het kebabmenu in de rechterbovenhoek van het scherm en selectVerwijder uit het dropdownmenu.

Ga als volgt te werk om een model te verwijderen:

  1. Klik op ModellenModellen in de zijbalk.
  2. Klik op een modelnaam.
  3. Klik op het kebabmenu in de rechterbovenhoek van het scherm en selectVerwijder uit het dropdownmenu.

Een modelversie of model verwijderen met behulp van de API

Waarschuwing

U kunt deze actie niet ongedaan maken. U kunt een modelversie overzetten naar de fase Gearchiveerd in plaats van deze te verwijderen uit het register. Wanneer u een model verwijdert, worden alle modelartefacten die zijn opgeslagen door het werkruimtemodelregister en alle metagegevens die aan het geregistreerde model zijn gekoppeld, verwijderd.

Notitie

U kunt modellen en modelversies alleen verwijderen in de fase Geen of Gearchiveerd. Als een geregistreerd model versies bevat in de fase Fasering of Productie, moet u deze overzetten naar de fase Geen of Gearchiveerd voordat u het model verwijdert.

Een modelversie verwijderen

Als u een modelversie wilt verwijderen, gebruikt u de methode delete_model_version() van de MLflow-client-API:

# Delete versions 1,2, and 3 of the model
client = MlflowClient()
versions=[1, 2, 3]
for version in versions:
  client.delete_model_version(name="<model-name>", version=version)

Een model verwijderen

Als u een model wilt verwijderen, gebruikt u de methode delete_registered_model() van de MLflow-client-API:

client = MlflowClient()
client.delete_registered_model(name="<model-name>")

Modellen delen in werkruimten

Databricks raadt het gebruik van -modellen in Unity Catalog aan om modellen in werkruimten te delen. Unity Catalog biedt out-of-the-box ondersteuning voor toegang tot modellen over werkruimten heen, governance en auditlogboeken.

Als u echter het register van het werkruimtemodel gebruikt, kunt u ook modellen delen in meerdere werkruimten met een bepaalde installatie. U kunt bijvoorbeeld een model ontwikkelen en registreren in uw eigen werkruimte en deze vervolgens openen vanuit een andere werkruimte met behulp van een extern werkruimtemodelregister. Dit is handig wanneer meerdere teams toegang tot modellen delen. U kunt meerdere werkruimten maken en modellen in deze omgevingen gebruiken en beheren.

MLflow-objecten kopiëren tussen werkruimten

Als u MLflow-objecten wilt importeren of exporteren naar of vanuit uw Azure Databricks-werkruimte, kunt u het door de community gestuurde opensource-project MLflow Export-Import gebruiken om MLflow-experimenten, modellen en uitvoeringen tussen werkruimten te migreren.

Met deze hulpprogramma's kunt u het volgende doen:

  • Deel en werk samen met andere gegevenswetenschappers op dezelfde of een andere traceringsserver. U kunt bijvoorbeeld een experiment van een andere gebruiker klonen in uw werkruimte.
  • Kopieer een model van de ene werkruimte naar de andere, bijvoorbeeld van een ontwikkeling naar een productiewerkruimte.
  • Kopieer MLflow-experimenten en voer deze uit vanaf uw lokale traceringsserver naar uw Databricks-werkruimte.
  • Maak een back-up van essentiële experimenten en modellen naar een andere Databricks-werkruimte.

Opmerking

In dit voorbeeld ziet u hoe u het werkruimtemodelregister gebruikt om een machine learning-toepassing te bouwen.

Voorbeeld van het register van werkruimtemodel