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
- sas_token
- str, <xref:optional>
Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è none.
- account_key
- str, <xref:optional>
Chiave dell'account di archiviazione. Il valore predefinito è none.
- protocol
- str, <xref:optional>
Protocollo da usare per connettersi all'account di archiviazione. Se Nessuno, per impostazione predefinita è https.
- endpoint
- str, <xref:optional>
Endpoint del contenitore BLOB. Se Nessuno, per impostazione predefinita viene core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
Oggetto sessione da utilizzare per le richieste HTTP. Il valore predefinito è none.
- sas_token
- str, <xref:optional>
Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è none.
- account_key
- str, <xref:optional>
Chiave dell'account di archiviazione. Il valore predefinito è none.
- protocol
- str, <xref:optional>
Protocollo da usare per connettersi all'account di archiviazione. Se Nessuno, per impostazione predefinita è https.
- endpoint
- str, <xref:optional>
Endpoint del contenitore BLOB. Se Nessuno, per impostazione predefinita viene core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
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 |
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 |
download
Scaricare i dati dalla condivisione file al file system locale.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Parametri
- prefix
- str, <xref:optional>
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>
Indica se sovrascrivere il file esistente.
- show_progress
- bool, <xref:optional>
Indica se visualizzare lo stato di avanzamento del download nella console.
Restituisce
Numero di file scaricati correttamente.
Tipo restituito
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
- target_path
- str
Percorso nella condivisione file in cui eseguire il caricamento. Se Nessuno viene caricato nella radice.
- show_progress
- bool, <xref:optional>
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
- relative_root
- str, <xref:optional>
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>
Percorso nella condivisione file in cui caricare i dati. Il valore predefinito è Nessuno, la radice.
- show_progress
- bool, <xref:optional>
Indica se visualizzare lo stato di avanzamento del caricamento nella console.
Restituisce
Istanza di DataReference per il percorso di destinazione caricato.
Tipo restituito
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per