core Pakket
Bevat kernpakketten, modules en klassen voor Azure Machine Learning.
Hoofdgebieden zijn onder andere het beheren van rekendoelen, het maken/beheren van werkruimten en experimenten, en het verzenden/openen van modeluitvoeringen en het uitvoeren van uitvoer/logboekregistratie.
Pakketten
compute |
Dit pakket bevat klassen die worden gebruikt voor het beheren van rekendoelen in Azure Machine Learning. |
image |
Bevat functionaliteit voor het beheren van installatiekopieën die zijn geïmplementeerd als webservice-eindpunten in Azure Machine Learning. Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse. Een installatiekopieën worden gebruikt voor het implementeren van een Model, script en gekoppelde bestanden als een webservice-eindpunt of IoT Edge-apparaat. Het eindpunt verwerkt binnenkomende scoreaanvragen en retourneert voorspellingen. De belangrijkste klassen van dit pakket zijn de Image klasse, de bovenliggende klasse van Azure Machine Learning-installatiekopieën en de afgeleide ContainerImage klasse voor Docker-installatiekopieën en preview-installatiekopieën zoals FPGA. Tenzij u een werkstroom hebt waarvoor specifiek afbeeldingen moeten worden gebruikt, moet u in plaats daarvan de Environment klasse gebruiken om uw installatiekopieën te definiëren. Vervolgens kunt u het omgevingsobject gebruiken met de Model Zie Modellen implementeren met Azure Machine Learning voor meer informatie over het gebruik van de modelklasse. Zie Een model implementeren met behulp van een aangepaste Docker-basisinstallatiekopieën voor meer informatie over het gebruik van aangepaste installatiekopieën. |
webservice |
Bevat functionaliteit voor het implementeren van machine learning-modellen als webservice-eindpunten in Azure Machine Learning. Als u een Azure Machine Learning-model implementeert als een webservice, wordt er een eindpunt en een REST API gemaakt. U kunt gegevens naar deze API verzenden en de voorspelling ontvangen die door het model wordt geretourneerd. U maakt een webservice wanneer u een Model of Image naar Azure Container Instances (aci module), Azure Kubernetes Service (aks module) en Azure Kubernetes Endpoint (AksEndpoint) of veld programmeerbare poortmatrices (FPGA) implementeert. Implementatie met behulp van een model wordt aanbevolen voor de meeste use cases, terwijl implementatie met behulp van een installatiekopieën wordt aanbevolen voor geavanceerde gebruiksvoorbeelden. Beide typen implementaties worden ondersteund in de klassen in deze module. |
Modules
authentication |
Bevat functionaliteit voor het beheren van verschillende typen verificatie in Azure Machine Learning. Typen ondersteunde verificatie:
Zie https://aka.ms/aml-notebook-authvoor meer informatie over deze verificatiemechanismen. |
compute_target |
Bevat functionaliteit voor rekendoelen die niet worden beheerd door Azure Machine Learning. Rekendoelen definiëren uw trainings-rekenomgeving en kunnen lokale of externe resources in de cloud zijn. Met externe resources kunt u uw machine learning-experimenten eenvoudig omhoog of uitschalen door gebruik te maken van versnelde CPU- en GPU-verwerkingsmogelijkheden. Zie de ComputeTarget klasse voor informatie over rekendoelen die worden beheerd door Azure Machine Learning. Zie Wat zijn rekendoelen in Azure Machine Learning voor meer informatie? |
conda_dependencies |
Bevat functionaliteit voor het beheren van conda-omgevingsafhankelijkheden. Gebruik de CondaDependencies klasse om bestaande Conda-omgevingsbestanden te laden en nieuwe omgevingen te configureren en beheren waar experimenten worden uitgevoerd. |
container_registry |
Bevat functionaliteit voor het beheren van een Azure Container Registry. |
databricks |
Bevat functionaliteit voor het beheren van Databricks-omgevingen in Azure Machine Learning. |
dataset |
Beheert de interactie met Azure Machine Learning-gegevenssets. Deze module biedt functionaliteit voor het gebruik van onbewerkte gegevens, het beheren van gegevens en het uitvoeren van acties op gegevens in Azure Machine Learning. Gebruik de Dataset klasse in deze module om gegevenssets samen met de functionaliteit in het data pakket te maken, die de ondersteunende klassen FileDataset bevat en TabularDataset. Zie het artikel Gegevenssets toevoegen en registreren om aan de slag te gaan met gegevenssets. |
datastore |
Bevat functionaliteit voor het beheren van gegevensarchieven in Azure Machine Learning. |
environment |
Bevat functionaliteit voor het maken en beheren van reproduceerbare omgevingen in Azure Machine Learning. Omgevingen bieden een manier om softwareafhankelijkheid te beheren, zodat gecontroleerde omgevingen kunnen worden gereproduceerd met minimale handmatige configuratie wanneer u navigeert tussen lokale en gedistribueerde cloudontwikkelingsomgevingen. Een omgeving bevat Python-pakketten, omgevingsvariabelen, software-instellingen voor het trainen en scoren van scripts, en uitvoeringstijden in Python, Spark of Docker. Zie Herbruikbare omgevingen maken en beheren voor meer informatie over het gebruik van omgevingen voor training en implementatie met Azure Machine Learning. |
experiment |
Bevat functionaliteit die wordt gebruikt voor het verzenden van experimenten en het beheren van de experimentgeschiedenis in Azure Machine Learning. |
keyvault |
Bevat functionaliteit voor het beheren van geheimen in de Sleutelkluis die is gekoppeld aan een Azure Machine Learning-werkruimte. Deze module bevat handige methoden voor het toevoegen, ophalen, verwijderen en weergeven van geheimen uit de Azure Key Vault die is gekoppeld aan een werkruimte. |
linked_service |
Bevat functionaliteit voor het maken en beheren van een gekoppelde service in de AML-werkruimte. |
model |
Bevat functionaliteit voor het beheren van machine learning-modellen in Azure Machine Learning. Met de Model klasse kunt u de volgende hoofdtaken uitvoeren:
|
private_endpoint |
Bevat functionaliteit voor het definiëren en configureren van Privé-eindpunten van Azure. |
profile |
Bevat functionaliteit voor profileringsmodellen in Azure Machine Learning. |
resource_configuration |
Bevat functionaliteit voor het beheren van de configuratie van resources voor Azure Machine Learning-entiteiten. |
run |
Bevat functionaliteit voor het beheren van metrische experimentgegevens en artefacten in Azure Machine Learning. |
runconfig |
Bevat functionaliteit voor het beheren van de configuratie van experimentuitvoeringen in Azure Machine Learning. De sleutelklasse in deze module is, waarmee informatie wordt ingekapseld die nodig is RunConfigurationvoor het verzenden van een trainingsuitvoering op een opgegeven rekendoel. De configuratie bevat een brede set gedragsdefinities, zoals of u een bestaande Python-omgeving wilt gebruiken of een Conda-omgeving wilt gebruiken die is gebouwd op basis van een specificatie. Andere configuratieklassen in de module worden geopend via RunConfiguration. |
script_run |
Bevat functionaliteit voor het beheren van ingediende trainingsuitvoeringen in Azure Machine Learning. |
script_run_config |
Bevat functionaliteit voor het beheren van de configuratie voor het verzenden van trainingsuitvoeringen in Azure Machine Learning. |
util |
Bevat klasse voor het opgeven van detailniveau voor logboekregistratie. |
workspace |
Bevat functionaliteit voor het beheren van een werkruimte, de resource op het hoogste niveau in Azure Machine Learning. Deze module bevat de Workspace klasse en de bijbehorende methoden en kenmerken waarmee u machine learning-artefacten zoals rekendoelen, omgevingen, gegevensarchieven, experimenten en modellen kunt beheren. Een werkruimte is gekoppeld aan een Azure-abonnement en -resourcegroep en is de primaire methode voor facturering. Werkruimten ondersteunen op rollen gebaseerd toegangsbeheer (RBAC) van Azure Resource Manager en regioaffiniteit voor alle machine learning-gegevens die zijn opgeslagen in de werkruimte. |
Klassen
ComputeTarget |
Abstracte bovenliggende klasse voor alle rekendoelen die worden beheerd door Azure Machine Learning. Een rekendoel is een aangewezen rekenresource/-omgeving waarin u uw trainingsscript uitvoert of uw service-implementatie host. Deze locatie is mogelijk uw lokale computer of een rekenresource in de cloud. Zie Wat zijn rekendoelen in Azure Machine Learning voor meer informatie? Klasse ComputeTarget-constructor. Haal een cloudweergave op van een Compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde compute-object. |
ContainerRegistry |
Hiermee definieert u een verbinding met een Azure Container Registry. Klasse ContainerRegistry-constructor. |
Dataset |
Vertegenwoordigt een resource voor het verkennen, transformeren en beheren van gegevens in Azure Machine Learning. Een gegevensset is een verwijzing naar gegevens in een Datastore of achter openbare web-URL's. Voor methoden die in deze klasse zijn afgeschaft, controleert AbstractDataset u de klasse op de verbeterde API's. De volgende typen gegevenssets worden ondersteund:
Als u aan de slag wilt gaan met gegevenssets, raadpleegt u het artikel Gegevenssets toevoegen en registreren, of raadpleegt u de notebooks https://aka.ms/tabulardataset-samplenotebook en https://aka.ms/filedataset-samplenotebook. Initialiseer het gegevenssetobject. Gebruik de get-methode om een gegevensset te verkrijgen die al is geregistreerd bij de werkruimte. |
Datastore |
Vertegenwoordigt een opslagabstractie via een Azure Machine Learning-opslagaccount. Gegevensarchieven worden gekoppeld aan werkruimten en worden gebruikt om verbindingsgegevens op te slaan met Azure-opslagservices, zodat u deze op naam kunt raadplegen en de verbindingsgegevens en het geheim dat wordt gebruikt om verbinding te maken met de opslagservices niet hoeft te onthouden. Voorbeelden van ondersteunde Azure-opslagservices die kunnen worden geregistreerd als gegevensarchieven zijn:
Gebruik deze klasse om beheerbewerkingen uit te voeren, zoals registreren, weergeven, ophalen en verwijderen van gegevensarchieven.
Gegevensarchieven voor elke service worden gemaakt met de Zie de volgende artikelen voor meer informatie over gegevensarchieven en hoe ze kunnen worden gebruikt in machine learning: Haal een gegevensarchief op naam op. Met deze aanroep wordt een aanvraag ingediend bij de gegevensopslagservice. |
Environment |
Hiermee configureert u een reproduceerbare Python-omgeving voor machine learning-experimenten. Een omgeving definieert Python-pakketten, omgevingsvariabelen en Docker-instellingen die worden gebruikt in machine learning-experimenten, waaronder in gegevensvoorbereiding, training en implementatie in een webservice. Een omgeving wordt beheerd en geversied in een Azure Machine Learning Workspace. U kunt een bestaande omgeving bijwerken en een versie ophalen om opnieuw te gebruiken. Omgevingen zijn exclusief voor de werkruimte waarin ze zijn gemaakt en kunnen niet worden gebruikt in verschillende werkruimten. Zie Herbruikbare omgevingen maken en beheren voor meer informatie over omgevingen. Klasseomgevingconstructor. |
Experiment |
Vertegenwoordigt het belangrijkste toegangspunt voor het maken en werken met experimenten in Azure Machine Learning. Een experiment is een container met proefversies die meerdere modeluitvoeringen vertegenwoordigen. Experimentconstructor. |
Image |
Definieert de abstracte bovenliggende klasse voor Azure Machine Learning-installatiekopieën. Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse. Afbeeldingsconstructor. Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse. Afbeeldingsconstructor wordt gebruikt om een cloudweergave op te halen van een afbeeldingsobject dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde afbeeldingsobject. |
Keyvault |
Beheert geheimen die zijn opgeslagen in de Azure Key Vault die is gekoppeld aan een Azure Machine Learning-werkruimte. Elke Azure Machine Learning-werkruimte heeft een gekoppelde Azure Key Vault. De Keyvault-klasse is een vereenvoudigde wrapper van De Azure Key Vault waarmee u geheimen in de sleutelkluis kunt beheren, waaronder het instellen, ophalen, verwijderen en weergeven van geheimen. Gebruik de Keyvault-klasse om geheimen veilig door te geven aan externe uitvoeringen zonder gevoelige informatie in duidelijke tekst weer te geven. Zie Geheimen gebruiken in trainingsuitvoeringen voor meer informatie. Klasse Keyvault-constructor. |
LinkedService |
Notitie Dit is een experimentele klasse en kan op elk gewenst moment worden gewijzigd. Zie https://aka.ms/azuremlexperimental voor meer informatie. Definieert een resource voor het beheren van koppelingen tussen AML-werkruimten met andere services in Azure. Initialiseer het LinkedService-object. |
Model |
Vertegenwoordigt het resultaat van machine learning-training. Een model is het resultaat van een Azure Machine Learning-training Run of een ander modeltrainingsproces buiten Azure. Ongeacht hoe het model wordt geproduceerd, kan het worden geregistreerd in een werkruimte, waar het wordt vertegenwoordigd door een naam en een versie. Met de modelklasse kunt u modellen verpakken voor gebruik met Docker en deze implementeren als een realtime-eindpunt dat kan worden gebruikt voor deductieaanvragen. Zie Afbeeldingsclassificatiemodel trainen met MNIST-gegevens en scikit-learn met behulp van Azure Machine Learning voor een end-to-end-zelfstudie waarin wordt getoond hoe modellen worden gemaakt, beheerd en gebruikt. Modelconstructor. De modelconstructor wordt gebruikt om een cloudweergave op te halen van een modelobject dat is gekoppeld aan de opgegeven werkruimte. Moet een naam of id opgeven. |
PrivateEndPoint |
Hiermee definieert u een privé-eindpunt voor het beheren van privé-eindpuntverbindingen die zijn gekoppeld aan een Azure ML-werkruimte. Initialiseer PrivateEndPoint. |
PrivateEndPointConfig |
Hiermee definieert u de configuratie voor een privé-eindpunt van Azure. Azure Private Endpoint is een netwerkinterface die u privé en veilig verbindt met een Azure ML-werkruimte met Private Link. Initialiseer PrivateEndPointConfig. |
Run |
Definieert de basisklasse voor alle uitvoeringen van Azure Machine Learning-experimenten. Een uitvoering vertegenwoordigt één proefversie van een experiment. Uitvoeringen worden gebruikt om de asynchrone uitvoering van een proefversie te bewaken, metrische gegevens te registreren en uitvoer van de proefversie op te slaan, en om resultaten te analyseren en toegang te krijgen tot artefacten die door de proefversie zijn gegenereerd. Uitvoeringsobjecten worden gemaakt wanneer u een script verzendt om een model te trainen in veel verschillende scenario's in Azure Machine Learning, waaronder HyperDrive-uitvoeringen, pijplijnuitvoeringen en AutoML-uitvoeringen. Er wordt ook een Run-object gemaakt wanneer u submit of start_logging met de Experiment klasse werkt. Als u aan de slag wilt gaan met experimenten en uitvoeringen, raadpleegt u Initialiseer het run-object. |
RunConfiguration |
Vertegenwoordigt de configuratie voor experimentuitvoeringen die zijn gericht op verschillende rekendoelen in Azure Machine Learning. Het RunConfiguration-object bevat de informatie die nodig is om een trainingsuitvoering in een experiment in te dienen. Normaal gesproken maakt u geen RunConfiguration-object rechtstreeks, maar haalt u er een op uit een methode die het retourneert, zoals de submit methode van de Experiment klasse. RunConfiguration is een basisomgevingsconfiguratie die ook wordt gebruikt in andere typen configuratiestappen die afhankelijk zijn van het type uitvoering dat u activeert. Als u bijvoorbeeld een PythonScriptStepinstelling instelt, hebt u toegang tot het RunConfiguration-object van de stap en configureert u Conda-afhankelijkheden of opent u de omgevingseigenschappen voor de uitvoering. Zie Een rekendoel selecteren en gebruiken om uw model te trainen voor voorbeelden van uitvoeringsconfiguraties. Initialiseer een RunConfiguration met de standaardinstellingen. |
ScriptRun |
Biedt programmatische toegang voor het beheren van ingediende trainingsuitvoeringen. Een uitvoering die is ingediend met ScriptRunConfig één proefabonnement in een experiment. Als u de uitvoering verzendt, wordt een ScriptRun-object geretourneerd, dat kan worden gebruikt om de asynchrone uitvoering van de uitvoering te controleren, metrische gegevens te registreren en uitvoer van de uitvoering op te slaan, en resultaten te analyseren en toegangsartefacten te analyseren die door de uitvoering zijn gegenereerd. Zie To started with experiments and ScriptRunConf (Aan de slag met experimenten en ScriptRunConf) Klasse ScriptRun-constructor. |
ScriptRunConfig |
Vertegenwoordigt configuratiegegevens voor het verzenden van een trainingsuitvoering in Azure Machine Learning. Een ScriptRunConfig-pakket bevat de configuratiegegevens die nodig zijn voor het verzenden van een uitvoering in Azure ML, met inbegrip van het script, het rekendoel, de omgeving en eventuele gedistribueerde taakspecifieke configuraties. Zodra een script is geconfigureerd en verzonden met de submitscriptuitvoering, wordt er een ScriptRun geretourneerd. Klasse ScriptRunConfig-constructor. |
SynapseWorkspaceLinkedServiceConfiguration |
Notitie Dit is een experimentele klasse en kan op elk gewenst moment worden gewijzigd. Zie https://aka.ms/azuremlexperimental voor meer informatie. Hiermee definieert u een configuratie van een gekoppelde service voor het koppelen van een Synapse-werkruimte. Initialiseer het SynapseWorkspaceLinkedServiceConfiguration-object. |
Webservice |
Definieert basisfunctionaliteit voor het implementeren van modellen als webservice-eindpunten in Azure Machine Learning. Webserviceconstructor wordt gebruikt om een cloudweergave op te halen van een webserviceobject dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde webserviceobject. Met de webserviceklasse kunt u machine learning-modellen implementeren vanuit een Model of Image een object. Zie Modellen implementeren met Azure Machine Learning voor meer informatie over het werken met webservice. Initialiseer het webservice-exemplaar. De webserviceconstructor haalt een cloudweergave op van een webserviceobject dat is gekoppeld aan de opgegeven werkruimte. Er wordt een exemplaar van een onderliggende klasse geretourneerd dat overeenkomt met het specifieke type van het opgehaalde webserviceobject. |
Workspace |
Definieert een Azure Machine Learning-resource voor het beheren van trainings- en implementatieartefacten. Een werkruimte is een fundamentele resource voor machine learning in Azure Machine Learning. U gebruikt een werkruimte om machine learning-modellen te experimenteren, trainen en implementeren. Elke werkruimte is gekoppeld aan een Azure-abonnement en -resourcegroep en heeft een bijbehorende SKU. Zie voor meer informatie over werkruimten: Class Workspace-constructor voor het laden van een bestaande Azure Machine Learning-werkruimte. |
diagnostic_log |
Hiermee worden foutopsporingslogboeken naar een opgegeven bestand verzonden. |
Functies
attach_legacy_compute_target
Hiermee wordt een rekendoel aan dit project gekoppeld.
attach_legacy_compute_target(experiment, source_directory, compute_target)
Parameters
Name | Description |
---|---|
experiment
Vereist
|
|
source_directory
Vereist
|
|
compute_target
Vereist
|
Een rekendoelobject dat moet worden gekoppeld. |
Retouren
Type | Description |
---|---|
Geen als de bijlage is geslaagd, wordt er anders een uitzondering gegenereerd. |
get_run
Haal de uitvoering voor dit experiment op met de uitvoerings-id.
get_run(experiment, run_id, rehydrate=True, clean_up=True)
Parameters
Name | Description |
---|---|
experiment
Vereist
|
Het bevattende experiment. |
run_id
Vereist
|
De uitvoerings-id. |
rehydrate
|
<xref:boolean>
Geeft aan of het oorspronkelijke uitvoeringsobject wordt geretourneerd of alleen een basisuitvoeringsobject. Als waar is, retourneert deze functie het oorspronkelijke uitvoeringsobjecttype. Voor een AutoML-uitvoering wordt bijvoorbeeld een AutoMLRun object geretourneerd, terwijl voor een HyperDrive-uitvoering een HyperDriveRun object wordt geretourneerd. Als onwaar is, retourneert de functie een Run object. Default value: True
|
clean_up
|
Als dit waar is, roept u _register_kill_handler aan vanuit run_base Default value: True
|
Retouren
Type | Description |
---|---|
De ingediende uitvoering. |
is_compute_target_prepared
Controleer of het rekendoel is voorbereid.
Controleert of het rekendoel, opgegeven in run_config, al is voorbereid of niet voor de opgegeven uitvoeringsconfiguratie.
is_compute_target_prepared(experiment, source_directory, run_config)
Parameters
Name | Description |
---|---|
experiment
Vereist
|
|
source_directory
Vereist
|
|
run_config
Vereist
|
De uitvoeringsconfiguratie. Dit kan een uitvoeringsconfiguratienaam, als tekenreeks of een azureml.core.runconfig.RunConfiguration-object zijn. |
Retouren
Type | Description |
---|---|
Waar, als het rekendoel is voorbereid. |
prepare_compute_target
Bereid het rekendoel voor.
Installeert alle vereiste pakketten voor een experimentuitvoering op basis van run_config en custom_run_config.
prepare_compute_target(experiment, source_directory, run_config)
Parameters
Name | Description |
---|---|
experiment
Vereist
|
|
source_directory
Vereist
|
|
run_config
Vereist
|
De uitvoeringsconfiguratie. Dit kan een uitvoeringsconfiguratienaam, als tekenreeks of een azureml.core.runconfig.RunConfiguration-object zijn. |
Retouren
Type | Description |
---|---|
Een run-object |
remove_legacy_compute_target
Verwijder een rekendoel uit het project.
remove_legacy_compute_target(experiment, source_directory, compute_target_name)
Parameters
Name | Description |
---|---|
experiment
Vereist
|
|
source_directory
Vereist
|
|
compute_target_name
Vereist
|
|
Retouren
Type | Description |
---|---|
Geen als het verwijderen van het rekendoel is geslaagd, genereert anders een uitzondering. |