AzureFileDatastore Osztály

Olyan adattárat jelöl, amely menti a kapcsolati adatokat az Azure File Storage-ba.

Nem szabad közvetlenül ezzel az osztálysal dolgoznia. Ilyen típusú adattár létrehozásához használja az register_azure_file_share Adattár metódust.

Megjegyzés: Ha adattárat használ az adatok eléréséhez, az adatokhoz való hozzáféréshez engedéllyel kell rendelkeznie, amely az adattárban regisztrált hitelesítő adatoktól függ.

Inicializáljon egy új Azure-fájlmegosztási adattárat.

Öröklődés
AzureFileDatastore

Konstruktor

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

Paraméterek

workspace
Workspace
Kötelező

Az adattárhoz tartozó munkaterület.

name
str
Kötelező

Az adattár neve. Csak alfanumerikus karaktereket vagy - vagy _karaktert tartalmazhat.

container_name
str
Kötelező

A fájlmegosztás neve

account_name
str
Kötelező

A tárfiók neve

sas_token
str, <xref:optional>
alapértelmezett érték: None

A tároló elérésére szolgáló SAS-jogkivonat. Az alapértelmezett érték a Nincs.

account_key
str, <xref:optional>
alapértelmezett érték: None

A tárfiókkulcs. Az alapértelmezett érték a Nincs.

protocol
str, <xref:optional>
alapértelmezett érték: None

A tárfiókhoz való csatlakozáshoz használandó protokoll. Ha nincs, alapértelmezés szerint https.

endpoint
str, <xref:optional>
alapértelmezett érték: core.windows.net

A blobtároló végpontja. Ha nincs, alapértelmezés szerint core.windows.net.

request_session
<xref:requests.sessions.Session>, <xref:optional>
alapértelmezett érték: None

A http-kérelmekhez használandó munkamenet-objektum. Az alapértelmezett érték a Nincs.

workspace
Workspace
Kötelező

Az adattárhoz tartozó munkaterület.

name
str
Kötelező

Az adattár neve. Csak alfanumerikus karaktereket vagy - vagy _karaktert tartalmazhat.

container_name
str
Kötelező

A fájlmegosztás neve

account_name
str
Kötelező

A tárfiók neve

sas_token
str, <xref:optional>
Kötelező

A tároló elérésére szolgáló SAS-jogkivonat. Az alapértelmezett érték a Nincs.

account_key
str, <xref:optional>
Kötelező

A tárfiókkulcs. Az alapértelmezett érték a Nincs.

protocol
str, <xref:optional>
Kötelező

A tárfiókhoz való csatlakozáshoz használandó protokoll. Ha nincs, alapértelmezés szerint https.

endpoint
str, <xref:optional>
Kötelező

A blobtároló végpontja. Ha nincs, alapértelmezés szerint core.windows.net.

request_session
<xref:requests.sessions.Session>, <xref:optional>
Kötelező

A http-kérelmekhez használandó munkamenet-objektum. Az alapértelmezett érték a Nincs.

Metódusok

download

Töltse le az adatokat a fájlmegosztásból a helyi fájlrendszerbe.

upload

Töltse fel az adatokat a helyi fájlrendszerből arra a fájlra, amelyre ez az adattár mutat.

Megjegyzés: Ahhoz, hogy ez a módszer működjön, az adattár-objektumnak fiókkulcsot vagy SAS-jogkivonat-tulajdonságot kell tartalmaznia. Ha az adattárobjektum nem tartalmaz hitelesítő adatokat, ez a metódus sikertelen lesz. Emellett ez a módszer elavult, a jövőben eltávolítható. Javasoljuk, hogy a metódussal töltse fel a Dataset.File.upload_directory fájlokat a helyi könyvtárból, és hozza létre a FileDatasetet egyetlen metódushívásban.

upload_files

Töltse fel az adatokat a helyi fájlrendszerből arra a fájlra, amelyre ez az adattár mutat.

Megjegyzés: Ez a módszer elavult, és a továbbiakban nem támogatott. Javasoljuk, hogy inkább használja FileDatasetFactory.upload_directory .

download

Töltse le az adatokat a fájlmegosztásból a helyi fájlrendszerbe.

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

Paraméterek

target_path
str
Kötelező

A fájl letöltéséhez a helyi könyvtár.

prefix
str, <xref:optional>
alapértelmezett érték: None

A letöltéshez a fájlmegosztás mappájának elérési útja. Ha a Nincs értékre van állítva, az Azure Machine Learning mindent letölt a fájlmegosztásból.

overwrite
bool, <xref:optional>
alapértelmezett érték: False

Azt jelzi, hogy felülírja-e a meglévő fájlt.

show_progress
bool, <xref:optional>
alapértelmezett érték: True

Azt jelzi, hogy meg szeretné-e jeleníteni a letöltés állapotát a konzolon.

Válaszok

A sikeresen letöltött fájlok száma.

Visszatérési típus

int

upload

Töltse fel az adatokat a helyi fájlrendszerből arra a fájlra, amelyre ez az adattár mutat.

Megjegyzés: Ahhoz, hogy ez a módszer működjön, az adattár-objektumnak fiókkulcsot vagy SAS-jogkivonat-tulajdonságot kell tartalmaznia. Ha az adattárobjektum nem tartalmaz hitelesítő adatokat, ez a metódus sikertelen lesz. Emellett ez a módszer elavult, a jövőben eltávolítható. Javasoljuk, hogy a metódussal töltse fel a Dataset.File.upload_directory fájlokat a helyi könyvtárból, és hozza létre a FileDatasetet egyetlen metódushívásban.

upload(src_dir, target_path=None, overwrite=False, show_progress=True)

Paraméterek

src_dir
str
Kötelező

A feltöltendő helyi könyvtár.

target_path
str
Kötelező

A fájlmegosztás azon helye, ahová fel szeretne tölteni. Ha nincs, akkor töltse fel a gyökérkönyvtárba.

overwrite
bool, <xref:optional>
Kötelező

Azt jelzi, hogy felülírja-e a meglévő fájlokat.

show_progress
bool, <xref:optional>
Kötelező

Azt jelzi, hogy meg szeretné-e jeleníteni a feltöltés állapotát a konzolon.

Válaszok

A feltöltött célútvonal DataReference-példánya.

Visszatérési típus

upload_files

Töltse fel az adatokat a helyi fájlrendszerből arra a fájlra, amelyre ez az adattár mutat.

Megjegyzés: Ez a módszer elavult, és a továbbiakban nem támogatott. Javasoljuk, hogy inkább használja FileDatasetFactory.upload_directory .

upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)

Paraméterek

files
list[str]
Kötelező

A feltöltendő fájlok abszolút elérési útjának listája.

relative_root
str, <xref:optional>
Kötelező

A fájlmegosztásban lévő fájlok elérési útjának meghatározásához használt alap elérési út. Ha például feltölti az /path/to/file.txt fájlt, és az alapelérési utat /elérési útként határozza meg, file.txt a fájlmegosztásba való feltöltéskor a /to/file.txt elérési útja lesz. Ha target_path az is meg van adva, akkor azt fogja használni a fentről származtatott elérési út előtagjaként. Az alapelérési útnak az összes fájl közös elérési útjának kell lennie, különben kivétel lesz kivetni. Az alapértelmezett érték a Nincs, amely megtalálja a közös útvonalat.

target_path
str, <xref:optional>
Kötelező

A fájlmegosztás azon helye, ahová feltöltheti az adatokat. Az alapértelmezett érték a Nincs, a gyökér.

overwrite
bool, <xref:optional>
Kötelező

Azt jelzi, hogy felülírja-e a meglévő fájlokat.

show_progress
bool, <xref:optional>
Kötelező

Azt jelzi, hogy meg szeretné-e jeleníteni a feltöltés állapotát a konzolon.

Válaszok

A feltöltött célútvonal DataReference-példánya.

Visszatérési típus