AzureBlobDatastore Klasa

Reprezentuje magazyn danych, który zapisuje informacje o połączeniu w usłudze Azure Blob Storage.

Nie należy bezpośrednio pracować z tą klasą. Aby utworzyć magazyn danych tego typu, użyj register_azure_blob_container metody magazynu danych.

Uwaga: w przypadku uzyskiwania dostępu do danych przy użyciu magazynu danych musisz mieć uprawnienia dostępu do tych danych, co zależy od poświadczeń zarejestrowanych w magazynie danych.

Inicjowanie nowego magazynu danych obiektów blob platformy Azure.

Dziedziczenie

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

Wymagane

Obszar roboczy, do którego należy ten magazyn danych.

name

str

Wymagane

Nazwa magazynu danych. Może zawierać tylko znaki alfanumeryczne lub - lub _.

container_name

str

Wymagane

Nazwa kontenera obiektów blob.

account_name

str

Wymagane

Nazwa konta magazynu.

sas_token

str, <xref:optional>

wartość domyślna: None

Token SYGNATURy dostępu współdzielonego na potrzeby uzyskiwania dostępu do tego kontenera. Wartość domyślna to None (Brak).

account_key

str, <xref:optional>

wartość domyślna: None

Klucz konta magazynu. Wartość domyślna to None (Brak).

protocol

str, <xref:optional>

wartość domyślna: None

Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.

endpoint

str, <xref:optional>

wartość domyślna: None

Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.

request_session

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

wartość domyślna: None

obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to None (Brak).

workspace

Workspace

Wymagane

Obszar roboczy, do którego należy ten magazyn danych.

name

str

Wymagane

Nazwa magazynu danych. Może zawierać tylko znaki alfanumeryczne lub - lub _.

container_name

str

Wymagane

Nazwa kontenera obiektów blob.

account_name

str

Wymagane

Nazwa konta magazynu.

sas_token

str, <xref:optional>

Wymagane

Token SYGNATURy dostępu współdzielonego na potrzeby uzyskiwania dostępu do tego kontenera. Wartość domyślna to None (Brak).

account_key

str, <xref:optional>

Wymagane

Klucz konta magazynu. Wartość domyślna to None (Brak).

protocol

str, <xref:optional>

Wymagane

Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.

endpoint

str, <xref:optional>

Wymagane

Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.

request_session

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

Wymagane

Obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to None (Brak).

workspace_msi_has_access

bool, <xref:optional>

wartość domyślna: False

Czy tożsamość usługi zarządzanej obszaru roboczego ma dostęp do tego konta magazynu. (Przestarzałe)

subscription_id

str, <xref:optional>

wartość domyślna: None

Identyfikator subskrypcji konta magazynu.

resource_group

str, <xref:optional>

wartość domyślna: None

Grupa zasobów konta magazynu.

service_data_access_auth_identity

str lub <xref:_restclient.models.ServiceDataAccessAuthIdentity>

wartość domyślna: None

Wskazuje, która tożsamość ma być używana do uwierzytelniania dostępu danych usługi do magazynu klienta. Możliwe wartości to: "None", "WorkspaceSystemAssignedIdentity", "WorkspaceUserAssignedIdentity"

Metody

download	Pobierz dane z kontenera obiektów blob do lokalnego systemu plików.
upload	Przekaż dane z lokalnego systemu plików do kontenera obiektów blob, do których wskazuje ten magazyn danych. Uwaga: aby ta metoda działała, obiekt magazynu danych musi mieć wypełniony klucz konta lub właściwość tokenu SAS. Jeśli obiekt magazynu danych nie zawiera żadnej formy poświadczeń, ta metoda zakończy się niepowodzeniem. Ponadto ta metoda została wycofana, może zostać usunięta w przyszłości. Zalecamy użycie Dataset.File.upload_directory metody do przekazania plików z katalogu lokalnego i utworzenia elementu FileDataset w jednym wywołaniu metody.
upload_files	Przekaż dane z lokalnego systemu plików do kontenera obiektów blob, do którego wskazuje ten magazyn danych. Uwaga: ta metoda jest przestarzała i nie będzie już obsługiwana. Zaleca się zamiast tego użycie FileDatasetFactory.upload_directory .

download

Pobierz dane z kontenera obiektów blob do lokalnego systemu plików.

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

Parametry

target_path

str

Wymagane

Katalog lokalny do pobrania pliku.

prefix

str, <xref:optional>

wartość domyślna: None

Ścieżka do folderu w kontenerze obiektów blob do pobrania. Jeśli zostanie ustawiona wartość Brak, pobierze wszystko w obiekcie blob. Wartość domyślna to None (Brak).

overwrite

bool, <xref:optional>

wartość domyślna: False

Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.

show_progress

bool, <xref:optional>

wartość domyślna: True

Wskazuje, czy ma być wyświetlany postęp pobierania w konsoli programu . Wartość domyślna to True.

Zwraca

Liczba pomyślnie pobranych plików.

Typ zwracany

int

upload

Przekaż dane z lokalnego systemu plików do kontenera obiektów blob, do których wskazuje ten magazyn danych.

Uwaga: aby ta metoda działała, obiekt magazynu danych musi mieć wypełniony klucz konta lub właściwość tokenu SAS. Jeśli obiekt magazynu danych nie zawiera żadnej formy poświadczeń, ta metoda zakończy się niepowodzeniem. Ponadto ta metoda została wycofana, może zostać usunięta w przyszłości. Zalecamy użycie Dataset.File.upload_directory metody do przekazania plików z katalogu lokalnego i utworzenia elementu FileDataset w jednym wywołaniu metody.

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

Parametry

src_dir

str

Wymagane

Katalog lokalny do przekazania.

target_path

str

Wymagane

Lokalizacja w kontenerze obiektów blob do przekazania. Jeśli brak, przekaż do katalogu głównego. Wartość domyślna to None (Brak).

overwrite

bool, <xref:optional>

Wymagane

Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.

show_progress

bool, <xref:optional>

Wymagane

Wskazuje, czy ma być wyświetlany postęp przekazywania w konsoli programu . Wartość domyślna to True.

Zwraca

Wystąpienie DataReference dla przekazanej ścieżki docelowej.

Typ zwracany

DataReference

upload_files

Przekaż dane z lokalnego systemu plików do kontenera obiektów blob, do którego wskazuje ten magazyn danych.

Uwaga: ta metoda jest przestarzała i nie będzie już obsługiwana. Zaleca się zamiast tego użycie FileDatasetFactory.upload_directory .

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

Parametry

files

list[str]

Wymagane

Lista ścieżek bezwzględnych plików do przekazania.

relative_root

str, <xref:optional>

Wymagane

Katalog główny używany do określania ścieżki plików w obiekcie blob. Jeśli na przykład przekażemy /path/to/file.txt i zdefiniujemy ścieżkę bazową na /path, gdy file.txt zostanie przekazana do magazynu obiektów blob, będzie mieć ścieżkę /to/file.txt. Jeśli zostanie również podana target_path, zostanie użyta jako prefiks dla ścieżki pochodnej z powyższego. Ścieżka podstawowa musi być wspólną ścieżką wszystkich plików. W przeciwnym razie zostanie zgłoszony wyjątek. Wartość domyślna to None (Brak), która będzie znajdować wspólną ścieżkę.

target_path

str, <xref:optional>

Wymagane

Lokalizacja w kontenerze obiektów blob do przekazania danych. Wartość domyślna to None (Brak), root (katalog główny).

overwrite

bool, <xref:optional>

Wymagane

Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.

show_progress

bool, <xref:optional>

Wymagane

Wskazuje, czy ma być wyświetlany postęp przekazywania w konsoli programu . Wartość domyślna to True.

Zwraca

Wystąpienie DataReference dla przekazanej ścieżki docelowej.

Typ zwracany

DataReference