AzureBlobDatastore Classe
Rappresenta un archivio dati che salva le informazioni di connessione nell'archivio BLOB di Azure.
Non è consigliabile usare direttamente questa classe. Per creare un archivio dati di questo tipo, usare il metodo dell'archivio register_azure_blob_container 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 BLOB di Azure.
- Ereditarietà
-
AzureBlobDatastore
Costruttore
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)
Parametri
- sas_token
- str, <xref:optional>
Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è Nessuno.
- account_key
- str, <xref:optional>
Chiave dell'account di archiviazione. Il valore predefinito è Nessuno.
- 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.Session>, <xref:optional>
oggetto sessione da utilizzare per le richieste HTTP. Il valore predefinito è Nessuno.
- sas_token
- str, <xref:optional>
Token di firma di accesso condiviso per l'accesso a questo contenitore. Il valore predefinito è Nessuno.
- account_key
- str, <xref:optional>
Chiave dell'account di archiviazione. Il valore predefinito è Nessuno.
- 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.Session>, <xref:optional>
Oggetto sessione da utilizzare per le richieste HTTP. Il valore predefinito è Nessuno.
- workspace_msi_has_access
- bool, <xref:optional>
Indica se l'identità del servizio gestito dell'area di lavoro ha accesso a questo account di archiviazione. (Deprecato)
- subscription_id
- str, <xref:optional>
ID sottoscrizione dell'account di archiviazione.
- resource_group
- str, <xref:optional>
Gruppo di risorse dell'account di archiviazione.
- service_data_access_auth_identity
- str oppure <xref:_restclient.models.ServiceDataAccessAuthIdentity>
Indica l'identità da usare per autenticare l'accesso ai dati del servizio alla risorsa di archiviazione del cliente. I valori possibili includono: 'None', 'WorkspaceSystemAssignedIdentity', 'WorkspaceUserAssignedIdentity'
Metodi
download |
Scaricare i dati dal contenitore BLOB nel file system locale. |
upload |
Caricare i dati dal file system locale nel contenitore BLOB in 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 nel contenitore BLOB in cui punta questo archivio dati. Nota: questo metodo è deprecato e non sarà più supportato. È consigliabile usare |
download
Scaricare i dati dal contenitore BLOB nel file system locale.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Parametri
- prefix
- str, <xref:optional>
Percorso della cartella nel contenitore BLOB da scaricare. Se impostato su Nessuno, scaricherà tutti gli elementi nel BLOB. Il valore predefinito è Nessuno.
- overwrite
- bool, <xref:optional>
Indica se sovrascrivere i file esistenti. Il valore predefinito è False.
- show_progress
- bool, <xref:optional>
Indica se visualizzare lo stato di avanzamento del download nella console. Il valore predefinito è True.
Restituisce
Numero di file scaricati correttamente.
Tipo restituito
upload
Caricare i dati dal file system locale nel contenitore BLOB in 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
Posizione nel contenitore BLOB in cui eseguire il caricamento. Se Nessuno, caricare nella radice. Il valore predefinito è Nessuno.
- overwrite
- bool, <xref:optional>
Indica se sovrascrivere i file esistenti. Il valore predefinito è False.
- show_progress
- bool, <xref:optional>
Indica se visualizzare lo stato di avanzamento del caricamento nella console. Il valore predefinito è True.
Restituisce
Istanza di DataReference per il percorso di destinazione caricato.
Tipo restituito
upload_files
Caricare i dati dal file system locale nel contenitore BLOB in 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>
Radice usata per determinare il percorso dei file nel BLOB. Ad esempio, se si carica /path/to/file.txt e si definisce il percorso di base come /path, quando file.txt viene caricato nell'archivio BLOB, avrà il percorso di /to/file.txt. Se viene specificato anche target_path, verrà usato come prefisso per il percorso derivato da precedenza. 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>
Posizione nel contenitore BLOB in cui caricare i dati. Il valore predefinito è Nessuno, la radice.
- overwrite
- bool, <xref:optional>
Indica se sovrascrivere i file esistenti. Il valore predefinito è False.
- show_progress
- bool, <xref:optional>
Indica se visualizzare lo stato di avanzamento del caricamento nella console. Il valore predefinito è True.
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