Dela via

AzureBlobDatastore Klass

  • Referens

Representerar ett datalager som sparar anslutningsinformation till Azure Blob Storage.

Du bör inte arbeta med den här klassen direkt. Om du vill skapa ett datalager av den här typen använder du register_azure_blob_container metoden Datastore.

Obs! När du använder ett datalager för att komma åt data måste du ha behörighet att komma åt dessa data, vilket beror på de autentiseringsuppgifter som registrerats med datalagringen.

Initiera ett nytt Azure Blob Datastore.

Arv
AbstractAzureStorageDatastore
AzureBlobDatastore

Konstruktor

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)

Parametrar

workspace
Workspace
Obligatorisk

Arbetsytan som det här dataarkivet tillhör.

name
str
Obligatorisk

Namnet på dataarkivet. Den kan bara innehålla alfanumeriska tecken eller - eller _.

container_name
str
Obligatorisk

Namnet på blobcontainern.

account_name
str
Obligatorisk

Namnet på lagringskontot.

sas_token
str, <xref:optional>
standardvärde: None

SAS-token för åtkomst till den här containern. Standardvärdet är Ingen.

account_key
str, <xref:optional>
standardvärde: None

Nyckeln till lagringskontot. Standardvärdet är Ingen.

protocol
str, <xref:optional>
standardvärde: None

Protokollet som ska användas för att ansluta till lagringskontot. Om ingen är standard https.

endpoint
str, <xref:optional>
standardvärde: None

Slutpunkten för blobcontainern. Om ingen är standard core.windows.net.

request_session
<xref:requests.Session>, <xref:optional>
standardvärde: None

sessionsobjektet som ska användas för http-begäranden. Standardvärdet är Ingen.

workspace
Workspace
Obligatorisk

Arbetsytan som det här dataarkivet tillhör.

name
str
Obligatorisk

Namnet på dataarkivet. Den kan bara innehålla alfanumeriska tecken eller - eller _.

container_name
str
Obligatorisk

Namnet på blobcontainern.

account_name
str
Obligatorisk

Namnet på lagringskontot.

sas_token
str, <xref:optional>
Obligatorisk

SAS-token för åtkomst till den här containern. Standardvärdet är Ingen.

account_key
str, <xref:optional>
Obligatorisk

Nyckeln till lagringskontot. Standardvärdet är Ingen.

protocol
str, <xref:optional>
Obligatorisk

Protokollet som ska användas för att ansluta till lagringskontot. Om ingen är standard https.

endpoint
str, <xref:optional>
Obligatorisk

Slutpunkten för blobcontainern. Om ingen är standard core.windows.net.

request_session
<xref:requests.Session>, <xref:optional>
Obligatorisk

Sessionsobjektet som ska användas för http-begäranden. Standardvärdet är Ingen.

workspace_msi_has_access
bool, <xref:optional>
standardvärde: False

Om arbetsytans MSI har åtkomst till det här lagringskontot. (Inaktuell)

subscription_id
str, <xref:optional>
standardvärde: None

Prenumerations-ID för lagringskontot.

resource_group
str, <xref:optional>
standardvärde: None

Lagringskontots resursgrupp.

service_data_access_auth_identity
str eller <xref:_restclient.models.ServiceDataAccessAuthIdentity>
standardvärde: None

Anger vilken identitet som ska användas för att autentisera tjänstdataåtkomst till kundens lagring. Möjliga värden är: "None", "WorkspaceSystemAssignedIdentity", "WorkspaceUserAssignedIdentity"

Metoder

download

Ladda ned data från blobcontainern till det lokala filsystemet.
upload

Ladda upp data från det lokala filsystemet till blobcontainern som datalagret pekar på.

Obs! För att den här metoden ska fungera måste datalagerobjektet ha antingen kontonyckeln eller SAS-tokenegenskapen ifylld. Om datalagerobjektet inte innehåller någon form av autentiseringsuppgifter misslyckas den här metoden. Dessutom har den här metoden blivit inaktuell, kan tas bort i framtiden. Vi föreslår att du använder Dataset.File.upload_directory metoden för att ladda upp filer från den lokala katalogen och skapa FileDataset i ett enda metodanrop.
upload_files

Ladda upp data från det lokala filsystemet till den blobcontainer som datalagringen pekar på.

Obs! Den här metoden är inaktuell och stöds inte längre. Rekommenderar att du använder FileDatasetFactory.upload_directory i stället.

download

Ladda ned data från blobcontainern till det lokala filsystemet.

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

Parametrar

target_path
str
Obligatorisk

Den lokala katalogen som filen ska laddas ned till.

prefix
str, <xref:optional>
standardvärde: None

Sökvägen till mappen i blobcontainern som ska laddas ned. Om värdet är Ingen laddas allt ned i bloben. Standardvärdet är Ingen.

overwrite
bool, <xref:optional>
standardvärde: False

Anger om befintliga filer ska skrivas över. Standardvärdet är Falskt.

show_progress
bool, <xref:optional>
standardvärde: True

Anger om förloppet för nedladdningen ska visas i konsolen. Standardvärdet är True.

Returer

Antalet filer som har laddats ned.

Returtyp

int

upload

Ladda upp data från det lokala filsystemet till blobcontainern som datalagret pekar på.

Obs! För att den här metoden ska fungera måste datalagerobjektet ha antingen kontonyckeln eller SAS-tokenegenskapen ifylld. Om datalagerobjektet inte innehåller någon form av autentiseringsuppgifter misslyckas den här metoden. Dessutom har den här metoden blivit inaktuell, kan tas bort i framtiden. Vi föreslår att du använder Dataset.File.upload_directory metoden för att ladda upp filer från den lokala katalogen och skapa FileDataset i ett enda metodanrop.

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

Parametrar

src_dir
str
Obligatorisk

Den lokala katalog som ska laddas upp.

target_path
str
Obligatorisk

Platsen i blobcontainern att ladda upp till. Om ingen laddas upp till roten. Standardvärdet är Ingen.

overwrite
bool, <xref:optional>
Obligatorisk

Anger om befintliga filer ska skrivas över. Standardvärdet är Falskt.

show_progress
bool, <xref:optional>
Obligatorisk

Anger om förloppet för uppladdningen ska visas i konsolen. Standardvärdet är True.

Returer

DataReference-instansen för målsökvägen som laddats upp.

Returtyp

DataReference

upload_files

Ladda upp data från det lokala filsystemet till den blobcontainer som datalagringen pekar på.

Obs! Den här metoden är inaktuell och stöds inte längre. Rekommenderar att du använder FileDatasetFactory.upload_directory i stället.

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

Parametrar

files
list[str]
Obligatorisk

En lista över absoluta sökvägar för filer som ska laddas upp.

relative_root
str, <xref:optional>
Obligatorisk

Roten som används för att fastställa sökvägen till filerna i bloben. Om vi till exempel laddar upp /path/to/file.txt och vi definierar bassökvägen till /path, när file.txt laddas upp till bloblagringen, har den sökvägen /till/file.txt. Om target_path också anges används det som prefix för den härledda sökvägen ovan. Bassökvägen måste vara en vanlig sökväg för alla filer, annars utlöses ett undantag. Standardvärdet är Ingen, som hittar den vanliga sökvägen.

target_path
str, <xref:optional>
Obligatorisk

Den plats i blobcontainern som data ska laddas upp till. Standardvärdet är Ingen, roten.

overwrite
bool, <xref:optional>
Obligatorisk

Anger om befintliga filer ska skrivas över. Standardvärdet är Falskt.

show_progress
bool, <xref:optional>
Obligatorisk

Anger om förloppet för uppladdningen ska visas i konsolen. Standardvärdet är True.

Returer

DataReference-instansen för målsökvägen som laddats upp.

Returtyp

DataReference