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
-
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
- sas_token
- str, <xref:optional>
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>
Klucz konta magazynu. Wartość domyślna to None (Brak).
- protocol
- str, <xref:optional>
Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.
- endpoint
- str, <xref:optional>
Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to None (Brak).
- sas_token
- str, <xref:optional>
Token SYGNATURy dostępu współdzielonego na potrzeby uzyskiwania dostępu do tego kontenera. Wartość domyślna to None (Brak).
- protocol
- str, <xref:optional>
Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.
- endpoint
- str, <xref:optional>
Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
Obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to None (Brak).
- workspace_msi_has_access
- bool, <xref:optional>
Czy tożsamość usługi zarządzanej obszaru roboczego ma dostęp do tego konta magazynu. (Przestarzałe)
- subscription_id
- str, <xref:optional>
Identyfikator subskrypcji konta magazynu.
- service_data_access_auth_identity
- str lub <xref:_restclient.models.ServiceDataAccessAuthIdentity>
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 |
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 |
download
Pobierz dane z kontenera obiektów blob do lokalnego systemu plików.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Parametry
- prefix
- str, <xref:optional>
Ś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>
Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.
- show_progress
- bool, <xref:optional>
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
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
- target_path
- str
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>
Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.
- show_progress
- bool, <xref:optional>
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
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
- relative_root
- str, <xref:optional>
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>
Lokalizacja w kontenerze obiektów blob do przekazania danych. Wartość domyślna to None (Brak), root (katalog główny).
- overwrite
- bool, <xref:optional>
Wskazuje, czy zastąpić istniejące pliki. Wartość domyślna to False.
- show_progress
- bool, <xref:optional>
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
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla