AzureBlobDatastore Třída

Představuje úložiště dat, které ukládá informace o připojení do úložiště objektů blob v Azure.

S touto třídou byste neměli pracovat přímo. Chcete-li vytvořit úložiště dat tohoto typu, použijte metodu register_azure_blob_container úložiště dat.

Poznámka: Pokud pro přístup k datům používáte úložiště dat, musíte mít oprávnění pro přístup k datům, což závisí na přihlašovacích údajích zaregistrovaných v úložišti dat.

Inicializujte nové úložiště dat objektů blob Azure.

Dědičnost

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)

Parametry

workspace

Workspace

Vyžadováno

Pracovní prostor, do který toto úložiště dat patří.

name

str

Vyžadováno

Název úložiště dat. Může obsahovat pouze alfanumerické znaky nebo - nebo _.

container_name

str

Vyžadováno

Název kontejneru objektů blob.

account_name

str

Vyžadováno

Název účtu úložiště.

sas_token

str, <xref:optional>

výchozí hodnota: None

Token SAS pro přístup k tomuto kontejneru. Výchozí hodnota je Žádná.

account_key

str, <xref:optional>

výchozí hodnota: None

Klíč účtu úložiště. Výchozí hodnota je Žádná.

protocol

str, <xref:optional>

výchozí hodnota: None

Protokol, který se použije pro připojení k účtu úložiště. Pokud žádný, výchozí hodnota je https.

endpoint

str, <xref:optional>

výchozí hodnota: None

Koncový bod kontejneru objektů blob. Pokud žádný, výchozí hodnota je core.windows.net.

request_session

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

výchozí hodnota: None

objekt relace, který se má použít pro požadavky HTTP. Výchozí hodnota je Žádná.

workspace

Workspace

Vyžadováno

Pracovní prostor, do který toto úložiště dat patří.

name

str

Vyžadováno

Název úložiště dat. Může obsahovat pouze alfanumerické znaky nebo - nebo _.

container_name

str

Vyžadováno

Název kontejneru objektů blob.

account_name

str

Vyžadováno

Název účtu úložiště.

sas_token

str, <xref:optional>

Vyžadováno

Token SAS pro přístup k tomuto kontejneru. Výchozí hodnota je Žádná.

account_key

str, <xref:optional>

Vyžadováno

Klíč účtu úložiště. Výchozí hodnota je Žádná.

protocol

str, <xref:optional>

Vyžadováno

Protokol, který se použije pro připojení k účtu úložiště. Pokud žádný, výchozí hodnota je https.

endpoint

str, <xref:optional>

Vyžadováno

Koncový bod kontejneru objektů blob. Pokud žádný, výchozí hodnota je core.windows.net.

request_session

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

Vyžadováno

Objekt relace, který se má použít pro požadavky HTTP. Výchozí hodnota je Žádná.

workspace_msi_has_access

bool, <xref:optional>

výchozí hodnota: False

Určuje, jestli má MSI pracovního prostoru přístup k tomuto účtu úložiště. (Zastaralé)

subscription_id

str, <xref:optional>

výchozí hodnota: None

ID předplatného účtu úložiště.

resource_group

str, <xref:optional>

výchozí hodnota: None

Skupina prostředků účtu úložiště.

service_data_access_auth_identity

str nebo <xref:_restclient.models.ServiceDataAccessAuthIdentity>

výchozí hodnota: None

Určuje, kterou identitu použít k ověření přístupu k datům služby k úložišti zákazníka. Mezi možné hodnoty patří: 'None', 'WorkspaceSystemAssignedIdentity', 'WorkspaceUserAssignedIdentity'

Metody

download	Stáhněte data z kontejneru objektů blob do místního systému souborů.
upload	Nahrajte data z místního systému souborů do kontejneru objektů blob, na který toto úložiště dat odkazuje. Poznámka: Aby tato metoda fungovala, musí mít objekt úložiště dat vyplněný klíč účtu nebo vlastnost tokenu SAS. Pokud objekt úložiště dat neobsahuje žádnou formu přihlašovacích údajů, tato metoda selže. Tato metoda je navíc zastaralá a v budoucnu může být odebrána. Doporučujeme použít metodu Dataset.File.upload_directory k nahrání souborů z místního adresáře a vytvoření FileDataset jedním voláním metody.
upload_files	Nahrajte data z místního systému souborů do kontejneru objektů blob, na který odkazuje toto úložiště dat. Poznámka: Tato metoda je zastaralá a už se nebude podporovat. Doporučujeme místo toho použít FileDatasetFactory.upload_directory .

download

Stáhněte data z kontejneru objektů blob do místního systému souborů.

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

Parametry

target_path

str

Vyžadováno

Místní adresář, do který se má soubor stáhnout.

prefix

str, <xref:optional>

výchozí hodnota: None

Cesta ke složce v kontejneru objektů blob ke stažení. Pokud je tato možnost nastavená na Žádné, stáhne všechno v objektu blob. Výchozí hodnota je Žádná.

overwrite

bool, <xref:optional>

výchozí hodnota: False

Určuje, zda se mají přepsat existující soubory. Výchozí hodnota je False.

show_progress

bool, <xref:optional>

výchozí hodnota: True

Určuje, jestli se má zobrazit průběh stahování v konzole nástroje . Výchozí hodnota je True.

Návraty

Počet úspěšně stažených souborů.

Návratový typ

int

upload

Nahrajte data z místního systému souborů do kontejneru objektů blob, na který toto úložiště dat odkazuje.

Poznámka: Aby tato metoda fungovala, musí mít objekt úložiště dat vyplněný klíč účtu nebo vlastnost tokenu SAS. Pokud objekt úložiště dat neobsahuje žádnou formu přihlašovacích údajů, tato metoda selže. Tato metoda je navíc zastaralá a v budoucnu může být odebrána. Doporučujeme použít metodu Dataset.File.upload_directory k nahrání souborů z místního adresáře a vytvoření FileDataset jedním voláním metody.

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

Parametry

src_dir

str

Vyžadováno

Místní adresář, který se má nahrát.

target_path

str

Vyžadováno

Umístění v kontejneru objektů blob, do které se má nahrát. Pokud žádný, nahrajte soubor do kořenového adresáře. Výchozí hodnota je Žádná.

overwrite

bool, <xref:optional>

Vyžadováno

Určuje, zda se mají přepsat existující soubory. Výchozí hodnota je False.

show_progress

bool, <xref:optional>

Vyžadováno

Určuje, jestli se má v konzole zobrazit průběh nahrávání. Výchozí hodnota je True.

Návraty

Instance DataReference pro nahranou cílovou cestu.

Návratový typ

DataReference

upload_files

Nahrajte data z místního systému souborů do kontejneru objektů blob, na který odkazuje toto úložiště dat.

Poznámka: Tato metoda je zastaralá a už se nebude podporovat. Doporučujeme místo toho použít FileDatasetFactory.upload_directory .

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

Parametry

files

list[str]

Vyžadováno

Seznam absolutních cest k souborům k nahrání

relative_root

str, <xref:optional>

Vyžadováno

Kořenový adresář, který slouží k určení cesty k souborům v objektu blob. Pokud například nahrajeme /path/to/file.txt a definujeme základní cestu jako /path, po nahrání file.txt do úložiště objektů blob bude mít cestu /to/file.txt. Pokud je zadána také target_path, použije se jako předpona pro odvozenou cestu z výše uvedeného postupu. Základní cesta musí být společnou cestou ke všem souborům, jinak dojde k výjimce. Výchozí hodnota je Žádná, která najde společnou cestu.

target_path

str, <xref:optional>

Vyžadováno

Umístění v kontejneru objektů blob, do které chcete nahrát data. Výchozí hodnota je Žádný, kořen.

overwrite

bool, <xref:optional>

Vyžadováno

Určuje, zda se mají přepsat existující soubory. Výchozí hodnota je False.

show_progress

bool, <xref:optional>

Vyžadováno

Určuje, jestli se má v konzole zobrazit průběh nahrávání. Výchozí hodnota je True.

Návraty

Instance DataReference pro nahranou cílovou cestu.

Návratový typ

DataReference