AzureBlobDatastore Klasse
Stellt einen Datenspeicher dar, der Verbindungsinformationen in Azure Blob Storage speichert
Sie sollten nicht direkt mit dieser Klasse arbeiten. Verwenden Sie die register_azure_blob_container-Methode von „Datastore“, um einen Datenspeicher dieses Typs zu erstellen.
Hinweis: Wenn Sie einen Datenspeicher für den Zugriff auf Daten verwenden, müssen Sie über die Berechtigung für den Zugriff auf diese Daten verfügen. Dies hängt von den Anmeldeinformationen ab, die beim Datenspeicher registriert sind.
Initialisieren Sie einen neuen Azure Blob Datastore.
- Vererbung
-
AzureBlobDatastore
Konstruktor
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)
Parameter
- name
- str
Der Name des Datenspeichers. Er darf nur alphanumerische Zeichen, „-“ oder „_“ enthalten.
- sas_token
- str, <xref:optional>
SAS-Token für den Zugriff auf diesen Container. Der Standardwert ist „None“.
- account_key
- str, <xref:optional>
Der Speicherkontoschlüssel. Der Standardwert ist „None“.
- protocol
- str, <xref:optional>
Protokoll, das zum Herstellen einer Verbindung mit dem Speicherkonto verwendet werden soll. Bei „None“ wird standardmäßig HTTPS verwendet.
- endpoint
- str, <xref:optional>
Der Endpunkt des Blobcontainers. Bei fehlender Angabe wird „core.windows.net“ verwendet.
- request_session
- <xref:requests.Session>, <xref:optional>
Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll. Der Standardwert ist „None“.
- name
- str
Der Name des Datenspeichers. Er darf nur alphanumerische Zeichen, „-“ oder „_“ enthalten.
- sas_token
- str, <xref:optional>
SAS-Token für den Zugriff auf diesen Container. Der Standardwert ist „None“.
- account_key
- str, <xref:optional>
Der Speicherkontoschlüssel. Der Standardwert ist „None“.
- protocol
- str, <xref:optional>
Protokoll, das zum Herstellen einer Verbindung mit dem Speicherkonto verwendet werden soll. Bei „None“ wird standardmäßig HTTPS verwendet.
- endpoint
- str, <xref:optional>
Der Endpunkt des Blobcontainers. Bei „None“ wird standardmäßig „core.windows.net“ verwendet.
- request_session
- <xref:requests.Session>, <xref:optional>
Das Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll. Der Standardwert ist „None“.
- workspace_msi_has_access
- bool, <xref:optional>
Gibt an, ob die Arbeitsbereichs-MSI Zugriff auf dieses Speicherkonto hat. (veraltet)
- service_data_access_auth_identity
- str oder <xref:_restclient.models.ServiceDataAccessAuthIdentity>
Gibt an, welche Identität für die Authentifizierung des Zugriffs auf die Dienstdaten im Speicher des Kunden verwendet werden soll. Mögliche Werte: „None“, „WorkspaceSystemAssignedIdentity“, „WorkspaceUserAssignedIdentity“
Methoden
download |
Lädt die Daten aus dem Blobcontainer in das lokale Dateisystem herunter. |
upload |
Lädt die Daten aus dem lokalen Dateisystem in einen Blobcontainer hoch, auf den dieser Datenspeicher verweist Hinweis: Damit diese Methode funktioniert, muss für das Datenspeicherobjekt die Kontoschlüssel- oder SAS-Tokeneigenschaft aufgefüllt sein. Wenn das Datenspeicherobjekt keine Anmeldeinformationen enthält, schlägt diese Methode fehl.
Diese Methode ist zudem veraltet und wird in Zukunft möglicherweise entfernt. Es wird empfohlen, die |
upload_files |
Lädt die Daten aus dem lokalen Dateisystem in den Blobcontainer hoch, auf den dieser Datenspeicher verweist Hinweis: Diese Methode ist veraltet und wird nicht mehr unterstützt. Es wird empfohlen, stattdessen |
download
Lädt die Daten aus dem Blobcontainer in das lokale Dateisystem herunter.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Parameter
- prefix
- str, <xref:optional>
Pfad zum Ordner im Blobcontainer, der heruntergeladen werden soll. Wenn „None“ festgelegt ist, wird alles im Blob heruntergeladen. Der Standardwert ist „None“.
- overwrite
- bool, <xref:optional>
Gibt an, ob vorhandene Dateien überschrieben werden. Der Standardwert lautet „False“.
- show_progress
- bool, <xref:optional>
Gibt an, ob der Fortschritt des Downloads in der Konsole angezeigt werden soll. Der Standardwert ist „True“.
Gibt zurück
Anzahl der erfolgreich heruntergeladenen Dateien.
Rückgabetyp
upload
Lädt die Daten aus dem lokalen Dateisystem in einen Blobcontainer hoch, auf den dieser Datenspeicher verweist
Hinweis: Damit diese Methode funktioniert, muss für das Datenspeicherobjekt die Kontoschlüssel- oder SAS-Tokeneigenschaft aufgefüllt sein. Wenn das Datenspeicherobjekt keine Anmeldeinformationen enthält, schlägt diese Methode fehl.
Diese Methode ist zudem veraltet und wird in Zukunft möglicherweise entfernt. Es wird empfohlen, die Dataset.File.upload_directory
-Methode zu verwenden, um Ihre Dateien aus dem lokalen Verzeichnis hochzuladen und das Dateidataset (FileDataset) in einem einzigen Methodenaufruf zu erstellen.
upload(src_dir, target_path=None, overwrite=False, show_progress=True)
Parameter
- target_path
- str
Der Speicherort im Blobcontainer, in den hochgeladen werden soll. Wenn „None“ festgelegt ist, wird in den Stamm hochgeladen. Der Standardwert ist „None“.
- overwrite
- bool, <xref:optional>
Gibt an, ob vorhandene Dateien überschrieben werden. Der Standardwert lautet „False“.
- show_progress
- bool, <xref:optional>
Gibt an, ob der Fortschritt des Uploads in der Konsole angezeigt werden soll. Der Standardwert ist „True“.
Gibt zurück
DataReference-Instanz für den hochgeladenen Zielpfad
Rückgabetyp
upload_files
Lädt die Daten aus dem lokalen Dateisystem in den Blobcontainer hoch, auf den dieser Datenspeicher verweist
Hinweis: Diese Methode ist veraltet und wird nicht mehr unterstützt. Es wird empfohlen, stattdessen FileDatasetFactory.upload_directory
zu verwenden.
upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)
Parameter
- relative_root
- str, <xref:optional>
Stamm, mit dem der Pfad der Dateien im Blob bestimmt wird. Wenn Sie beispielsweise „/path/to/file.txt“ hochladen und „/path“ als Basispfad definieren, weist „file.txt“ beim Upload in den Blobspeicher den Pfad von „/to/file.txt“ auf. Wenn „target_path“ ebenfalls angegeben ist, wird diese Komponente als Präfix für den zuvor erwähnten, abgeleiteten Pfad verwendet. Der Basispfad muss ein gemeinsamer Pfad aller Dateien sein. Andernfalls wird eine Ausnahme ausgelöst. Der Standardwert ist „None“, wodurch der allgemeine Pfad gefunden wird.
- target_path
- str, <xref:optional>
Speicherort im Blobcontainer, in den die Daten hochgeladen werden. Der Standardwert ist „None“ (Stamm).
- overwrite
- bool, <xref:optional>
Gibt an, ob vorhandene Dateien überschrieben werden. Der Standardwert lautet „False“.
- show_progress
- bool, <xref:optional>
Gibt an, ob der Fortschritt des Uploads in der Konsole angezeigt werden soll. Der Standardwert ist „True“.
Gibt zurück
DataReference-Instanz für den hochgeladenen Zielpfad
Rückgabetyp
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für