AzureFileDatastore Klasse

Stellt einen Datenspeicher dar, der Verbindungsinformationen in Azure Files speichert.

Sie sollten nicht direkt mit dieser Klasse arbeiten. Verwenden Sie die register_azure_file_share-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-Dateifreigabe-Datenspeicher.

Vererbung

AbstractAzureStorageDatastore

AzureFileDatastore

Konstruktor

AzureFileDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint='core.windows.net', request_session=None)

Parameter

workspace

Workspace

Erforderlich

Der Arbeitsbereich, zu dem dieser Datenspeicher gehört.

name

str

Erforderlich

Der Name des Datenspeichers. Darf nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) enthalten.

container_name

str

Erforderlich

Der Name der Dateifreigabe

account_name

str

Erforderlich

Speicherkontoname

sas_token

str, <xref:optional>

Standardwert: None

Das SAS-Token für den Zugriff auf diesen Container. Der Standardwert ist „None“.

account_key

str, <xref:optional>

Standardwert: None

Der Speicherkontoschlüssel. Der Standardwert ist „None“.

protocol

str, <xref:optional>

Standardwert: None

Das Protokoll, das zum Herstellen einer Verbindung mit dem Speicherkonto verwendet werden soll. Bei „None“ wird standardmäßig HTTPS verwendet.

endpoint

str, <xref:optional>

Standardwert: core.windows.net

Der Endpunkt des Blobcontainers. Bei „None“ wird standardmäßig „core.windows.net“ verwendet.

request_session

<xref:requests.sessions.Session>, <xref:optional>

Standardwert: None

Das Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll. Der Standardwert ist „None“.

workspace

Workspace

Erforderlich

Der Arbeitsbereich, zu dem dieser Datenspeicher gehört.

name

str

Erforderlich

Der Name des Datenspeichers. Darf nur alphanumerische Zeichen, Bindestriche (-) und Unterstriche (_) enthalten.

container_name

str

Erforderlich

Der Name der Dateifreigabe

account_name

str

Erforderlich

Speicherkontoname

sas_token

str, <xref:optional>

Erforderlich

Das SAS-Token für den Zugriff auf diesen Container. Der Standardwert ist „None“.

account_key

str, <xref:optional>

Erforderlich

Der Speicherkontoschlüssel. Der Standardwert ist „None“.

protocol

str, <xref:optional>

Erforderlich

Das Protokoll, das zum Herstellen einer Verbindung mit dem Speicherkonto verwendet werden soll. Bei „None“ wird standardmäßig HTTPS verwendet.

endpoint

str, <xref:optional>

Erforderlich

Der Endpunkt des Blobcontainers. Bei „None“ wird standardmäßig „core.windows.net“ verwendet.

request_session

<xref:requests.sessions.Session>, <xref:optional>

Erforderlich

Das Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll. Der Standardwert ist „None“.

Methoden

download	Laden Sie die Daten aus der Dateifreigabe in das lokale Dateisystem herunter.
upload	Hochladen der Daten aus dem lokalen Dateisystem in die Dateifreigabe, auf die dieser Datenspeicher verweist. Hinweis: Damit diese Methode funktioniert, muss für das Datastore-Objekt die Kontoschlüssel- oder SAS-Token-Eigenschaft 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_files	Hochladen der Daten aus dem lokalen Dateisystem in die Dateifreigabe, auf die dieser Datenspeicher verweist. Hinweis: Diese Methode ist veraltet und wird nicht mehr unterstützt. Es wird empfohlen, stattdessen FileDatasetFactory.upload_directory zu verwenden.

download

Laden Sie die Daten aus der Dateifreigabe in das lokale Dateisystem herunter.

download(target_path, prefix=None, overwrite=False, show_progress=True)

Parameter

target_path

str

Erforderlich

Das lokale Verzeichnis, in das die Datei heruntergeladen werden soll.

prefix

str, <xref:optional>

Standardwert: None

Pfad zum Ordner in der Dateifreigabe, der heruntergeladen werden soll. Wenn diese Einstellung auf „None“ festgelegt ist, lädt Azure Machine Learning alles in der Dateifreigabe herunter.

overwrite

bool, <xref:optional>

Standardwert: False

Gibt an, ob vorhandene Dateien überschrieben werden sollen.

show_progress

bool, <xref:optional>

Standardwert: True

Gibt an, ob der Fortschritt des Downloads in der Konsole angezeigt werden soll.

Gibt zurück

Die Anzahl der erfolgreich heruntergeladenen Dateien.

Rückgabetyp

int

upload

Hochladen der Daten aus dem lokalen Dateisystem in die Dateifreigabe, auf die dieser Datenspeicher verweist.

Hinweis: Damit diese Methode funktioniert, muss für das Datastore-Objekt die Kontoschlüssel- oder SAS-Token-Eigenschaft 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

src_dir

str

Erforderlich

Das lokale Verzeichnis, das hochgeladen werden soll.

target_path

str

Erforderlich

Der Speicherort in der Dateifreigabe, in den hochgeladen werden soll. Wenn „None“ festgelegt ist, wird in das Stammverzeichnis hochgeladen.

overwrite

bool, <xref:optional>

Erforderlich

Gibt an, ob vorhandene Dateien überschrieben werden sollen.

show_progress

bool, <xref:optional>

Erforderlich

Gibt an, ob der Fortschritt des Uploads in der Konsole angezeigt werden soll.

Gibt zurück

Die DataReference-Instanz für den hochgeladenen Zielpfad.

Rückgabetyp

DataReference

upload_files

Hochladen der Daten aus dem lokalen Dateisystem in die Dateifreigabe, auf die 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

files

list[str]

Erforderlich

Eine Liste absoluter Pfade der hochzuladenden Dateien.

relative_root

str, <xref:optional>

Erforderlich

Der Basispfad, mit dem der Pfad der Dateien in der Dateifreigabe bestimmt wird. Wenn Sie beispielsweise „/path/to/file.txt“ hochladen und „/path“ als Basispfad definieren, hat „file.txt“ beim Upload in die Dateifreigabe den Pfad „/to/file.txt“. 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 gemeinsame Pfad gefunden wird.

target_path

str, <xref:optional>

Erforderlich

Der Speicherort in der Dateifreigabe, in den die Daten hochgeladen werden sollen. Der Standardwert ist „None“, das Stammverzeichnis.

overwrite

bool, <xref:optional>

Erforderlich

Gibt an, ob vorhandene Dateien überschrieben werden sollen.

show_progress

bool, <xref:optional>

Erforderlich

Gibt an, ob der Fortschritt des Uploads in der Konsole angezeigt werden soll.

Gibt zurück

Die DataReference-Instanz für den hochgeladenen Zielpfad.

Rückgabetyp

DataReference