Share via


AzureFileDatastore Classe

Rappresenta un archivio dati che salva le informazioni di connessione in Archiviazione file di Azure.

Non è consigliabile usare direttamente questa classe. Per creare un archivio dati di questo tipo, usare il metodo dell'archivio register_azure_file_share dati.

Nota: quando si usa un archivio dati per accedere ai dati, è necessario disporre dell'autorizzazione per accedere a tali dati, che dipende dalle credenziali registrate nell'archivio dati.

Inizializzare un nuovo archivio dati di Condivisione file di Azure.

Ereditarietà
AzureFileDatastore

Costruttore

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

Parametri

workspace
Workspace
Necessario

L'area di lavoro a cui appartiene questo archivio dati.

name
str
Necessario

Nome dell'archivio dati. Può contenere solo caratteri alfanumerici o - o _.

container_name
str
Necessario

Nome della condivisione file

account_name
str
Necessario

Il nome dell'account di archiviazione

sas_token
str, <xref:optional>
valore predefinito: None

Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è none.

account_key
str, <xref:optional>
valore predefinito: None

Chiave dell'account di archiviazione. Il valore predefinito è none.

protocol
str, <xref:optional>
valore predefinito: None

Protocollo da usare per connettersi all'account di archiviazione. Se Nessuno, per impostazione predefinita è https.

endpoint
str, <xref:optional>
valore predefinito: core.windows.net

Endpoint del contenitore BLOB. Se Nessuno, per impostazione predefinita viene core.windows.net.

request_session
<xref:requests.sessions.Session>, <xref:optional>
valore predefinito: None

Oggetto sessione da utilizzare per le richieste HTTP. Il valore predefinito è none.

workspace
Workspace
Necessario

L'area di lavoro a cui appartiene questo archivio dati.

name
str
Necessario

Nome dell'archivio dati. Può contenere solo caratteri alfanumerici o - o _.

container_name
str
Necessario

Nome della condivisione file

account_name
str
Necessario

Il nome dell'account di archiviazione

sas_token
str, <xref:optional>
Necessario

Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è none.

account_key
str, <xref:optional>
Necessario

Chiave dell'account di archiviazione. Il valore predefinito è none.

protocol
str, <xref:optional>
Necessario

Protocollo da usare per connettersi all'account di archiviazione. Se Nessuno, per impostazione predefinita è https.

endpoint
str, <xref:optional>
Necessario

Endpoint del contenitore BLOB. Se Nessuno, per impostazione predefinita viene core.windows.net.

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

Oggetto sessione da utilizzare per le richieste HTTP. Il valore predefinito è none.

Metodi

download

Scaricare i dati dalla condivisione file al file system locale.

upload

Caricare i dati dal file system locale nella condivisione file a cui punta questo archivio dati.

Nota: per il corretto funzionamento di questo metodo, l'oggetto archivio dati deve avere la chiave dell'account o la proprietà del token di firma di accesso condiviso popolata. Se l'oggetto archivio dati non contiene alcuna forma di credenziale, questo metodo avrà esito negativo. Inoltre, questo metodo è stato deprecato, potrebbe essere rimosso in futuro. È consigliabile usare il Dataset.File.upload_directory metodo per caricare i file dalla directory locale e creare FileDataset in una singola chiamata al metodo.

upload_files

Caricare i dati dal file system locale nella condivisione file a cui punta questo archivio dati.

Nota: questo metodo è deprecato e non sarà più supportato. È consigliabile usare FileDatasetFactory.upload_directory invece .

download

Scaricare i dati dalla condivisione file al file system locale.

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

Parametri

target_path
str
Necessario

Directory locale in cui scaricare il file.

prefix
str, <xref:optional>
valore predefinito: None

Percorso della cartella nella condivisione file da scaricare. Se impostato su Nessuno, Azure Machine Learning scaricherà tutti gli elementi nella condivisione file.

overwrite
bool, <xref:optional>
valore predefinito: False

Indica se sovrascrivere il file esistente.

show_progress
bool, <xref:optional>
valore predefinito: True

Indica se visualizzare lo stato di avanzamento del download nella console.

Restituisce

Numero di file scaricati correttamente.

Tipo restituito

int

upload

Caricare i dati dal file system locale nella condivisione file a cui punta questo archivio dati.

Nota: per il corretto funzionamento di questo metodo, l'oggetto archivio dati deve avere la chiave dell'account o la proprietà del token di firma di accesso condiviso popolata. Se l'oggetto archivio dati non contiene alcuna forma di credenziale, questo metodo avrà esito negativo. Inoltre, questo metodo è stato deprecato, potrebbe essere rimosso in futuro. È consigliabile usare il Dataset.File.upload_directory metodo per caricare i file dalla directory locale e creare FileDataset in una singola chiamata al metodo.

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

Parametri

src_dir
str
Necessario

Directory locale da caricare.

target_path
str
Necessario

Percorso nella condivisione file in cui eseguire il caricamento. Se Nessuno viene caricato nella radice.

overwrite
bool, <xref:optional>
Necessario

Indica se sovrascrivere i file esistenti.

show_progress
bool, <xref:optional>
Necessario

Indica se visualizzare lo stato di avanzamento del caricamento nella console.

Restituisce

Istanza di DataReference per il percorso di destinazione caricato.

Tipo restituito

upload_files

Caricare i dati dal file system locale nella condivisione file a cui punta questo archivio dati.

Nota: questo metodo è deprecato e non sarà più supportato. È consigliabile usare FileDatasetFactory.upload_directory invece .

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

Parametri

files
list[str]
Necessario

Elenco di percorso assoluto dei file da caricare.

relative_root
str, <xref:optional>
Necessario

Percorso di base utilizzato per determinare il percorso dei file nella condivisione file. Ad esempio, se si carica /path/to/file.txt e si definisce il percorso di base come /path, quando file.txt viene caricato nella condivisione file, avrà il percorso di /to/file.txt. Se target_path viene specificato anche , verrà usato come prefisso per il percorso derivato precedente. Il percorso di base deve essere un percorso comune di tutti i file. In caso contrario, verrà generata un'eccezione. Il valore predefinito è Nessuno, che troverà il percorso comune.

target_path
str, <xref:optional>
Necessario

Percorso nella condivisione file in cui caricare i dati. Il valore predefinito è Nessuno, la radice.

overwrite
bool, <xref:optional>
Necessario

Indica se sovrascrivere i file esistenti.

show_progress
bool, <xref:optional>
Necessario

Indica se visualizzare lo stato di avanzamento del caricamento nella console.

Restituisce

Istanza di DataReference per il percorso di destinazione caricato.

Tipo restituito