AzureBlobDatastore Klas
Vertegenwoordigt een gegevensarchief dat verbindingsgegevens opslaat in Azure Blob Storage.
U moet niet rechtstreeks met deze klasse werken. Als u een gegevensarchief van dit type wilt maken, gebruikt u de register_azure_blob_container methode van Gegevensarchief.
Opmerking: wanneer u een gegevensarchief gebruikt om toegang te krijgen tot gegevens, moet u gemachtigd zijn om toegang te krijgen tot die gegevens. Dit is afhankelijk van de referenties die zijn geregistreerd bij het gegevensarchief.
Initialiseer een nieuwe Azure Blob-gegevensopslag.
- Overname
-
AzureBlobDatastore
Constructor
AzureBlobDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint=None, request_session=None, workspace_msi_has_access=False, subscription_id=None, resource_group=None, service_data_access_auth_identity=None)Parameters
- name
- str
De naam van het gegevensarchief. Het mag alleen alfanumerieke tekens of - of _bevatten.
- sas_token
- str, <xref:optional>
Het SAS-token voor toegang tot deze container. De standaardwaarde is Geen.
- account_key
- str, <xref:optional>
De opslagaccountsleutel. De standaardwaarde is Geen.
- protocol
- str, <xref:optional>
Het protocol dat moet worden gebruikt om verbinding te maken met het opslagaccount. Indien Geen, wordt standaard ingesteld op https.
- endpoint
- str, <xref:optional>
Het eindpunt van de blobcontainer. Indien Geen, wordt standaard ingesteld op core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
het sessieobject dat moet worden gebruikt voor HTTP-aanvragen. De standaardwaarde is Geen.
- name
- str
De naam van het gegevensarchief. Het mag alleen alfanumerieke tekens of - of _bevatten.
- sas_token
- str, <xref:optional>
Het SAS-token voor toegang tot deze container. De standaardwaarde is Geen.
- protocol
- str, <xref:optional>
Het protocol dat moet worden gebruikt om verbinding te maken met het opslagaccount. Indien Geen, wordt standaard ingesteld op https.
- endpoint
- str, <xref:optional>
Het eindpunt van de blobcontainer. Indien Geen, wordt standaard ingesteld op core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
Het sessieobject dat moet worden gebruikt voor HTTP-aanvragen. De standaardwaarde is Geen.
- workspace_msi_has_access
- bool, <xref:optional>
Of de msi van de werkruimte toegang heeft tot dit opslagaccount. (Afgeschaft)
- service_data_access_auth_identity
- str of <xref:_restclient.models.ServiceDataAccessAuthIdentity>
Geeft aan welke identiteit moet worden gebruikt om toegang tot servicegegevens tot de opslag van de klant te verifiëren. Mogelijke waarden zijn: 'None', 'WorkspaceSystemAssignedIdentity', 'WorkspaceUserAssignedIdentity'
Methoden
| download |
Download de gegevens van de blobcontainer naar het lokale bestandssysteem. |
| upload |
Upload de gegevens van het lokale bestandssysteem naar de blobcontainer waarnaar dit gegevensarchief verwijst. Opmerking: deze methode werkt alleen als de eigenschap accountsleutel of sas-token van het gegevensarchiefobject is ingevuld. Als het gegevensarchiefobject geen enkele vorm van referentie bevat, mislukt deze methode.
Bovendien is deze methode afgeschaft en kan in de toekomst worden verwijderd. We raden u aan de |
| upload_files |
Upload de gegevens van het lokale bestandssysteem naar de blobcontainer waarnaar deze gegevensopslag verwijst. Opmerking: deze methode is afgeschaft en wordt niet meer ondersteund. In plaats daarvan wordt aanbevolen om te gebruiken |
download
Download de gegevens van de blobcontainer naar het lokale bestandssysteem.
download(target_path, prefix=None, overwrite=False, show_progress=True)Parameters
- prefix
- str, <xref:optional>
Het pad naar de map in de blobcontainer die u wilt downloaden. Als deze optie is ingesteld op Geen, wordt alles in de blob gedownload. De standaardwaarde is Geen.
- overwrite
- bool, <xref:optional>
Geeft aan of bestaande bestanden moeten worden overschreven. Standaard ingesteld op False.
- show_progress
- bool, <xref:optional>
Geeft aan of de voortgang van het downloaden in de console moet worden weergegeven. De standaardwaarde is True.
Retouren
Het aantal bestanden dat is gedownload.
Retourtype
upload
Upload de gegevens van het lokale bestandssysteem naar de blobcontainer waarnaar dit gegevensarchief verwijst.
Opmerking: deze methode werkt alleen als de eigenschap accountsleutel of sas-token van het gegevensarchiefobject is ingevuld. Als het gegevensarchiefobject geen enkele vorm van referentie bevat, mislukt deze methode.
Bovendien is deze methode afgeschaft en kan in de toekomst worden verwijderd. We raden u aan de Dataset.File.upload_directory methode te gebruiken om uw bestanden vanuit de lokale map te uploaden en FileDataset te maken in één methode-aanroep.
upload(src_dir, target_path=None, overwrite=False, show_progress=True)Parameters
- target_path
- str
De locatie in de blobcontainer waarnaar u wilt uploaden. Indien Geen, uploadt u naar de hoofdmap. De standaardwaarde is Geen.
- overwrite
- bool, <xref:optional>
Geeft aan of bestaande bestanden moeten worden overschreven. Standaard ingesteld op False.
- show_progress
- bool, <xref:optional>
Geeft aan of de voortgang van het uploaden in de console moet worden weergegeven. De standaardwaarde is True.
Retouren
Het DataReference-exemplaar voor het doelpad dat is geüpload.
Retourtype
upload_files
Upload de gegevens van het lokale bestandssysteem naar de blobcontainer waarnaar deze gegevensopslag verwijst.
Opmerking: deze methode is afgeschaft en wordt niet meer ondersteund. In plaats daarvan wordt aanbevolen om te gebruiken FileDatasetFactory.upload_directory .
upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)Parameters
- relative_root
- str, <xref:optional>
De hoofdmap die wordt gebruikt om het pad van de bestanden in de blob te bepalen. Als we bijvoorbeeld /path/to/file.txt uploaden en we het basispad definiëren als /path, wanneer file.txt wordt geüpload naar de blobopslag, heeft deze het pad naar /naar/file.txt. Als target_path ook wordt opgegeven, wordt deze gebruikt als voorvoegsel voor het afgeleide pad van hierboven. Het basispad moet een gemeenschappelijk pad van alle bestanden zijn, anders wordt er een uitzondering gegenereerd. De standaardinstelling is Geen, waarmee het algemene pad wordt gevonden.
- target_path
- str, <xref:optional>
De locatie in de blobcontainer waarnaar de gegevens moeten worden geüpload. De standaardinstelling is Geen, de hoofdmap.
- overwrite
- bool, <xref:optional>
Geeft aan of bestaande bestanden moeten worden overschreven. Standaard ingesteld op False.
- show_progress
- bool, <xref:optional>
Geeft aan of de voortgang van het uploaden in de console moet worden weergegeven. De standaardwaarde is True.
Retouren
Het DataReference-exemplaar voor het doelpad dat is geüpload.
Retourtype
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor